Discord Agent MCP

AI-Powered Discord Server Management - A production-ready Model Context Protocol (MCP) server with 71 tools for comprehensive Discord automation through Claude AI.

Documentation

View Full Documentation →

What Is This?

Discord Agent MCP bridges Claude AI with Discord, letting you manage your server through natural language. Instead of clicking through Discord's interface or writing code, just tell Claude what you want:

"Create a gaming community server with voice channels for different games,
a welcome channel, and moderator roles"

Claude handles the rest using the 71 Discord management tools provided by this MCP server.

Features

71 Discord Tools

Category	Tools	Description
Messaging	10	Send, edit, delete, react, pin messages
Channels	10	Create, modify, delete channels and permissions
Threads	3	Create and manage forum threads
Server	7	Settings, webhooks, invites, audit logs
Members	3	Info, listings, nicknames
Roles	7	Create, assign, modify roles
Moderation	6	Kick, ban, timeout, manage bans
Emojis	4	Custom emoji management
Stickers	4	Custom sticker management
Events	6	Scheduled events
Auto-Mod	5	Automatic moderation rules
Commands	6	Slash command management

Production Ready

Persistent Connection: Robust Discord.js client with automatic reconnection
Type Safe: Full TypeScript with Zod validation
Comprehensive Errors: Detailed error messages with resolution guidance
Structured Logging: JSON logging with configurable levels
Flexible Deployment: Local, Docker, or Kubernetes

Claude Code Integration

First-class support for Anthropic's Claude Code CLI:

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

Quick Start

1. Prerequisites

Node.js 20.0.0+
A Discord bot token (Create one here)

2. Install

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

3. Configure

cp .env.example .env
# Edit .env and add your DISCORD_TOKEN

4. Run

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

5. Connect to Claude Code

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

Full Setup Guide →

Deployment Options

Docker

docker build -t discord-mcp-server:latest .
docker run -d -p 3000:3000 -e DISCORD_TOKEN=your_token discord-mcp-server:latest

Docker Compose

version: '3.8'
services:
  discord-mcp:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DISCORD_TOKEN=${DISCORD_TOKEN}
    restart: unless-stopped

Kubernetes

kubectl apply -f k8s/

Full Deployment Guide →

Configuration

Variable	Required	Default	Description
`DISCORD_TOKEN`	Yes	-	Discord bot token
`TRANSPORT_MODE`	No	`http`	`http` or `stdio`
`HTTP_PORT`	No	`3000`	Server port
`LOG_LEVEL`	No	`info`	`debug`, `info`, `warn`, `error`

Example Usage

Once connected, use natural language in Claude Code:

Server Setup:

"Set up a gaming community with channels for Minecraft, Valorant, and general chat"

Moderation:

"Timeout user 123456789 for 1 hour for spam"

Events:

"Create a voice event called 'Game Night' for Saturday at 8 PM"

Automation:

"Set up auto-moderation to block spam and timeout repeat offenders"

Security

Never commit tokens - Use .env files (gitignored)
Rotate tokens - Regenerate periodically
Least privilege - Only grant necessary permissions
Audit logs - Monitor bot actions

Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Test with a development Discord server
Submit a pull request

See CONTRIBUTING.md for guidelines.

Resources

Documentation: aj-geddes.github.io/discord-agent-mcp
MCP Protocol: modelcontextprotocol.io
Discord API: discord.com/developers
Issues: GitHub Issues

License

MIT License - See LICENSE for details.

Discord Agent MCP - AI-Powered Discord Server Management
Built with TypeScript, Discord.js, and the Model Context Protocol

Discord