playbooks

home / mcp / discord mcp server

Discord MCP Server

Provides a Discord MCP server that resolves targets, processes mentions, and executes message operations across servers and channels.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "itzpingcat-discord-mcp": {
      "url": "https://example.com/mcp",
      "headers": {
        "DISCORD_TOKEN": "your_bot_token_here"
      }
    }
  }
}

You can run a focused Discord MCP Server that translates human-friendly targets into Discord actions, resolves channels and mentions safely, and caches name-to-ID mappings to minimize latency. It lets you send, read, and manage messages across servers and channels using simple targets like channel names or server/channel paths without worrying about numeric IDs.

How to use

You will interact with the MCP client to control the Discord MCP Server. Use plain language targets such as channel names, server names combined with channel names, or direct IDs. The MCP automatically resolves names, handles user mentions, and converts them into the formats that Discord expects. You can send messages, read channel history, search messages, edit or delete your own messages, list servers and channels, and add reactions. Ambiguities are surfaced with guidance on how to specify the exact server and channel.

How to install

Prerequisites: you need Python installed on your machine. You also need network access to Discord's API and a Discord bot token.

pip install -r requirements.txt

Additional setup and run details

Set up your Discord bot and environment, then run the MCP server as a local process. The server expects a Discord bot token in the environment to authenticate.

export DISCORD_TOKEN="your_bot_token_here" 

# On Windows use:
# set DISCORD_TOKEN=your_bot_token_here

python /path/to/discord-mcp

Troubleshooting and notes

If the server does not respond, verify that the DISCORD_TOKEN is set correctly and that the bot is invited to the target servers with the necessary permissions.

Configuration and operational notes

The MCP server handles smart target resolution, automatic mention processing, and caching. It supports both channel-name targets and channel/Server specifications to resolve ambiguity. Ensure your bot has permissions to read messages, send messages, read history, add reactions, and manage messages if you need editing capabilities.

Available tools

send_message

Send to channels or DMs; target can be a channel name, server/channel, or ID; supports plain text and mentions.

edit_message

Edit or delete a message; empty content deletes the message.

read_messages

Read channel history and channel information; supports target resolution.

list_servers

List all accessible servers the bot can read from.

list_channels

List channels within a specified server to help with target resolution.

search_messages

Search for messages within a channel using text queries.

add_reaction

Add an emoji reaction to a message by its ID.