MCP Discord Agent Communication

Provides asynchronous Discord-based communication between AI agents and users for long-running tasks.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "eugeneistrach-mcp-discord-agent-comm": {
      "command": "npx",
      "args": [
        "mcp-discord-agent-comm"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here",
        "DISCORD_CHANNEL_ID": "your-channel-id-here"
      }
    }
  }
}

This MCP server enables asynchronous communication between AI agents and Discord users to support long-running tasks. It lets your AI assistant notify you of progress, request input, and interact remotely without you needing to stay glued to your screen.

How to use

You interact with this MCP server through a client that can send messages to Discord and handle responses. The agent can post updates to a designated channel, then pause for user input when needed. To get started, run the server component, provide your Discord bot credentials and target channel, and then use the client to send notifications or input requests.

How to install

Prerequisites: you need Node.js and a compatible runtime environment. A minimal setup uses npm, npx, and Bun for running the MCP server tooling.

# 1) Clone the project
git clone https://github.com/EugenEistrach/mcp-discord-agent-comm.git

# 2) Change into the directory
cd mcp-discord-agent-comm

# 3) Install dependencies
bun install

# 4) Prepare environment configuration
cp .env.example .env  # Edit with your tokens

# 5) Run the server in development mode
bun run dev

Configuration and security

Configure your Discord credentials and target channel by editing the environment variables used by the MCP server. This server uses a stdio configuration that executes via npx to run the MCP client component.

{
  "mcpServers": {
    "discord-agent-comm": {
      "command": "npx",
      "args": ["mcp-discord-agent-comm"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here",
        "DISCORD_CHANNEL_ID": "your-channel-id-here"
      }
    }
  }
}

Notes on usage

You should keep the Discord bot token secret and avoid committing it to public repositories. - Ensure the bot has the necessary permissions in the target channel (send messages, read history, add reactions, view channels). - The default timeout for user replies is 300 seconds (5 minutes). If a reply is required, users must respond to the bot's message in Discord, not just type in the channel.

Troubleshooting

Bot offline: verify the token and that the bot is added to your server with the correct permissions.
No notifications: confirm MESSAGE CONTENT INTENT is enabled and that channel permissions allow the bot to post.
Timeouts: ensure users reply to the bot's message or use reactions to indicate their response.

Development

If you plan to contribute, you can clone the repository, install dependencies, and run a development server to iterate on changes.

git clone https://github.com/EugenEistrach/mcp-discord-agent-comm.git
cd mcp-discord-agent-comm
bun install
cp .env.example .env
bun run dev

Available tools

discord_message

Send a message to Discord, optionally waiting for a user reply. Use for notifications or input requests.