Log inSubmit server
Discord MCP logo

Discord MCP

Connects MCP clients to a user-controlled Discord bot for messages, moderation, server setup, and 222 typed tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Discord MCP

Pick your client, then add it in one click or paste the config.

No confirmed install command yet

We only publish a config when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Discord MCP, and we’d rather show nothing than a guess you’d paste into your client.

Open setup steps on GitHub

Overview

The Discord MCP MCP server connects MCP-compatible AI clients to a Discord bot you control through 222 typed tools. It supports local stdio operation and self-hosted, bearer-protected Streamable HTTP, with tools for messages, channels, roles, moderation, server setup, and workflows. Use it when an agent needs to inspect or manage Discord communities, build server structures, or gather cited conversation context. Preview, permission, dry-run, and approval controls help limit changes before they reach Discord.

Use cases

  • Manage Discord messages, channels, threads, roles, and events
  • Moderate a server with permission checks, role audits, bans, and AutoMod
  • Build or revise a Discord server from an approved blueprint
  • Gather cited channel and thread history for an AI workflow
  • Run resumable background operations with checkpoints

Key features

  • 222 typed Discord tools
  • Messages, channels, threads, forums, roles, events, polls, and onboarding
  • Moderation, permission checks, role audits, bans, and AutoMod
  • Blueprint previews, approvals, resumable execution, and final readback
  • Cited conversation context and durable workflows
  • Stdio and bearer-protected Streamable HTTP operation

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 28d ago via OSV.dev

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars156Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Discord MCP works

What the Discord MCP MCP server does

The Discord MCP MCP server exposes a Discord bot through the Model Context Protocol so compatible AI clients can work with a server you control. Its catalog contains 222 typed tools covering common community operations: messages, threads, forums, channels, roles, events, polls, onboarding, permissions, bans, AutoMod, slash commands, interactions, webhooks, and application emojis.

It also supports higher-level server operations. An agent can prepare a server blueprint for review, execute approved changes, resume interrupted work, inspect the resulting Discord state, and preserve selected identifiers when improving an existing server. Conversation tools gather bounded channel or thread history, replies, and Discord citations with explicit coverage. Durable workflows can be started, inspected, cancelled cooperatively, and resumed from checkpoints.

How it works

Your MCP client launches the local CLI over stdio, or connects to a self-hosted Streamable HTTP endpoint protected with bearer authentication. The process uses a Discord bot token and the permissions assigned to that bot. Guild and tool-category allowlists can further restrict the accessible scope.

The server distinguishes between ordinary writes and confirmation-gated destructive actions. Guided setup defaults to MCP_WRITE_MODE=preview, which blocks mutations. Direct serve allows ordinary writes by default, while MCP_DRY_RUN applies to confirmation-gated destructive tools. Blueprint and change workflows can show a plan before execution, then provide final readback and activity evidence for verification.

The catalog can be checked locally without a token or network access using discord-mcp catalog --check. That validates the installed tool catalog but does not confirm a live Discord connection.

Setup and configuration

The Discord MCP MCP server requires Node.js 22.12 or newer and a Discord bot installed in a server you control. Install the CLI globally with npm install -g @discord-mcp/cli, then expose the bot credential as DISCORD_TOKEN. The documented value includes the Bot prefix.

Run discord-mcp setup --profile devbot --client codex to verify the bot, select a server boundary, and save a non-secret profile. Use discord-mcp doctor --profile devbot --online to check connectivity and discord-mcp smoke --profile devbot for a non-mutating smoke test. Setup generates client configuration but does not apply it automatically; the generated configuration must be added to the chosen MCP client, with DISCORD_TOKEN available when that client launches the server.

The project documents client setup for Claude, Codex, Cursor, VS Code/GitHub Copilot, Windsurf, Cline, Roo Code, Continue, Zed, and other MCP clients. It runs on Windows, macOS, and Linux. Keep bot credentials out of client configuration files and source control. For remote deployment, place the bearer-protected HTTP endpoint behind HTTPS.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Discord MCP

Discord MCP is an MCP server that connects MCP-compatible AI clients to a Discord bot you control. Its typed tools cover messages, channels, threads, roles, moderation, server setup, events, polls, onboarding, slash commands, interactions, webhooks, and application emojis. It supports stdio and self-hosted Streamable HTTP.

Install it with Node.js 22.12 or newer by running `npm install -g @discord-mcp/cli`. Set `DISCORD_TOKEN`, then use the setup, doctor, and smoke commands to configure and verify a profile. You must apply the generated MCP client configuration yourself.

Discord MCP uses the permissions assigned to your Discord bot, with additional guild and tool-category allowlists available to constrain access. The required permissions depend on the operations you expose, such as reading messages, managing roles, or moderating members.

Yes, Discord MCP documents Cursor setup. Configure the generated MCP definition in Cursor and make sure `DISCORD_TOKEN` is available in the environment used to launch the server. The server can run locally over stdio.

Yes, guided setup defaults to `MCP_WRITE_MODE=preview`, which blocks mutations. Blueprint and server-change workflows can present plans for approval before execution, while `MCP_DRY_RUN` covers confirmation-gated destructive tools.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDiscord MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/discord-mcp?style=directory)](https://allmcps.com/mcp/discord-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/discord-mcp"><img src="https://allmcps.com/api/badge/discord-mcp?style=directory" alt="Discord MCP on AllMCPs" /></a>