# 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.

- Platform: Discourse
- Edition: free
- Web page: https://plugins.goldnat.ai/discourse/discourse-plugin
- Installation guide: https://plugins.goldnat.ai/discourse/guide

## What you can ask the agent

- "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.

## Install and connect

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 the agent can and cannot 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.
- This plugin is read-only: the agent can look things up and summarise, but cannot create, change or delete anything.
- Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

## Tools

Each tool is called by the agent by name. "write" tools need write access approved at connection.

- `discourse.getBadges` (read) — List the badges this forum offers (name, description, type gold/silver/bronze, how many users hold it).
- `discourse.getBookmarks` (read) — The connected user's OWN bookmarks (topic, post excerpt, name, reminder time).
- `discourse.getCategories` (read) — Returns the list of categories in the forum.
- `discourse.getCategory` (read) — 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.getCurrentUser` (read) — Who am I? The connected Discourse user (username, name, trust level, staff flags, groups) and the scopes this token grants. Use it to check the connection.
- `discourse.getDrafts` (read) — The connected user's OWN saved drafts (new topics and replies not yet posted).
- `discourse.getForumStatistics` (read) — Public facts about the forum from its About page: title, description, version, and counts (topics, posts, users, active users, likes) for last day / 7 days / 30 days / all time.
- `discourse.getForumStats` (read) — Return community stats — currently `unanswered_count` (visible topics with only the opening post, no replies), with scanned_topics and complete. from/to/timezone are accepted for the uniform brief-collector shape but the count is a live snapshot at query time.
- `discourse.getLatestTopics` (read) — Returns the latest topics published in the forum.
- `discourse.getNotifications` (read) — The connected user's OWN notifications (newest first). unread_only=true returns only unread ones.
- `discourse.getPost` (read) — Returns a single post by ID.
- `discourse.getPostLikes` (read) — Users who liked a post (username and display name only).
- `discourse.getPostRevisionContent` (read) — Get the full content of a specific revision of a post, including the original Markdown and what changed.
- `discourse.getPostRevisions` (read) — List the edit history of a post: who edited it, when, and the diff of each change.
- `discourse.getSuggestedTopics` (read) — Topics Discourse suggests next to a given topic (related / unread / new).
- `discourse.getTag` (read) — 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` (read) — Returns a single topic including its posts.
- `discourse.getTopicParticipants` (read) — Who took part in a topic: creator, last poster and participants with their post counts.
- `discourse.getTopicPostsRange` (read) — Get a specific range of posts within a topic (for example posts 10 to 20). Useful for paging through long threads.
- `discourse.getTopicSummary` (read) — 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` (read) — Get the top topics for a period — daily, weekly, monthly, yearly or all time — using the forum's popularity settings.
- `discourse.getUserActivity` (read) — A user's public activity stream: topics they started, replies, or likes given. filter: topics | replies | likes_given | all (default all = topics + replies).
- `discourse.getUserProfile` (read) — Returns a user profile (name, details, statistics).
- `discourse.listCategories` (read) — List every category with its metadata: name, description, colour, icon, parent, topic count, view and post permissions, and default settings.
- `discourse.listTags` (read) — List every tag with its name, topic count, colour, icon, description and tag group.
- `discourse.listTopicsByCategory` (read) — List topics in a category, with sorting (latest, top, unanswered) and filtering by tag, status or date.
- `discourse.listTopicsByTag` (read) — List topics carrying a given tag, with sorting and filtering by category, date or status.
- `discourse.searchByAuthor` (read) — 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` (read) — Search content by one tag or a combination of tags, with further filtering by date, category or author.
- `discourse.searchCategories` (read) — Find categories by name, description or tag. Returns the category hierarchy, access permissions and topic counts.
- `discourse.searchInCategory` (read) — Search within one category and its sub-categories. Supports the same filters and sorting as a general search, but scoped for accuracy.
- `discourse.searchPosts` (read) — 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` (read) — Search tags by keyword, filtered by tag group, category, minimum topic count and status.
- `discourse.searchTopics` (read) — Searches topics by keywords.
- `discourse.searchUsers` (read) — Search user accounts by name or email

## Frequently asked 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?**

No. This plugin is read-only.

**How do I disconnect an agent?**

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