Discord MCP server
MCP server for the Discord REST API: 5 read tools always on, 7 write tools env-gated, default off.
0 stars
Reviews
Write oneNobody has reviewed Discord yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Discord tools (13, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
_get_clientcreate_channelwrite actioncreate_messagewrite actioncreate_rolewrite action[WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Create a role in a guild.
delete_channelwrite actionedit_channeledit_guildedit_roleget_channel_permission_overwritesget_member_rolesGet the role ids currently assigned to one guild member.
list_categorieslist_channelslist_rolesList all roles in a Discord guild.
Public scan report
scanner v0.1.9 · 2026-09-22 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 41 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Discord compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,273 servers
- Tools
- 13
- the typical server has 7
- Tools that change things
- 31%
- typical: 0%. Fewer write tools means less an agent can break
What its tools let an agent do: 6 read · 3 create · 3 change · 1 delete
Install Discord in Claude Code, Cursor or VS Code
claude mcp add discord-mcp -- uvx jaimenbell-discord-mcp
What the publisher says
From the Discord repository's README, as published. We do not edit it. Read it on GitHub
discord-mcp
An MCP server over the real Discord REST API -- so a Claude agent calls listchannels(guildid="...") instead of hand-rolling an authenticated httpx request. Built to the github-mcp/bus-mcp standard in this portfolio (own pyproject, fastmcp server, typed errors, real test suite, honest README) -- fifth flagship, first over Discord.
5 read-only tools, always on + 7 write tools, gated OFF by default behind DISCORDMCPENABLE_WRITE=1 -- see "Write tools" below.
Quickstart (60 seconds)
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"Add to your Claude Desktop/Code MCP config:
{
"mcpServers": {
"discord-mcp": {
"command": "python",
"args": ["C:/path/to/discord-mcp/run_server.py"],
"env": { "DISCORD_BOT_TOKEN": "your-bot-token-here" }
}
}
}Without DISCORDBOTTOKEN set, every tool call still returns a clean structured error (Discord's own 401) instead of crashing -- see "Typed errors" below. Write tools also need DISCORDMCPENABLEWRITE=1 in the same env block, or they refuse locally with policyrefusal -- see "Write tools" below.
What this is / is not
This is a reference portfolio implementation demonstrating an MCP server over a real external SaaS API (Discord) -- it is NOT an official Discord MCP server, and it is not affiliated with Discord Inc. It started from an earlier, separate sibling project's HttpDiscordClient, a stdlib-urllib Discord transport built and verified against a real live guild for that project's own server-provisioning tooling. This repo hand-adapts that client's request-building, header construction (including its deliberately descriptive User-Agent -- see below), and error handling onto httpx (matching this fleet's other MCP servers) as its own standalone client with no dependency on that sibling project. discord-mcp does not import from or depend on that other package at all.
Started as 5 read-only tools with no write capability at all; now ships a 7-tool write group, off by default, mirroring the MCPENABLE_WRITE-style gate already shipped in github-mcp/bus-mcp/desktop-mcp in this same portfolio -- see "Write tools" below.
Tools
Read (always on, no gate)
Write (gated behind DISCORDMCPENABLE_WRITE=1, default OFF)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Discord: common questions
- Is Discord MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Discord safety report
- How do I install Discord?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Discord need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Discord maintained?
- The last commit was 82 days ago (2026-08-12). The latest release is v0.1.1.
- How does Discord compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,273 servers); tools 13 (the typical server has 7); tools that change things 31% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.