MCP.Market

Discord MCP server

by jaimenbell·io.github.jaimenbell/discord-mcp·v0.1.1

MCP server for the Discord REST API: 5 read tools always on, 7 write tools env-gated, default off.

A85/100grade A
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • _get_client
  • create_channelwrite action
  • create_messagewrite action
  • create_rolewrite action

    [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Create a role in a guild.

  • delete_channelwrite action
  • edit_channel
  • edit_guild
  • edit_role
  • get_channel_permission_overwrites
  • get_member_roles

    Get the role ids currently assigned to one guild member.

  • list_categories
  • list_channels
  • list_roles

    List 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

no findings
  • 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
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

More from jaimenbell →