discord-developer-mcp

An MCP server for Discord bot developers to verify how their bots behave. It joins your server as a test bot account, letting an AI agent exercise and observe the bot under development.

Features

Act: send messages, add reactions, join and leave voice channels
Arrange: create, edit, and delete the roles, channels, and scheduled events a test depends on
Observe: full message structures, a journal of gateway events with cursor-based queries and state diffs, threads and attachments, audio transmission in voice channels
Diagnose: member presence, effective permissions in a channel

See the tool definitions shown in your MCP client for details.

Limitations

Discord does not allow bot accounts to perform the following. Do them manually and observe the results with the tools.

Invoking another bot's slash commands or interacting with its buttons and select menus
Subscribing to a scheduled event (marking "Interested")

Also, if the bot under test excludes bot accounts (ignoring their messages, excluding them from voice member checks, etc.), this server alone cannot trigger those paths.

Setup

Create a test bot in the Discord Developer Portal
Enable all Privileged Gateway Intents (Presence, Server Members, Message Content)
Invite the bot to the server you test on

Installation

For Claude Code, install with user scope:

claude mcp add --scope user discord-developer -e DISCORD_TOKEN=<token of the test bot> -- npx -y discord-developer-mcp

For other MCP clients:

{
  "mcpServers": {
    "discord-developer": {
      "command": "npx",
      "args": ["-y", "discord-developer-mcp"],
      "env": {
        "DISCORD_TOKEN": "<token of the test bot>"
      }
    }
  }
}