discord-mcp

How it works

Related MCP server: Discord MCP Server

Quick start

Requires Node.js 22.12 or later.

# Install the MCP server
npm install -g @discord-mcp/cli

# Generate a client-specific configuration fragment for Codex
discord-mcp init --client codex

# Verify your Discord token and local configuration
export DISCORD_TOKEN="Bot YOUR_DISCORD_BOT_TOKEN"
discord-mcp doctor --online

On PowerShell, set the token with:

$env:DISCORD_TOKEN = "Bot YOUR_DISCORD_BOT_TOKEN"

init supports Codex, Claude Desktop, Claude Code, Cursor, and a generic MCP client. It prints a complete configuration fragment; merge it into an existing client configuration rather than overwriting it. The Codex fragment forwards DISCORD_TOKEN from its launch environment instead of storing the token in ~/.codex/config.toml. See the installation guide for non-interactive and client-specific setup.

To run without a global install:

npx -y @discord-mcp/cli init --client cursor

What you get

Explore the complete, generated tool reference and practical recipes.

Built for production use

• Safety controls - destructive operations require explicit confirmation and can be governed by category-level controls.

• Reliable Discord access - retries, timeouts, rate-limit handling, and circuit breaking protect agent workflows from transient API failures.

• Observability - OpenTelemetry traces and metrics, structured logs, and audit events make operations inspectable.

• Typed contracts - every tool is schema-defined; public core exports, CLI flags, configuration variables, and tool metadata are regression-tested.

• Supply-chain evidence - npm releases are published from GitHub Actions with signed SLSA provenance.

Read the architecture, operations guides, and v1.0 readiness plan for implementation details and current stability commitments.

Commands

Run discord-mcp --help or see the full CLI reference for flags and examples.

Packages

The CLI runs on macOS, Linux, and Windows. Its executable is always discord-mcp.

Migrate an existing setup

discord-mcp includes migration adapters for established community projects, including PaSympa, quadslab, and discord-ops. Start with:

discord-mcp migrate --list

Then use discord-mcp migrate --from <adapter> --source <path> to generate a tool-by-tool mapping report. The migration guides explain each adapter and its limits.

Develop locally

pnpm install
pnpm build
pnpm test

The repository is a pnpm workspace. For a real Discord smoke test, set DISCORD_TOKEN and run node packages/mcp-server/dist/cli.js; the MCP Inspector is useful for verifying tools/list interactively.

Project status

discord-mcp is pre-1.0. The current public release is v0.13.2; its core exports, CLI surface, environment schema, and 192-tool registry are covered by contract tests. See the changelog and v1.0 readiness checklist before depending on an unstable surface.

License

MIT