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.
- Download Goldnat for Discourse from goldnat.ai and upload it in your Discourse admin panel.
- 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).
- Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
- 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.
Compatible clients
Works with every AI client.
Pre-configured OAuth integrations for every major AI agent — including our own hosted agent at goldnat.ai. Connect in minutes, not hours.
Tools
Available tool calls.
29 tools exposed via the Servio protocol. AI agents call these by name with structured arguments.
discourse
-
discourse.createTopicCreates a new topic in the Discourse forum. -
discourse.editPostEdits an existing post in Discourse. -
discourse.getCategoriesReturns the list of categories in the forum. -
discourse.getCategoryGet 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.getLatestTopicsReturns the latest topics published in the forum. -
discourse.getPostReturns a single post by ID. -
discourse.getPostRevisionContentGet the full content of a specific revision of a post, including the original Markdown and what changed. -
discourse.getPostRevisionsList the edit history of a post: who edited it, when, and the diff of each change. -
discourse.getTagGet 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.getTopicReturns a single topic including its posts. -
discourse.getTopicPostsRangeGet a specific range of posts within a topic (for example posts 10 to 20). Useful for paging through long threads. -
discourse.getTopicSummaryGet an AI summary of a long topic, including key points and main participants. Requires AI summarisation to be enabled on the forum. -
discourse.getTopTopicsGet the top topics for a period — daily, weekly, monthly, yearly or all time — using the forum's popularity settings. -
discourse.getUserProfileReturns a user profile (name, details, statistics). -
discourse.likePostAdds a like to a post. -
discourse.listCategoriesList every category with its metadata: name, description, colour, icon, parent, topic count, view and post permissions, and default settings. -
discourse.listTagsList every tag with its name, topic count, colour, icon, description and tag group. -
discourse.listTopicsByCategoryList topics in a category, with sorting (latest, top, unanswered) and filtering by tag, status or date. -
discourse.listTopicsByTagList topics carrying a given tag, with sorting and filtering by category, date or status. -
discourse.replyToTopicReplies to an existing topic in the forum. -
discourse.searchByAuthorFind 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.searchByTagSearch content by one tag or a combination of tags, with further filtering by date, category or author. -
discourse.searchCategoriesFind categories by name, description or tag. Returns the category hierarchy, access permissions and topic counts. -
discourse.searchInCategorySearch within one category and its sub-categories. Supports the same filters and sorting as a general search, but scoped for accuracy. -
discourse.searchPostsSearch 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.searchTagsSearch tags by keyword, filtered by tag group, category, minimum topic count and status. -
discourse.searchTopicsSearches topics by keywords. -
discourse.searchUsersSearch user accounts by name or email -
discourse.sendMessageSends a private message to a user in the forum.
Pricing
Pick a plan.
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
Questions about Goldnat for Discourse?