Discourse Mcp Server
@discourse
A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools for AI agents. Works with all deployments of discourse.org, self hosted or cloud hosted. just generate an API key to connect.
Overview
What is Discourse Mcp Server?
A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools for AI agents. Built with @modelcontextprotocol/sdk and requires Node >=18. It allows agents to search, read, and optionally write to Discourse forums.
How to use Discourse Mcp Server?
Run with npx -y @discourse/mcp@latest (or globally via the discourse-mcp binary). Select a site at runtime via the discourse_select_site tool or tether to one using --site <url>. Enable writes with --allow_writes and --read_only=false, providing an API key via --auth_pairs. Configuration can also be stored in a JSON profile file.
Key features of Discourse Mcp Server?
- Read‑only by default; writes are opt‑in and guarded.
- Built‑in tools: search, read topics/posts, list categories/tags, filter topics.
- Write tools: create posts, topics, categories, and users (when enabled).
- Supports Admin API Keys and User API Keys for authentication.
- Rate‑limited writes (~1 req/sec) with retries on 429/5xx.
- Remote Tool Execution API for additional dynamic tools.
Use cases of Discourse Mcp Server?
- An AI agent searching a Discourse forum for relevant discussions.
- An automation reading topic content and summarizing it for a user.
- A bot creating new topics or posts in a forum (with write permissions).
- A tool that lists categories or tags to help navigate forum structure.
- A user generating a User API Key without admin involvement.
FAQ from Discourse Mcp Server
What authentication methods are supported?
Admin API Keys (api_key + api_username) and User API Keys (`user_api
