@scotthamilton77/discord-mcp-server

An MCP (Model Context Protocol) server that exposes Discord operations as tools for AI agents. Built with FastMCP and TypeScript.

Quick Start

Add to your MCP client configuration:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["@scotthamilton77/discord-mcp-server"]
    }
  }
}

Bots are configured through the configure_bot tool or by creating YAML files in ~/.discord-mcp-server/bots/. Use the get_bot_onboarding_instructions tool for step-by-step guidance on creating a Discord bot and obtaining a token.

Available Tools

| Tool | Description | |------|-------------| | configure_bot | Register or update a Discord bot configuration | | list_bots | List all configured Discord bots | | get_bot_onboarding_instructions | Get step-by-step bot setup instructions | | bot_status | Get connection state, guild count, and uptime for a bot | | send_message | Send a message to a Discord channel | | reply_to_message | Reply to a specific Discord message | | send_dm | Send a direct message to a Discord user | | edit_message | Edit a message the bot previously sent | | react_to_message | Add an emoji reaction to a message | | fetch_messages | Fetch recent messages from a channel | | fetch_history | Fetch paginated message history from a channel | | get_messages | Poll for new messages in a channel | | get_mentions | Poll for new @mentions of the bot | | get_replies | Poll for new replies to the bot's messages | | download_attachment | Download attachments from a message to local disk |

License

ISC