Discord MCP

🚀 Discord MCP Server

A Model Context Protocol server that offers AI agents secure access to Discord's REST API and Gateway events.

✨ Features

• 🔧 Over 120 Discord API Tools: Comprehensive coverage of Discord's REST API.
• 🔒 Security First: Guild/channel allowlists, safe defaults, and no accidental mentions.
• ⚡ Real-time Events: Gateway integration for live Discord activity.
• 🎯 Smart Routing: Auto-generated tools from a declarative API catalog.
• 📦 Modular Packs: Enable only the functionality you need.

🚀 Quick Start

# Clone and install
git clone https://github.com/GustyCube/discord-mcp
cd discord-mcp
npm install

# Configure your bot
cp .env.example .env
# Add your DISCORD_BOT_TOKEN and other settings

# Build and run
npm run build
npm start

📚 Documentation

📖 Complete documentation is available at discord-mcp.gustycube.com.

Quick Links

• Getting Started
• Configuration
• Available Tools
• Security Model
• Examples

💻 Usage Examples

Basic Usage

Add to your mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here",
        "ALLOW_GUILD_IDS": "123456789,987654321",
        "ALLOW_CHANNEL_IDS": "111111111,222222222"
      }
    }
  }
}

What You Can Do

• 📝 Message Management: Send, edit, delete messages and reactions.
• 👥 User & Guild Info: Get user profiles, guild details, and member lists.
• 🔊 Channel Operations: List channels, manage permissions, and create threads.
• 🎭 Rich Content: Send embeds, manage webhooks, and upload files.
• ⚡ Live Events: Subscribe to message events, member joins, etc.
• 🛡️ Moderation: Manage bans, kicks, and roles (with appropriate permissions).

Contributing

Refer to the full documentation for development setup, API reference, and contribution guidelines.

📄 License

This project is under the MIT License - see the LICENSE file for details.