-
securityF
license-
qualityAn MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.
Last updated -
5
38
The Discord MCP Server is a comprehensive tool for managing Discord bots and servers through a standardized interface, offering 93+ operations across all Discord functionalities.
Core Operations:
Message Management: Send, edit, delete messages; manage reactions, pins, bulk operations; retrieve message history and search with criteria like author, dates, attachments
Channel Operations: Create, edit, delete text/voice/forum channels; manage privacy settings and file uploads
Member & Role Management: Add/remove roles, edit member properties, search member information
Direct Messages & Friends: Create DM channels, manage friend relationships, send friend requests
Advanced Features:
Voice & Audio: Join/leave voice channels, play audio, control volume
Bot Presence: Update status (online, idle, DND), set custom activities (playing, streaming, watching)
Interactive Components: Send embeds, buttons, select menus, modal dialogs
Webhooks: Create, delete, and send webhook messages
Server Administration: Edit server settings, manage welcome screens, retrieve statistics
Content Management: Handle custom emojis, stickers, scheduled events
File Operations: List, download, and clean up message attachments
Security: Automoderation, invite management, bulk privacy controls
This unified master control interface streamlines all Discord bot operations into a single, standardized system.
Provides comprehensive Discord bot management capabilities including server information, channel creation and management, message operations, role and permission management, member moderation, voice channel operations, webhook management, and audit logging through Discord's API.
Discord MCP Server
⚠️ SECURITY WARNING: This project handles Discord bot tokens and server access. Please read our Security Policy before using or contributing.
A comprehensive Model Context Protocol (MCP) server for Discord API integration, providing powerful Discord bot management capabilities through a standardized interface.
Features
This server provides 93 Discord tools organized into the following categories:
Category | Tools Count | Description |
Message Management | 18 tools | Send, edit, delete, reactions, pin, bulk operations |
Channel Management | 25 tools | Create/edit/delete all channel types, positions, privacy |
Member & Role Management | 12 tools | Add/remove roles, edit members, search, info retrieval |
Voice & Audio | 6 tools | Join/leave voice, play audio, volume control |
Webhooks | 4 tools | Create, delete, list, send webhook messages |
Events & Scheduling | 4 tools | Create, edit, delete, list server events |
Emoji & Stickers | 6 tools | Manage custom emojis and stickers |
Privacy & Security | 7 tools | Auto-moderation, privacy controls, bulk settings |
Server Administration | 6 tools | Server settings, welcome screen, widget management |
Analytics & Export | 5 tools | Statistics, message history, chat log export |
Key Tools
discord_manage- Unified tool that handles all 93 operations through one interfacecomprehensive_channel_management- Multi-operation channel orchestratorbulk_set_privacy- Mass privacy control across channels/categoriesorganize_channels- Advanced channel/category positioning systemexport_chat_log- Professional chat export in JSON/CSV/TXT formats
Quick Start
Prerequisites
Node.js 18+ and npm
Discord bot token (see setup below)
Installation
# Clone the repository
git clone https://github.com/sashathelambo/discord-mcp.git
cd discord-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Start the server
npm start
Development Mode
npm run dev
Configuration
Discord Bot Setup
Go to Discord Developer Portal
Create a new application and bot
Copy the bot token to your
.envfileIMPORTANT: Regenerate your token if you suspect it's been exposed
Environment Variables
Create a .env file:
# Your Discord bot token (KEEP SECRET!)
DISCORD_TOKEN=your_bot_token_here
# Default Discord server ID (optional)
DISCORD_GUILD_ID=your_guild_id_here
Required Bot Permissions
Manage Server
Manage Roles
Manage Channels
Manage Messages
View Channels
Send Messages
Connect (for voice)
Speak (for voice)
Usage
MCP Integration
Use with MCP-compatible clients:
# Via stdio
npx discord-mcp
# Via HTTP (port 3001)
HTTP_PORT=3001 npx discord-mcp
Examples
Using the Master Control Tool
// All operations through one unified interface
await discord_manage({
action: 'send_message',
channelId: '123',
message: 'Hello World!'
});
await discord_manage({
action: 'create_text_channel',
guildId: '456',
name: 'new-channel'
});
await discord_manage({
action: 'comprehensive_channel_management',
guildId: '456',
operations: [
{ action: 'create_category', name: 'New Category' },
{ action: 'create_text_channel', name: 'general', categoryId: 'cat_id' },
{ action: 'set_channel_private', channelId: 'chan_id', isPrivate: true }
]
});
Using Individual Tools
// Server information
await discord.getServerInfo(guildId);
// Advanced channel creation
await discord.createForumChannel(guildId, "discussions", categoryId, {
topic: "Community discussions",
slowmode: 30,
isPrivate: true,
allowedRoles: ["member_role_id"]
});
// Bulk privacy management
await discord.bulkSetPrivacy(guildId, {
targets: [
{ id: "channel1", type: "channel", isPrivate: true },
{ id: "category1", type: "category", isPrivate: false }
]
});
// Export chat logs
await discord.exportChatLog(channelId, "JSON", {
limit: 1000,
dateRange: { start: "2024-01-01", end: "2024-12-31" }
});
Security
For Users
Keep your Discord bot token secret
Regularly rotate your tokens
Monitor bot activity
Use minimal required permissions
For Contributors
Never commit tokens or secrets
Validate all user inputs
Review dependencies for vulnerabilities
Follow secure coding practices
Tool Reference
Message Management Tools (18)
Tool Name | Description |
| Send messages to channels |
| Edit existing messages |
| Delete specific messages |
| Read message history from channels |
| Send DMs to users |
| Edit private messages |
| Delete private messages |
| Read DM history |
| Add emoji reactions |
| Remove emoji reactions |
| Pin messages in channels |
| Unpin messages |
| List pinned messages |
| Delete multiple messages |
| Crosspost announcements |
| Advanced message history with pagination |
| Extract message attachments |
| Read and analyze images from messages |
Channel Management Tools (25)
Tool Name | Description |
| Create text channels |
| Create voice channels |
| Create forum channels |
| Create announcement channels |
| Create stage channels |
| Edit any channel with advanced settings |
| Delete channels |
| Find channels by name |
| List all server channels |
| Create channel categories |
| Delete categories |
| Find categories by name |
| List channels in specific category |
| Move channel position |
| Move multiple channels |
| Move category position |
| Move channels between categories |
| Comprehensive channel organization |
| Get complete channel hierarchy |
| Set channel privacy settings |
| Set category privacy settings |
| Bulk privacy management |
| All-in-one channel operations |
| Upload files to channels |
| Export chat logs (JSON/CSV/TXT) |
Member & Role Management Tools (12)
Tool Name | Description |
| Find user IDs by username |
| List server members with pagination |
| Search members by name |
| Edit member properties |
| Get detailed member information |
| Create new server roles |
| Delete server roles |
| Modify role properties |
| Assign roles to members |
| Remove roles from members |
| List all server roles |
| Reorder role hierarchy |
Voice & Audio Tools (6)
Tool Name | Description |
| Connect bot to voice channels |
| Disconnect from voice channels |
| Stream audio in voice channels |
| Stop audio playback |
| Control audio volume |
| List active voice connections |
Webhook Tools (4)
Tool Name | Description |
| Create channel webhooks |
| Delete webhooks |
| List channel webhooks |
| Send messages via webhooks |
Events & Scheduling Tools (4)
Tool Name | Description |
| Create scheduled server events |
| Edit existing events |
| Delete server events |
| List all scheduled events |
Emoji & Sticker Tools (6)
Tool Name | Description |
| Create custom server emojis |
| Delete custom emojis |
| List all server emojis |
| Create custom server stickers |
| Delete custom stickers |
| List all server stickers |
Privacy & Security Tools (7)
Tool Name | Description |
| Create automoderation rules |
| Edit automod rules |
| Delete automod rules |
| List all automod rules |
| Create server invites |
| Delete/revoke invites |
| List all server invites |
Server Administration Tools (6)
Tool Name | Description |
| Get comprehensive server information |
| Edit server settings |
| Get server widget information |
| Get welcome screen settings |
| Configure welcome screen |
| Get comprehensive server statistics |
Interactive Components Tools (4)
Tool Name | Description |
| Send rich embed messages |
| Send messages with interactive buttons |
| Send messages with select menus |
| Send modal dialogs (interaction context) |
Master Control Tool (1)
Tool Name | Description |
| Unified tool - access ALL 93 operations through one interface |
Contributing
Project Creator & Lead Developer: @sashathelambo (Dr. Vova)
This project is primarily developed and maintained by sashathelambo. For contributions:
Read our Contributing Guidelines
Follow our Security Policy
Use the PR template
Test thoroughly before submitting
Discuss major changes with @sashathelambo first
Development Guidelines
Use TypeScript for all code
Follow existing code style
Add tests for new features
Never commit sensitive data
Update documentation
Troubleshooting
Common Issues
Token Invalid: Regenerate your Discord bot token
Permission Denied: Check bot permissions in Discord server
Build Errors: Ensure Node.js 18+ and TypeScript are installed
Getting Help
Check our documentation
Join our community discussions
License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer
This software is provided "as-is" without warranty. Users are responsible for:
Complying with Discord's Terms of Service
Securing their bot tokens and credentials
Using appropriate permissions and rate limiting
Monitoring and maintaining their Discord bots
Acknowledgments
@sashathelambo - Project creator, lead developer, and architect of all 93 Discord tools
Discord.js team for the excellent Discord API wrapper
Model Context Protocol community for the standardized protocol
Everyone who uses and supports this project
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables comprehensive Discord bot management and server operations through MCP, including channel management, message handling, member moderation, role management, and voice operations. Provides secure Discord API integration with built-in permission controls and audit logging capabilities.
- Features
- Quick Start
- Configuration
- Usage
- Security
- Tool Reference
- Message Management Tools (18)
- Channel Management Tools (25)
- Member & Role Management Tools (12)
- Voice & Audio Tools (6)
- Webhook Tools (4)
- Events & Scheduling Tools (4)
- Emoji & Sticker Tools (6)
- Privacy & Security Tools (7)
- Server Administration Tools (6)
- Interactive Components Tools (4)
- Master Control Tool (1)
- Contributing
- Troubleshooting
- License
- Disclaimer
- Acknowledgments
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityProvides Discord integration capabilities to MCP clients like Claude Desktop.Last updated -15125MIT License
- AsecurityAlicenseAqualityAn MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.Last updated -0MIT License
- AsecurityFlicenseAqualityAn MCP server that allows Claude to interact with Discord by providing tools for sending/reading messages and managing server resources through Discord's API.Last updated -1911