MCP Reference
A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools and resources for AI agents. Choose a site with discourse_select_site, or start the server tethered to one with --site. Writes are off by default: write tools register only with --allow_writes, and the opt-in domains (moderation, workflows, AI administration and others) only with --toolsets. This reference lists every tool, as the server registers them with --toolsets all --allow_writes.
Connect your client
Add to your MCP client configuration:
{
"mcpServers": {
"@discourse/mcp": {
"command": "npx",
"args": [
"-y",
"@discourse/mcp@latest"
]
}
}
}Protocol MCP 2025-11-25Transport stdioCapabilities tools, resources, prompts
- SiteSelect Site
- SearchDiscourse Search, Filter Topics and Search Posts
- TopicsRead Topic, Read Post, Read Selected Topic Posts and 5 more
- UsersGet User, List User Posts, List Users and 2 more
- ChatGet Chat Messages
- DraftsGet Draft, Create/Save Draft and Delete Draft
- UploadsUpload File
- Data ExplorerGet Data Explorer Query, Run Data Explorer Query, Create Data Explorer Query and 2 more
- Private messagesList Private Messages, Read Private Message, Create Private Message and 2 more
- ActivityGet Post Replies, List Latest Posts, Get Topic View Stats and 3 more
- GroupsList Groups, Get Group, List Group Posts and 22 more
- Tag groupsSearch Tag Groups, List Tag Groups, Get Tag Group and 3 more
- ModerationGet Review Queue Count, List Reviewables, List Reviewable Topics and 4 more
- AI agentsList AI Agents, Get AI Agent, Create AI Agent and 5 more
- AI custom toolsGet AI Custom Tool Guide, List AI Custom Tools, Get AI Custom Tool and 6 more
- AI featuresList AI Features, Get AI Feature Configuration and Update AI Feature Configuration
- AI insightsGet Discourse AI Topic Summary, Discourse AI Semantic Search and List Discourse AI Sentiment Posts
- AdministrationList Categories, List Site Settings and Manage User Activation
- Site settingsUpdate Site Setting
- WebhooksList Webhooks, Get Webhook, Create Webhook and 5 more
- ThemesList Themes, Get Theme, Create Theme and 8 more
- AnalyticsList Reports, Get Report and Get Solved Support Dashboard
- WorkflowsList Workflows, Get Workflow, List Workflow Node Types and 15 more
- Resourcessite_categories, site_tags, site_groups and 8 more
- Promptssql_query