# mcp

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 78
- Author: discourse
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/discourse/discourse-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/discourse-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @discourse/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add discourse-mcp -- npx -y @discourse/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "discourse-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@discourse/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "discourse-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@discourse/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add discourse-mcp npx -y @discourse/mcp
```

## When to use it
- 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
- 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

## Similar
- [agentx](https://affpapa.org/en/nevibecode/skills/agentx.md) — skill · 2800 installs
- [resend](https://affpapa.org/en/nevibecode/skills/resend.md) — skill · 23400 installs
- [recoup-platform-email-helper](https://affpapa.org/en/nevibecode/skills/recoup-platform-email-helper.md) — skill · 4900 installs
- [api-response-optimization](https://affpapa.org/en/nevibecode/skills/secondsky-api-response-optimization.md) — skill · 422 installs
- [meta-api-mcp-server](https://affpapa.org/en/nevibecode/mcp/meta-api-mcp-server.md) — MCP server · ★ 12
- [suede-community-marketing](https://affpapa.org/en/nevibecode/skills/suede-community-marketing.md) — skill · ★ 126

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md