discource-mcp-tools — Claude Code MCP server: search Discourse threads
discource-mcp-tools connects coding assistants to Discourse forums for searching topics, reading threads, reviewing chat messages, and inspecting drafts. Helps query community knowledge directly from the editor.
no license 6,591 installs updated 2026-03-10
claude mcp add --transport http discourse-forum-mcp https://discourse-forum-mcp--king-of-the-grackles.run.toolsWhat discource-mcp-tools does
This server runs as a remote HTTP endpoint connecting the assistant directly to Discourse instances. It exposes actions to inspect categories and filter forum threads with syntax tokens. Assistants can also discover relevant communities using semantic text queries.
Beyond public threads, the tools interact with chat channels and unpublished drafts. Users can review unread chat activity or inspect pending drafts before sending replies. The server hosts all logic remotely. No local service setup is necessary.
Whenever multiple forum instances are configured, running discourse_select_site first is mandatory to confirm host connectivity. Attempting to fetch content without choosing an active site causes subsequent operations to fail.
What it helps with
- search Discourse threads using author and tag filters
- retrieve topic contents and individual forum posts
- read messages across public and direct chat channels
- discover relevant online communities via semantic search
Example prompts for the agent
- Search the forum for topics tagged
#bugand display the latest replies - List all pending drafts saved in my Discourse account
- Fetch recent messages from the general chat channel
How to install discource-mcp-tools
Platform CLI: remote server
claude mcp add --transport http discourse-forum-mcp https://discourse-forum-mcp--king-of-the-grackles.run.toolsPlatform CLI: remote server
codex mcp add discource-mcp-tools --url https://discourse-forum-mcp--king-of-the-grackles.run.toolsConfig file
{
"mcpServers": {
"discource-mcp-tools": {
"url": "https://discourse-forum-mcp--king-of-the-grackles.run.tools"
}
}
}Config file
{
"servers": {
"discource-mcp-tools": {
"type": "http",
"url": "https://discourse-forum-mcp--king-of-the-grackles.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http discource-mcp-tools https://discourse-forum-mcp--king-of-the-grackles.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about discource-mcp-tools
How do I install discource-mcp-tools in Claude Code?
Run claude mcp add --transport http discource-mcp-tools https://discourse-forum-mcp--king-of-the-grackles.run.tools in your terminal. This registers the remote HTTP endpoint with Claude Code.
What does discource-mcp-tools do?
It allows assistants to query Discourse forums, read topics and posts, review chat channels, and manage drafts. It can also perform semantic searches to locate related communities.
When should discourse_select_site be used?
You must run it before other actions whenever several forum instances are configured. It verifies that the target Discourse host is reachable and fetches its title.