mcp-client-discord
Listens for Discord @mentions and queues them for retrieval via MCP tools, enabling AI agents to process and respond to mentions in Discord channels.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-client-discord
Discord Event Listener with Claude-Powered Auto-Response via KADI Broker.
Overview
mcp-client-discord is a TypeScript-based MCP server that listens for Discord @mentions and queues them for template-agent-typescript to process. It uses Discord Gateway to receive real-time events.
Related MCP server: Discord MCP Server
Architecture
Discord Channel → Gateway Event → Mention Queue → template-agent-typescript → Claude API → mcp-server-discord → Discord ReplyComponents
Discord Gateway: Real-time WebSocket connection for receiving events
Mention Queue: In-memory queue (max 100) of unprocessed @mentions
MCP Server: Exposes
get_discord_mentionstool for KADI broker integrationTool Registration: Available to any KADI agent via broker
Setup
1. Install Dependencies
npm install2. Configure Environment
Copy .env.example to .env:
cp .env.example .envEdit .env with your Discord bot token:
DISCORD_TOKEN=your_discord_bot_token_here
DISCORD_GUILD_ID=your_discord_guild_id_here # Optional
MCP_LOG_LEVEL=info3. Get Discord Bot Token
Go to Discord Developer Portal
Create a new application
Go to "Bot" section
Click "Reset Token" and copy the token
Enable "Message Content Intent" in bot settings
Invite bot to your server with proper permissions (Send Messages, Read Messages, etc.)
4. Build
npm run build5. Run
Development mode (with hot-reload):
npm run devProduction mode:
npm startMCP Tools
get_discord_mentions
Retrieve pending Discord @mentions from the queue.
Input:
limit(optional): Maximum number of mentions to retrieve (1-50, default: 10)
Output:
{
"mentions": [
{
"id": "message_id",
"user": "user_id",
"username": "username",
"text": "message text without @bot mention",
"channel": "channel_id",
"channelName": "channel_name",
"guild": "guild_id",
"ts": "ISO_timestamp"
}
],
"count": 1,
"retrieved_at": "ISO_timestamp"
}Integration with KADI Broker
The MCP server is registered in kadi-broker/config/mcp-upstreams.json:
{
"id": "discord-client",
"name": "Discord Event Listener (mcp-client-discord)",
"type": "stdio",
"prefix": "discord_client",
"enabled": true,
"stdio": {
"command": "node",
"args": ["C:\\p4\\Personal\\SD\\mcp-client-discord\\dist\\index.js"],
"env": {
"DISCORD_TOKEN": "your_token",
"DISCORD_GUILD_ID": "your_guild_id"
}
},
"networks": ["discord"]
}Event Topics
Topic Pattern Standard
All KĀDI events follow the standardized topic pattern: {platform}.{event_type}.{bot_id}
{platform}: Platform identifier (slack,discord, etc.){event_type}: Event type (app_mention,mention, etc.){bot_id}: Bot unique identifier (critical for multi-bot deployments)
Why bot_id is required:
✅ Enables multiple bot instances in the same server
✅ Routes events only to the intended bot
✅ Prevents cross-bot event delivery
✅ Supports multi-tenant deployments
Validation: Topics are automatically validated by @agents/shared package. Invalid patterns will log warnings but still publish.
See TOPIC_PATTERN.md for complete documentation.
discord.mention.{BOT_USER_ID}
Published when the bot is @mentioned in Discord.
Event Payload (DiscordMentionEvent):
{
id: string; // Unique message ID
user: string; // Discord user ID who mentioned the bot
username: string; // Discord username
text: string; // Message text (with @bot mention removed)
channel: string; // Discord channel ID
channelName: string; // Discord channel name
guild: string; // Discord guild/server ID
ts: string; // ISO 8601 timestamp
timestamp: string; // ISO 8601 datetime when event was published
}Usage with Agent_TypeScript
Agent_TypeScript polls this MCP server for new @mentions:
// In Agent_TypeScript
const protocol = client.getBrokerProtocol();
const result = await protocol.invokeTool({
targetAgent: 'discord-client',
toolName: 'discord_client_get_discord_mentions',
toolInput: { limit: 5 },
timeout: 10000
});
const mentions = JSON.parse(result.content[0].text).mentions;Discord Bot Permissions
Required bot permissions:
View Channels
Send Messages
Read Message History
Add Reactions (optional)
Required Gateway Intents:
Guilds
Guild Messages
Message Content
Logging
The server logs to console with emoji indicators:
🚀 Startup messages
📬 Mention queued
📤 Mentions retrieved
✅ Success messages
❌ Error messages
💬 Received mention
Troubleshooting
"Discord client not ready after timeout"
Check DISCORD_TOKEN is valid
Verify bot has been invited to server
Ensure internet connection is stable
"Channel not found" errors
Verify bot has access to the channel
Check channel permissions
Bot not responding to mentions
Verify "Message Content Intent" is enabled
Check bot has "Send Messages" permission
Ensure bot is not muted or blocked
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Connect a Discord bot (bot token from the developer portal) to read/send messages, list guilds and c
Control your Discord community: send/read messages, manage channels and forums, and handle webhook…
Let AI agents read your Discord community's analytics, members and tickets, and save drafts.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables comprehensive interaction with Discord servers to manage guilds, channels, messages, and members through an agentic workflow. It supports RAG capabilities, rate-limited message operations, and includes a React-based dashboard for monitoring and configuration.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to manage Discord servers through natural language, offering tools for guilds, channels, messages, roles, members, webhooks, invites, and automations. Includes a conversational agent that responds to @mentions in Discord.11Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to read messages, discover channels, send messages, and monitor Discord communities using the Discord HTTP API.-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Discord servers by providing tools for catching up, triaging mentions, bookmarking, and sending messages through a self-hosted bot.4MIT