What can you do with this server?

The MCP-Discord server enables AI agents to interact with Discord through the Model Context Protocol, providing comprehensive platform management and communication features. Message Management: Send, read (up to 100 messages), and delete messages in Discord channels. Channel Operations: Create, edit, and delete text channels and categories with custom names, topics, and positions. Retrieve server information including channels and member counts. Forum Support: List forum channels, create forum posts with titles, content, and tags, retrieve post details, reply to threads, and delete posts. Reaction Handling: Add single or multiple emoji reactions to messages, remove reactions, and optionally generate AI-powered contextual reactions. Webhook Integration: Create, edit, delete, and send messages via webhooks with custom names, avatars, and channels. Bi-directional Communication: Listen to messages and respond automatically when mentioned via sampling capability. Authentication & Control: Log in using bot tokens, with built-in rate limiting, message chunking, and access control (block DMs, specific guilds, and banned users).

Which integrations are available for this server?

Enables AI assistants to interact with Discord platforms, providing capabilities for channel management, message handling, forum operations, webhook management, and server information retrieval. Serves as the runtime environment for the MCP server, required for operation with version 16.0.0 or higher. Used for package management and installation of the MCP server, with version 7.0.0 or higher required. Offered as an alternative package manager for development mode of the MCP server. Used as the implementation language for the MCP server, with compilation required during the build process.

How do I use MCP-Discord?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP-Discord send a message to #general saying 'Meeting starts in 5 minutes!'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

💬 Discord MCP Server

npm version License: MIT

Overview

The Discord MCP Server enables AI agents to interact with the Discord platform through the Model Context Protocol (MCP). This server provides comprehensive access to Discord's features including messaging, channel management, forum operations, reactions, and webhook management.

By implementing MCP, this server allows Large Language Models (LLMs) to read and send messages, manage channels and forums, handle reactions, and interact with webhooks directly through their context window, bridging the gap between AI and Discord communities.

The server supports bi-directional communication through a Sampling feature, allowing the bot to listen to messages and respond automatically when mentioned.

Related MCP server: MCP Toolkit

Features

Message Management: Send, read, and delete messages in Discord channels
Channel Operations: Create and delete text channels with custom topics
Forum Support: Create, read, reply to, and delete forum posts with tag support
Reaction Handling: Add single or multiple reactions to messages
Webhook Integration: Create, edit, delete, and send messages via webhooks
Server Information: Retrieve detailed server information including channels and member counts

Installation

Using npx (Recommended)

To use this server without installing it globally:

npx @iqai/mcp-discord --config ${DISCORD_TOKEN}

Build from Source

git clone https://github.com/IQAIcom/mcp-discord.git cd mcp-discord pnpm install pnpm run build

Running with an MCP Client

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

Minimal Configuration

{ "mcpServers": { "discord": { "command": "npx", "args": ["-y", "@iqai/mcp-discord", "--config", "YOUR_DISCORD_TOKEN"] } } }

Advanced Configuration (Local Build)

{ "mcpServers": { "discord": { "command": "node", "args": ["/absolute/path/to/mcp-discord/dist/index.js"], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "SAMPLING_ENABLED": "true", "TRANSPORT": "stdio" } } } }

Configuration (Environment Variables)

Variable	Required	Description	Default
`DISCORD_TOKEN`	Yes	Discord bot token from the Developer Portal	-
`SAMPLING_ENABLED`	No	Enables bi-directional message sampling	`true`
`TRANSPORT`	No	Transport method: `stdio` or `http`	`stdio`
`HTTP_PORT`	No	Port for HTTP transport	`8080`
`DEFAULT_RATE_LIMIT_SECONDS`	No	Rate limit (seconds) for sampling requests per user	`2`
`DEFAULT_MESSAGE_CHUNK_SIZE`	No	Max message chunk size for sampling responses	`2000`
`RESPOND_TO_MENTIONS_ONLY`	No	Only respond to messages that mention the bot	`true`
`BLOCK_DMS`	No	Block direct messages to the bot	`true`
`BLOCKED_GUILDS`	No	Comma-separated list of guild IDs to block	`""`
`BANNED_USERS`	No	Comma-separated list of user IDs to ban	`""`
`REACTION_SAMPLING_ENABLED`	No	Enable AI-generated contextual reactions	`false`
`REACTION_TIMEOUT_MS`	No	Timeout (ms) for reaction sampling requests	`3000`
`REACTION_FALLBACK_EMOJI`	No	Fallback emoji when reaction sampling fails	`"🤔"`

Prerequisites

Before using this MCP server, you need:

A Discord bot with appropriate permissions from the Discord Developer Portal
Enable these intents: Message Content, Server Members, Presence
Add the bot to your server with required permissions (Administrator recommended, or specific permissions for channels, messages, webhooks)

Usage Examples

Message Operations

"Send a message to channel #general saying 'Hello everyone!'"
"Read the last 10 messages from the announcements channel"
"Delete the message with ID 123456789 from #spam-channel"

Channel Management

"Create a new text channel called 'project-updates' with topic 'Project status updates'"
"Delete the channel #old-channel"
"Get all the server information including channel list"

Forum Operations

"List all forum channels in this server"
"Create a new forum post titled 'Feature Request' with content about the new feature"
"Reply to the forum post about bugs with a status update"

Reaction Handling

"Add a thumbs up reaction to the latest message in #feedback"
"Add multiple reactions (🎉 🚀 ✅) to the announcement message"
"Remove my reaction from that message"

Webhook Management

"Create a webhook named 'Notifications Bot' in #alerts channel"
"Send a message via webhook to post as 'System Alert'"
"Delete the unused webhook from #old-notifications"

MCP Tools

`discord_add_multiple_reactions`

Adds multiple emoji reactions to a Discord message at once

Parameter	Type	Required	Description
`channelId`	string	✅
`messageId`	string	✅
`emojis`	array	✅

`discord_add_reaction`

Adds an emoji reaction to a specific Discord message

Parameter	Type	Required	Description
`channelId`	string	✅
`messageId`	string	✅
`emoji`	string	✅

`discord_create_category`

Creates a new category in a Discord server.

Parameter	Type	Required	Description
`guildId`	string	✅
`name`	string	✅
`position`	number
`reason`	string

`discord_create_forum_post`

Creates a new post in a Discord forum channel with optional tags

Parameter	Type	Required	Description
`forumChannelId`	string	✅
`title`	string	✅
`content`	string	✅
`tags`	array

`discord_create_text_channel`

Creates a new text channel in a Discord server with an optional topic

Parameter	Type	Required	Description
`guildId`	string	✅
`channelName`	string	✅
`topic`	string

`discord_create_webhook`

Creates a new webhook for a Discord channel

Parameter	Type	Required	Description
`channelId`	string	✅
`name`	string	✅
`avatar`	string
`reason`	string

`discord_delete_category`

Deletes a Discord category by ID.

Parameter	Type	Required	Description
`categoryId`	string	✅
`reason`	string

`discord_delete_channel`

Deletes a Discord channel with an optional reason

Parameter	Type	Required	Description
`channelId`	string	✅
`reason`	string

`discord_delete_forum_post`

Deletes a forum post or thread with an optional reason

Parameter	Type	Required	Description
`threadId`	string	✅
`reason`	string

`discord_delete_message`

Deletes a specific message from a Discord text channel

Parameter	Type	Required	Description
`channelId`	string	✅
`messageId`	string	✅
`reason`	string

`discord_delete_webhook`

Deletes an existing webhook for a Discord channel

Parameter	Type	Required	Description
`webhookId`	string	✅
`webhookToken`	string
`reason`	string

`discord_edit_category`

Edits an existing Discord category (name and position).

Parameter	Type	Required	Description
`categoryId`	string	✅
`name`	string
`position`	number
`reason`	string

`discord_edit_webhook`

Edits an existing webhook for a Discord channel

Parameter	Type	Required	Description
`webhookId`	string	✅
`webhookToken`	string
`name`	string
`avatar`	string
`channelId`	string
`reason`	string

`discord_get_forum_channels`

Lists all forum channels in a specified Discord server (guild)

Parameter	Type	Required	Description
`guildId`	string	✅

`discord_get_forum_post`

Retrieves details about a forum post including its messages

Parameter	Type	Required	Description
`threadId`	string	✅

`discord_get_server_info`

Retrieves detailed information about a Discord server including channels and member count

Parameter	Type	Required	Description
`guildId`	string	✅

`discord_login`

Logs in to Discord using the configured token

Parameter	Type	Required	Description
`token`	string

`discord_read_messages`

Retrieves messages from a Discord text channel with a configurable limit

Parameter	Type	Required	Default	Description
`channelId`	string	✅
`limit`	number		50

`discord_remove_reaction`

Removes a specific emoji reaction from a Discord message

Parameter	Type	Required	Description
`channelId`	string	✅
`messageId`	string	✅
`emoji`	string	✅
`userId`	string

`discord_reply_to_forum`

Adds a reply to an existing forum post or thread

Parameter	Type	Required	Description
`threadId`	string	✅
`message`	string	✅

`discord_send`

Sends a message to a specified Discord text channel

Parameter	Type	Required	Description
`channelId`	string	✅
`message`	string	✅

`discord_send_webhook_message`

Sends a message to a Discord channel using a webhook

Parameter	Type	Required	Description
`webhookId`	string	✅
`webhookToken`	string	✅
`content`	string	✅
`username`	string
`avatarURL`	string
`threadId`	string

Development

Build Project

pnpm run build

Development Mode (Watch)

pnpm run watch

Linting & Formatting

pnpm run lint pnpm run format

Project Structure

src/tools/: Individual tool handlers
src/tool-list.ts: MCP tool definitions
src/schemas.ts: Zod validation schemas
src/sampling.ts: Bi-directional sampling feature
src/index.ts: Server entry point

Resources

Disclaimer

This project is an unofficial tool and is not directly affiliated with Discord Inc. Users are responsible for ensuring their bot usage complies with Discord's Terms of Service and Developer Terms.

License

MIT

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

💬 Discord MCP Server

Overview

Features

Installation

Using npx (Recommended)

Build from Source

Running with an MCP Client

Minimal Configuration

Advanced Configuration (Local Build)

Configuration (Environment Variables)

Prerequisites

Usage Examples

Message Operations

Channel Management

Forum Operations

Reaction Handling

Webhook Management

MCP Tools

discord_add_multiple_reactions

discord_add_reaction

discord_create_category

discord_create_forum_post

discord_create_text_channel

discord_create_webhook

discord_delete_category

discord_delete_channel

discord_delete_forum_post

discord_delete_message

discord_delete_webhook

discord_edit_category

discord_edit_webhook

discord_get_forum_channels

discord_get_forum_post

discord_get_server_info

discord_login

discord_read_messages

discord_remove_reaction

discord_reply_to_forum

discord_send

discord_send_webhook_message

Development

Build Project

Development Mode (Watch)

Linting & Formatting

Project Structure

Resources

Disclaimer

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

`discord_add_multiple_reactions`

`discord_add_reaction`

`discord_create_category`

`discord_create_forum_post`

`discord_create_text_channel`

`discord_create_webhook`

`discord_delete_category`

`discord_delete_channel`

`discord_delete_forum_post`

`discord_delete_message`

`discord_delete_webhook`

`discord_edit_category`

`discord_edit_webhook`

`discord_get_forum_channels`

`discord_get_forum_post`

`discord_get_server_info`

`discord_login`

`discord_read_messages`

`discord_remove_reaction`

`discord_reply_to_forum`

`discord_send`

`discord_send_webhook_message`