Provides 71 tools for comprehensive Discord bot management including messaging, channel and thread management, role and member administration, moderation actions, emoji and sticker management, scheduled events, auto-moderation rules, and application commands (slash commands).
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
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:
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:
Quick Start
1. Prerequisites
Node.js 20.0.0+
A Discord bot token (Create one here)
2. Install
3. Configure
4. Run
5. Connect to Claude Code
Deployment Options
Docker
Docker Compose
Kubernetes
Configuration
Variable | Required | Default | Description |
| Yes | - | Discord bot token |
| No |
|
or
|
| No |
| Server port |
| No |
|
,
,
,
|
Example Usage
Once connected, use natural language in Claude Code:
Server Setup:
Moderation:
Events:
Automation:
Security
Never commit tokens - Use
.envfiles (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.