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 →

• Getting Started Guide
• 71 Tools Reference
• Interactive Prompts
• Deployment Guide
• API Reference
• Troubleshooting

---

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

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

---

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:

1. Fork the repository
2. Create a feature branch
3. Test with a development Discord server
4. 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.

---

<p align="center"> <strong>Discord Agent MCP</strong> - AI-Powered Discord Server Management <br> Built with TypeScript, Discord.js, and the Model Context Protocol </p>