Discourse MCP
UnclaimedMCP client for Discourse sites
Set up this server
01 / Choose your client
02 / Before you connect
Authentication is not specified. Check the project instructions before connecting.
Project instructions03 / Add the configuration
claude mcp add --transport stdio 'discourse-mcp' -- 'npx' '-y' '@discourse/mcp@latest'04 / Check it in your client
Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.
More in Developer Tools
Browse the full directoryUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverSecurity profile
Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works
29 of 29 tools
Documented tools (29)
From project documentation. A server handshake does not verify each tool’s description or behavior.
discourse_create_category
(only when writes enabled; see Write safety)
discourse_create_post
(only when writes enabled; see Write safety)
discourse_create_private_message
(only when writes enabled; see Write safety)
discourse_create_topic
(only when writes enabled; see Write safety)
discourse_create_user
(only when writes enabled; see Write safety)
discourse_delete_draft
(only when writes enabled; see Write safety)
discourse_filter_topics
discourse_get_chat_messages
discourse_get_draft
discourse_get_review_queue_count
{} → { count, unit: "pendingreviewablequeueitems", status: "pending", scope }, where count is the authoritative number of pending reviewable records visible to the caller, not individual flags.
discourse_get_reviewable
{ reviewableid; includeexplanation? } → refreshed bounded context, side-loaded references, editable fields, score evidence, and exact available actions; no recommendation is generated. Avoid bulk fan-out because list results already contain triage evidence.
discourse_get_user
discourse_invite_to_private_message
(only when writes enabled; see Write safety)
discourse_list_private_messages
(requires authentication)
discourse_list_reviewable_topics
{} → a non-exhaustive aggregation of pending topics at or above Discourse's minimum review priority. scorecount counts review score/flag records, not reviewable queue items; queue items without topics are absent.
discourse_list_reviewables
stable review filters and offset pagination → normalized reviewables with named status plus numeric statusid, current versions, bounded evidence, scores, targets, and dynamic actions. For normal triage send only status and offset; use meta.total and follow nextoffset. Upstream page size is fixed at
discourse_list_user_posts
discourse_list_users
(requires admin API key)
discourse_perform_reviewable_action
(only when writes enabled): { reviewableid; actionid; expectedversion?; additionalfields?; confirm: true } → serialized, freshly preflighted action with normalized success and remaining-count fields. Submit the displayed dynamic action ID; MCP maps its serveraction to the Discourse route.
discourse_read_post
discourse_read_private_message
(requires authentication)
discourse_read_topic
discourse_reply_private_message
(only when writes enabled; see Write safety)
discourse_save_draft
(only when writes enabled; see Write safety)
discourse_search
discourse_select_site
(hidden when --site is provided)
discourse_update_topic
(only when writes enabled; see Write safety)
discourse_update_user
(only when writes enabled; see Write safety)
discourse_upload_file
(only when writes enabled; see Write safety)
Tool change history
FAQ
Questions about Discourse MCP Server
- How do I connect Discourse MCP Server to Claude?
- Run `claude mcp add discourse-mcp -- npx -y @discourse/mcp@latest` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
- Is Discourse MCP Server free?
- The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
- What can Discourse MCP Server do?
- Discourse MCP Server documents 29 tools to the agent, including discourse_create_category, discourse_create_post, discourse_create_private_message. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.