communicationdeveloper-tools

Discord▌

by aj-geddes

Integrates with Discord API for advanced server management—messaging, moderation, roles, events & more via 46+ tools. Re

Integrates with Discord's API to provide server management capabilities including messaging, moderation, role management, event scheduling, and community administration through 46+ specialized tools with robust error handling and deployment support.

github stars

★ 2

GitHub npm

80+ Discord API toolsBot and user authentication modesBulk operations support

best for

/ Discord server administrators
/ Community managers automating moderation
/ Developers building Discord bots
/ Teams managing large Discord communities

capabilities

/ Manage Discord channels and roles
/ Handle messages and bulk operations
/ Control voice channels and permissions
/ Schedule events and automate workflows
/ Execute moderation actions
/ Configure webhooks and bots

what it does

Provides complete Discord API integration with 80+ tools for server automation, moderation, and management through bot or user authentication modes.

about

Discord is a community-built MCP server published by aj-geddes that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrates with Discord API for advanced server management—messaging, moderation, roles, events & more via 46+ tools. Re It is categorized under communication, developer tools.

how to install

You can install Discord in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Discord is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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