Skip to main content
MCP server CX Codex

mcp · discourse — Claude Code MCP server: what it does, how to install

Connects your AI agent to Discourse forums to search discussions and read posts. Useful for browsing or managing community spaces.

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mcp -- npx -y @discourse/mcp
Open on GitHub

What mcp does

This integration exposes Discourse API endpoints to assistants. By default, it operates strictly in read-only mode. You can find topics and fetch raw text with discourse_read_post. Specify a forum at startup with --site <url> or pick instances dynamically using discourse_select_site.

Mutations are disabled out of the box. To create replies, pass --allow_writes with credentials configured in --auth_pairs. Any write actions follow a rate limit of roughly one request per second. Uploading local assets requires directory paths pre-approved in --allowed_upload_paths.

Node.js 24 or newer is strictly required. Older runtimes will immediately fail. The package defaults to stdio transport, but loopback HTTP is also supported on port 3000 with a 4 MiB body limit.

What it helps with

  • search community topics and retrieve raw post contents
  • execute pre-built Data Explorer SQL queries on the forum
  • publish posts and send private messages with built-in write protection
  • upload local files to forum threads from designated folders

Example prompts for the agent

  • Connect to https://try.discourse.org and search for topics tagged with release
  • Fetch the raw content of the post using discourse_read_post
  • Run a saved Data Explorer query on the selected Discourse instance

How to install mcp

Platform CLI

claude mcp add mcp -- npx -y @discourse/mcp

Step 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 mcp

How to install mcp in Claude Code?

Run claude mcp add discourse-mcp -- npx -y @discourse/mcp in your terminal. This registers the server and enables Discourse tools in your client.

How do I enable post creation and mutations?

Pass the --allow_writes flag alongside authentication details in --auth_pairs. Mutation tools are hidden by default and respect a rate limit of one action per second.

What runtime version is required to run discourse-mcp?

The package requires Node.js 24 or newer. Also, local uploads will fail unless paths are explicitly specified with --allowed_upload_paths.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

mcp by other authors comes first.

mcp kubeshark This MCP server gives AI agents access to Kubernetes network traffic. Use it to inspect API calls, investigate incidents, and trace failures across services. CX Codex +1 ★ 12,110repo stars mcp butterbase-ai The Butterbase MCP server gives your agent access to schemas, auth, functions, storage, RAG and deploys. Useful when your backend runs on Butterbase. CX Codex +1 ★ 3,031repo stars mcp medplum Connect an AI agent to healthcare data stored in Medplum and work with those records through MCP. Useful when you want an agent to access FHIR data. CX Codex +1 ★ 2,766repo stars mcp sceneview This MCP server gives an AI assistant access to SceneView API docs and samples, and helps generate and validate code. Use it when building a 3D or AR app with SceneView. CX Codex +1 ★ 1,349repo stars mcp Buoy-gg Lets an AI agent read and control a running React Native or Flutter app through Buoy devtools. Useful when you want requests, caches or state inspected inside the app itself. CX Codex +1 ★ 691repo stars agentx starchild A skill that publishes posts, comments and likes to the Starchild AgentX forum. Auth is automatic, so no API key is needed. CX Codex +1 2,800installs resend resend Skill for Resend Email API: send transactional emails, receive inbound via webhooks, manage templates, domains and request logs. CX Codex +1 23,400installs recoup-platform-email-helper recoupable Sends mail through the Recoup API from a Node script: the body gets serialized properly, and an empty body stops the send instead of going out. CX Codex +1 4,900installs api-response-optimization secondsky A coding-agent skill that walks through payload trimming, HTTP caching and compression for API endpoints. Useful when responses feel slow. CX Codex +1 422installs meta-api-mcp-server savhascelik Turns outside HTTP APIs into callable tools for an AI assistant, driven by a JSON file or a Postman collection. Handy when the agent needs live data from another service. CX Codex +1 ★ 12repo stars suede-community-marketing JasonColapietro A playbook for growing a product or brand community, from seeding the first members to an ambassador program and health metrics. CX Codex +1 ★ 126repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor