mcp-discord

Overview

MCP-Discord is a comprehensive TypeScript implementation of an MCP server that provides extensive Discord platform integration capabilities. It enables AI assistants to perform a wide range of operations including server management, channel creation and editing, message handling, role assignment, and forum post management. The server supports both stdio and HTTP transport methods, making it compatible with various MCP clients.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• discord_login

  Login to Discord using the configured token

  Try:Login to DiscordTry:Connect to my Discord account
• discord_list_servers

  List all Discord servers the bot is a member of

  Try:List my serversTry:Show all Discord servers I'm in
• discord_send

  Send a message to a specified channel

  Try:Send a message to general channelTry:Post 'hello' in announcements
• discord_get_server_info

  Get Discord server information

  Try:Show server detailsTry:Get information about my server
• discord_create_text_channel

  Create a text channel

  Try:Create a new text channel named 'announcements'Try:Add a channel for discussions
• discord_create_forum_channel

  Create a forum channel

  Try:Create a forum channel for feedbackTry:Make a Q&A forum section
• discord_edit_message

  Edit a bot-authored message

  Try:Edit my last message to fix a typoTry:Update the announcement with new information
• discord_search_messages

  Search messages in a server

  Try:Search for messages containing 'meeting'Try:Find all messages from John about project updates
• discord_create_forum_post

  Create a forum post

  Try:Create a new post in the feedback forumTry:Post a question in the Q&A section
• discord_list_roles

  List all roles in a server

  Try:Show all server rolesTry:List available roles
• discord_create_role

  Create a role with color, hoist, mentionable, and permission options

  Try:Create a new role called 'Moderators'Try:Add a role with admin permissions
• discord_list_members

  List members in a server with roles

  Try:Show all server membersTry:List users with the 'admin' role

Comparable tools

Installation

npx mcp-discord --config ${DISCORD_TOKEN}

docker pull barryy625/mcp-discord:latest
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

FAQ

What permissions does the Discord bot need?

The bot requires either Administrator permissions or specific permissions including Send Messages, Manage Messages, Manage Channels, Manage Webhooks, Manage Roles, and Add Reactions.

How do I add the bot to my Discord server?

Use one of the provided OAuth2 invite links with your bot's client ID to add it to your server. Links for both full admin access and custom minimal permissions are provided in the README.

Compare mcp-discord with