MCP Server

Cloudflare Community MCP Server

Connect your AI tools to the Cloudflare Community forum. Search topics, read posts, look up users, and more — all through the Model Context Protocol.

What is this?

The Cloudflare Community has an MCP (Model Context Protocol) server that lets AI assistants like OpenCode, Claude Desktop, Cursor, and other MCP-compatible tools interact with the forum programmatically. It's powered by @discourse/mcp, the official Discourse MCP server.

Quick Start

Install and run with a single command:

npx @discourse/mcp@latest

Or install globally:

npm install -g @discourse/mcp

Configuration

OpenCode

Add to ~/.config/opencode/opencode.jsonc inside the "mcp" block:

"discourse": {
  "type": "local",
  "command": ["npx", "-y", "@discourse/mcp@latest"],
  "enabled": true
}

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json in your project root:

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

Connecting to the Cloudflare Community

After configuring your MCP client, use the discourse_select_site tool with:

https://community.cloudflare.com

No API key is needed for reading public data. An API key is only required for write operations (posting, moderation).

Available Tools

Tool	Description
`discourse_select_site`	Connect to community.cloudflare.com
`discourse_search`	Full-text search across all topics and posts
`discourse_filter_topics`	Filter topics by category, tags, status, dates
`discourse_read_topic`	Read a topic's posts and metadata
`discourse_read_post`	Read a specific post by ID
`discourse_get_user`	Look up a user's profile
`discourse_list_user_posts`	List posts/replies by a user

Example Usage

Once connected, you can ask your AI assistant things like:

"Search the Cloudflare community for topics about Error 522"

"Find unanswered topics in the SSL category from the last 3 days"

"Read topic 42325 and summarize the issue"

"Show me recent replies from user sandro"

Machine-Readable Discovery

AI agents can discover this MCP server through these endpoints:

Endpoint	Format
`/.well-known/mcp.json`	MCP Server Card (JSON)
`/.well-known/agent.json`	A2A Agent Card (JSON)
`/.well-known/agent-skills/index.json`	Agent Skills Index (JSON)
`/llms.txt`	LLMs.txt (plain text)

Links

npm: @discourse/mcp · Model Context Protocol Spec · Cloudflare Agents Docs · Cloudflare Community Forum