MCP.so
Sign In

Discourse Mcp Server

@discourse

Repository

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

Basic information

Category

Other

Transports

stdio

Publisher

discourse

Submitted by

Ric Harvey

Config

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

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

Tools

14

Validate and select a Discourse site for subsequent tool calls.

Search site content.

Read a topic metadata and first N posts.

Read a specific post.

List categories visible to the current auth context.

List tags (if enabled).

Get basic user info.

Get a list of user posts and replies from a Discourse instance, with the most recent first. Returns 30 posts per page by default. Use the page parameter to paginate (page 0 = offset 0, page 1 = offset 30, etc.).

Filter topics with a concise query language: use key:value tokens separated by spaces; category/categories for categories (comma = OR, '=category' = without subcats, '-' prefix = exclude), tag/tags (comma = OR, '+' = AND) and tag_group; status:(open|closed|archived|listed|unlisted|public) and personal in:(bookmarked|watching|tracking|muted|pinned); dates: created/activity/latest-post-(before|after) with YYYY-MM-DD or N (days); numeric: likes[-op]-(min|max), posts-(min|max), posters-(min|max), views-(min|max); order: activity|created|latest-post|likes|likes-op|posters|title|views|category with optional -asc; free text terms are matched full-text. Results are permission-aware.

List all public chat channels visible to the current user. Returns channel information including title, description, and member counts.

List all chat channels for the currently authenticated user, including both public channels they're a member of and direct message channels. Includes unread tracking information.

Get messages from a chat channel with flexible pagination and date-based filtering. Supports: (1) paginating with direction='past'/'future' from a target_message_id, (2) querying messages around a specific target_date, (3) getting messages around a target_message_id, or (4) fetching from last read position.

List all drafts for the current user. Returns draft keys, sequences, and preview content. Use this to find existing drafts before updating them.

Retrieve a specific draft by its key. Common keys: "new_topic" for new topic drafts, "topic_<id>" for reply drafts.

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

Comments

More Other MCP servers

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K