discord-mcp

Overview

Discord-MCP is a full-featured Model Context Protocol server that bridges Discord with AI assistants like Claude and ChatGPT. It provides extensive Discord functionality including channel management, message handling, role administration, and moderation tools. The server is built with Java and JDA (Java Discord API), offering both HTTP and legacy stdio connection modes with detailed configuration options for multiple AI clients.

Try asking AI

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

• get_server_info

  Get detailed discord server information

  Try:What's the server information?Try:Show me details about this Discord server
• send_message

  Send a message to a specific channel

  Try:Post a message to the general channelTry:Send an announcement to #announcements
• read_messages

  Read message history from a specific channel

  Try:Show me recent messages in #generalTry:Get the last 10 messages from #ideas
• create_text_channel

  Create a new text channel

  Try:Create a new channel called 'feedback'Try:Add a text channel for project updates
• list_channels

  List of all channels

  Try:Show me all channels in the serverTry:List all available text channels
• send_private_message

  Send a private message to a specific user

  Try:DM user John about the meetingTry:Send a private message to Sarah
• create_role

  Create a new role on the server

  Try:Create a role called 'Moderator'Try:Add a new admin role
• assign_role

  Assign a role to a user

  Try:Give John the 'Developer' roleTry:Assign Admin role to Sarah
• kick_member

  Kicks a member from the server

  Try:Kick user John for violating rulesTry:Remove the disruptive member from the server
• ban_member

  Bans a user from the server

  Try:Ban user John for spammingTry:Permanently ban the problematic user
• create_webhook

  Create a new webhook on a specific channel

  Try:Create a webhook for the announcements channelTry:Set up a webhook in #general
• create_guild_scheduled_event

  Schedule a new event on the server

  Try:Create a server event for Friday's game nightTry:Schedule a community meetup event

Comparable tools

Installation

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

FAQ

What permissions does my Discord bot need?

Your bot will need various permissions depending on which features you want to use. The README includes a link to Discord's documentation for creating a bot and understanding permissions.

Can I run multiple Discord MCP servers simultaneously?

Yes, you can run multiple instances by changing the port mapping in Docker (e.g., -p 8086:8085) or configuring different ports in manual installation.

Compare discord-mcp with