MCP-Discord

What is MCP-Discord?

MCP-Discord is a Discord Model Context Protocol (MCP) server that enables AI assistants to interact with Discord platform. It provides tools for managing servers, channels, messages, roles, members, forum posts, reactions, and webhooks.

How to use MCP-Discord?

Run with npx mcp-discord --config ${DISCORD_TOKEN} or via Docker (e.g., docker run -e DISCORD_TOKEN=your_token ...). Configure the bot token as an environment variable or command-line argument. Requires Node.js v18+ and a Discord bot with appropriate permissions (Administrator recommended). Add the bot to target servers first.

Key features of MCP-Discord

• Login to Discord bot and list servers
• Manage channels: create, edit, delete text/forum/voice/categories
• Manage forum posts: create, update, delete, reply, manage tags
• Send, read, edit, delete messages; search messages
• Manage roles: create, edit, delete, assign, remove
• Manage webhooks: create, edit, delete, send messages via webhook
• Add/remove reactions and manage member details

Use cases of MCP-Discord

• Automate server moderation and channel management with AI
• Let AI assistants send messages and manage forum threads
• Programmatically assign roles and manage permissions
• Search and retrieve message history across servers
• Create and manage webhooks for external integrations

FAQ from MCP-Discord

What dependencies or runtime are required?

Node.js v18.0.0 or higher and npm v7.0.0 or higher are required.

What Discord bot permissions are needed?

Administrator permissions are recommended for full functionality. Alternatively, enable Send Messages, Create Public Threads, Manage Messages, Manage Threads, Manage Channels, Manage Webhooks, Manage Roles, Add Reactions, View Channel, Message Content Intent, Server Members Intent, and Presence Intent.

Can MCP-Discord access any Discord server?

No. The bot can only access servers it has been explicitly added to via an invite link.

What transport methods does MCP-Discord support?

It supports stdio (default) and streamable HTTP transport. The HTTP server can be hosted with a configurable port and provides an endpoint at /mcp.

Is MCP-Discord available as a Docker image?

Yes. Docker images are published on Docker Hub as barryy625/mcp-discord. Tags include latest and version-specific tags like v1.3.8.