# 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

1. Create a test bot in the [Discord Developer Portal](https://discord.com/developers/applications)
2. Enable all Privileged Gateway Intents (Presence, Server Members, Message Content)
3. Invite the bot to the server you test on

## Installation

For Claude Code, install with user scope:

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

For other MCP clients:

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