Discourse Mcp Server

@discourse

About Discourse Mcp Server

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.

#knowledge-management #mcp-tools #discourse

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "discourse": {
      "command": "npx",
      "args": [
        "-y",
        "@discourse/mcp@latest"
      ],
      "env": {}
    }
  }
}

Tools

Validate and select a Discourse site. Returns JSON with site URL and title.

Search site content. Returns JSON object with results array of matching topics (id, slug, title) and meta (total, has_more).

Read topic metadata and posts. Returns JSON with id, title, slug, category_id, tags, and posts array.

Read a specific post. Returns JSON with id, topic_id, post_number, username, created_at, and raw content.

Get user info. Returns JSON with id, username, name, trust_level, created_at, bio, admin, and moderator.

Get paginated list of user posts/replies. Returns JSON object with posts array (id, topic_id, post_number, slug, title, created_at, excerpt, category_id) and meta (page, limit, has_more).

List users via admin API. Requires admin API key. Returns ~100 users per page (Discourse's fixed page size). Returns JSON with users array and pagination meta.

Get messages from a chat channel. Returns JSON object with channel_id, messages array (id, username, created_at, message, edited, thread_id, in_reply_to_id), and meta.

Retrieve a specific draft by key. Returns JSON with draft_key, sequence, and parsed data (title, reply, categoryId, tags, action).

Get full details of a Data Explorer query including SQL and parameters. Requires admin API key.

Execute a Data Explorer query with parameters. Returns columns, rows, result_count, duration_ms. Queries run in read-only transactions with 10-second timeout. Requires admin API key.

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.