home / mcp / discord agent mcp server

Discord Agent MCP Server

Production-ready Model Context Protocol (MCP) server for AI-assisted Discord management and automation

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aj-geddes-discord-agent-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "HTTP_PORT": "3000",
        "LOG_LEVEL": "info",
        "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN",
        "TRANSPORT_MODE": "http"
      }
    }
  }
}

You have an AI-powered MCP server that connects Claude AI to your Discord workspace, giving you natural language control over 71 Discord management tools. This makes it easy to set up servers, moderate chat, manage channels and roles, schedule events, and automate routine tasks without writing code or navigating the Discord UI directly.

How to use

You interact with the MCP server through Claude Code or your preferred MCP client. Start by connecting Claude to the local MCP server or a remote endpoint, then describe what you want in natural language. Claude translates your intent into actions across channels, roles, moderation, events, automations, and more, using the 71 tools available to adjust your Discord server.

How to install

Prerequisites: you need Node.js 20.0.0+ and a Discord bot token.

Step 1: Clone the project repository and install dependencies.

git clone https://github.com/aj-geddes/discord-agent-mcp.git
cd discord-agent-mcp
npm install

Step 2: Create the environment file and insert your Discord token.

cp .env.example .env

Step 3: Start the server.

npm run build
npm start
```
# Server runs at http://localhost:3000/mcp

Step 4: Connect Claude Code to the MCP endpoint.

claude mcp add --transport http discord-agent http://localhost:3000/mcp