Goldnat Plugins
Discourse vlatest · active

Goldnat for Discourse

Connect Claude, ChatGPT, and Gemini to your Discourse forum. Let AI agents read topics, post replies, search content, and manage your community — all with OAuth 2.0 security.

Goldnat for Discourse · AI tools for your Discourse community

Ask your own AI

Copy this to your AI agent — it will explain everything.

Paste it into Claude, ChatGPT, goldnat.ai or any assistant you use. It reads this plugin's plain-text page and walks you through what it does, how to install it and what to ask.

I run a Discourse site and I'm looking at "Goldnat for Discourse".
Please read https://plugins.goldnat.ai/discourse/discourse-plugin.md (and, if you need more, https://plugins.goldnat.ai/discourse/discourse-plugin and https://plugins.goldnat.ai/discourse/guide).
Then explain to me in simple words:
1. what this plugin does and who it is for;
2. what I need before I start, and how to install it;
3. how to connect you (my AI agent) to my site, step by step;
4. what you will and will not be able to do on my site once connected;
5. five concrete things I could ask you to do with it, for a site like mine.
Ask me about my site if that helps you give better examples.

Capabilities

What it does.

OAuth 2.0 + PKCE

Secure by design

Industry-standard OAuth flow with PKCE. Every AI agent authenticates with proof-of-key exchange — no secrets stored client-side.

Permission-aware

Discourse permissions

Tool calls respect Discourse's native permission model. Users only see content they're allowed to access.

REST + JSON

Servio protocol

Manifest endpoint, tool discovery, structured JSON responses. Compatible with the Model Context Protocol standard.

29 tools

Production ready

29 structured tool calls for Discourse.

In plain language

What you can ask.

Type requests like these to your AI agent once it is connected. It works out which tools to use.

  • “What are the hottest topics this month?”

    The agent lists the top topics.

  • “Summarise the topic about the outage.”

    It reads the topic and summarises it.

  • “Find what our member Avi wrote about pricing.”

    It searches posts by that author.

  • “Reply to the new question in Support.”

    It posts the reply as your user.

  • “Which tags are used the most?”

    It lists the tags.

How it works

From install to your first request.

  1. Download Goldnat for Discourse from goldnat.ai and upload it in your Discourse admin panel.
  2. Connect your AI agent: in goldnat.ai (or another compatible agent) add your site address. You are sent to your own Discourse site to log in and approve what the agent may do (read only, or read and write).
  3. Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
  4. Full installation guide with screenshots: https://plugins.goldnat.ai/discourse/guide

What it will and won't do

  • The agent acts as the Discourse user who connected it. It can never see or change more than that user can.
  • You approve the access level when you connect (read only, or read and write), and you can revoke the connection at any time from the plugin page in your admin panel.
  • Actions that delete content or cannot be undone ask for an explicit confirmation first.
  • Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

Tools

Available tool calls.

29 tools exposed via the Servio protocol. AI agents call these by name with structured arguments.

discourse

  • discourse.createTopic Creates a new topic in the Discourse forum.
  • discourse.editPost Edits an existing post in Discourse.
  • discourse.getCategories Returns the list of categories in the forum.
  • discourse.getCategory Get full details of a category by ID or slug: name, description, colour, icon, parent category, sub-categories, per-group permissions, default settings and permitted tags.
  • discourse.getLatestTopics Returns the latest topics published in the forum.
  • discourse.getPost Returns a single post by ID.
  • discourse.getPostRevisionContent Get the full content of a specific revision of a post, including the original Markdown and what changed.
  • discourse.getPostRevisions List the edit history of a post: who edited it, when, and the diff of each change.
  • discourse.getTag Get full details of a tag: name, description, colour, icon, topic count, tag group, synonyms, the categories it is allowed in, and who may use it.
  • discourse.getTopic Returns a single topic including its posts.
  • discourse.getTopicPostsRange Get a specific range of posts within a topic (for example posts 10 to 20). Useful for paging through long threads.
  • discourse.getTopicSummary Get an AI summary of a long topic, including key points and main participants. Requires AI summarisation to be enabled on the forum.
  • discourse.getTopTopics Get the top topics for a period — daily, weekly, monthly, yearly or all time — using the forum's popularity settings.
  • discourse.getUserProfile Returns a user profile (name, details, statistics).
  • discourse.likePost Adds a like to a post.
  • discourse.listCategories List every category with its metadata: name, description, colour, icon, parent, topic count, view and post permissions, and default settings.
  • discourse.listTags List every tag with its name, topic count, colour, icon, description and tag group.
  • discourse.listTopicsByCategory List topics in a category, with sorting (latest, top, unanswered) and filtering by tag, status or date.
  • discourse.listTopicsByTag List topics carrying a given tag, with sorting and filtering by category, date or status.
  • discourse.replyToTopic Replies to an existing topic in the forum.
  • discourse.searchByAuthor Find everything a member has written — topics they opened, posts and replies — filtered by date, category or tag. Useful for tracing a contributor's history.
  • discourse.searchByTag Search content by one tag or a combination of tags, with further filtering by date, category or author.
  • discourse.searchCategories Find categories by name, description or tag. Returns the category hierarchy, access permissions and topic counts.
  • discourse.searchInCategory Search within one category and its sub-categories. Supports the same filters and sorting as a general search, but scoped for accuracy.
  • discourse.searchPosts Search the BODY of XenForo posts, ranked by relevance. Supports XenForo search syntax: "an exact phrase" in quotes, +required, -excluded. Multiple words must all appear in the same post, in any order. Returns results plus total, page and has_more — use page to walk through them. To search thread titles instead, use searchThreads. Date options: (1) since=Xw for open range from X ago until now; (2) date_from+date_to for exact window (e.g. date_from=2026-03-09&date_to=2026-03-15); (3) since+until for relative window (e.g. since=3w&until=2w = the week 3 weeks ago). All params optional.
  • discourse.searchTags Search tags by keyword, filtered by tag group, category, minimum topic count and status.
  • discourse.searchTopics Searches topics by keywords.
  • discourse.searchUsers Search user accounts by name or email
  • discourse.sendMessage Sends a private message to a user in the forum.

Pricing

Pick a plan.

Free

Free

Free, fully functional

  • ✓ searchTopics
  • ✓ getCategories
  • ✓ getLatestTopics
Install

FAQ

Common questions.

Which AI agents can I use?

Our own agent at goldnat.ai, and other AI agents that support the Servio protocol. The list of compatible clients is on this page.

Can the AI see or change things I can't?

No. It works as the Discourse user who connected it, with exactly that user's permissions. Connect it with an account that has only the access you want it to have.

Will it change things without asking?

Only if you approved write access when you connected it. Deleting or irreversible actions ask for an explicit confirmation.

How do I disconnect an agent?

Revoke its connection from the plugin page in your admin panel. The agent loses access immediately.

Discourse platform

More plugins for Discourse

← All Discourse plugins

Questions about Goldnat for Discourse?