MCP-Discord Stream
Provides tools to interact with Discord, enabling message streaming, forum archiving, channel management, message sending, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Discord Stream stream messages from #general since yesterday"
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.
MCP-Discord Stream
A Discord MCP (Model Context Protocol) server with unlimited message streaming, forum archiving, and time-range filtering capabilities.
Fork Notice: This is an enhanced fork of barryyip0625/mcp-discord with added streaming capabilities for reading unlimited Discord history.
Overview
MCP-Discord Stream provides comprehensive Discord integration with powerful streaming features:
🆕 Streaming Features (New!)
Unlimited Message History - Read ALL messages from channels/forums (not limited to 100 messages)
Time Range Filtering - Fetch messages from specific date ranges (default: last 10 days)
Forum Archiving - Archive entire forums with all threads and messages
Batch Operations - Stream from multiple channels/forums simultaneously
Progress Tracking - Real-time progress updates during long operations
Rate Limit Handling - Gracefully handles Discord rate limits with partial data returns
Standard Features
Login to Discord bot
List servers the bot is a member of
Get server information
Search messages in a server
Read/delete channel messages
Send messages to specified channels
Retrieve forum channel lists
Create/delete/reply to forum posts
Create/delete text channels
Add/remove message reactions
Create/edit/delete/use webhooks
Related MCP server: Discord MCP Server
Table of Contents
Prerequisites
Node.js (v18.0.0 or higher)
npm (v7.0.0 or higher)
A Discord bot with appropriate permissions
Bot token (obtainable from the Discord Developer Portal)
Message Content Intent enabled (Required!)
Server Members Intent enabled
Presence Intent enabled
Permissions required in your Discord server:
Easiest Setup
Administrator (Recommended for quick setup and full functionality)
Or, select only the required permissions:
View Channel
Read Message History (Required for streaming!)
Send Messages
Create Public Threads
Send Messages in Threads
Manage Messages
Manage Threads
Manage Channels
Manage Webhooks
Add Reactions
Add your Discord bot to your server
To add your Discord bot to your server, use one of the following invite links (replace
INSERT_CLIENT_ID_HEREwith your bot's client ID):Administrator (full access): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8
Custom permissions (minimum required): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808
Important: According to Discord's security model, a bot can only access information from servers it has been explicitly added to. With "Read Message History" permission, the bot CAN read messages sent before it was added to the server!
Installation
Installing via NPM
npm install -g @yangyifei/mcp-discord-streamOr use directly via npx:
npx @yangyifei/mcp-discord-stream --config ${DISCORD_TOKEN}Manual Installation
# Clone the repository
git clone https://github.com/Yv3s-y4ng/mcp-discord-stream.git
cd mcp-discord-stream
# Install dependencies
npm install
# Compile TypeScript
npm run buildConfiguration
A Discord bot token is required for proper operation. The server supports two transport methods: stdio and streamable HTTP.
Transport Methods
stdio (Default)
Traditional stdio transport for basic usage
Suitable for simple integrations
streamable HTTP
HTTP-based transport for more advanced scenarios
Supports stateless operation
Configurable port number
Configuration Options
You can provide configuration in two ways:
Environment variables:
DISCORD_TOKEN=your_discord_bot_tokenUsing command line arguments:
# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"
# For streamable HTTP transport
node build/index.js --transport http --port 3000 --config "your_discord_bot_token"Usage with Claude/Cursor
Claude Desktop
Using stdio transport:
{
"mcpServers": {
"discord": {
"command": "npx",
"args": [
"@yangyifei/mcp-discord-stream",
"--config",
"your_discord_bot_token"
]
}
}
}Using streamable HTTP transport:
{
"mcpServers": {
"discord": {
"command": "npx",
"args": [
"@yangyifei/mcp-discord-stream",
"--transport",
"http",
"--port",
"3000",
"--config",
"your_discord_bot_token"
]
}
}
}Cursor
Using stdio transport:
{
"mcpServers": {
"discord": {
"command": "cmd",
"args": [
"/c",
"npx",
"@yangyifei/mcp-discord-stream",
"--config",
"your_discord_bot_token"
]
}
}
}Usage Examples
Example 1: Stream ALL Messages from a Channel
// Fetch last 30 days of messages (unlimited)
discord_read_messages_stream({
channelId: "123456789",
afterDate: "2024-01-01T00:00:00Z" // Optional: start from this date
})Example 2: Archive Entire Forum
// Archive all forum threads with messages from last 60 days
discord_archive_forum_stream({
forumChannelId: "987654321",
afterDate: "2024-01-01T00:00:00Z",
includeArchived: true
})Example 3: Batch Archive Multiple Forums
// Archive 3 forums at once
discord_archive_multiple_forums({
forumChannelIds: ["111", "222", "333"],
afterDate: "2024-01-01T00:00:00Z"
})Tools Documentation
🆕 Streaming Tools (New!)
discord_read_messages_stream
Streams messages from a Discord channel with unlimited history and time-range filtering.
Parameters:
channelId(string, required) - The ID of the channel to read fromafterDate(string, optional) - ISO 8601 date string (e.g., "2024-01-01T00:00:00Z") - only fetch messages after this datebeforeDate(string, optional) - ISO 8601 date string - only fetch messages before this date
Default: If no date range is provided, fetches messages from the last 10 days.
Returns:
Stream events including
batch,progress,rate_limited, andcompleteeventsEach batch contains up to 100 messages with full message data (content, author, timestamp, attachments, etc.)
discord_read_multiple_channels
Streams messages from multiple channels sequentially.
Parameters:
channelIds(string[], required) - Array of channel IDs to read fromafterDate(string, optional) - ISO 8601 date stringbeforeDate(string, optional) - ISO 8601 date string
Returns: Aggregated results from all channels with success/error status for each.
discord_get_channel_list
Lists all channels in a Discord server with optional type filtering.
Parameters:
guildId(string, required) - The ID of the Discord serverchannelTypes(number[], optional) - Array of Discord ChannelType numbers to filter by0= Text Channel2= Voice Channel4= Category15= Forum Channel
Returns: List of channels with id, name, type, and parentId.
discord_get_forum_post_stream
Streams all messages from a single forum post/thread with unlimited history.
Parameters:
threadId(string, required) - The ID of the forum threadafterDate(string, optional) - ISO 8601 date stringbeforeDate(string, optional) - ISO 8601 date string
Returns: Stream events with all messages from the thread.
discord_archive_forum_stream
Archives an entire forum channel by streaming all threads and their messages.
Parameters:
forumChannelId(string, required) - The ID of the forum channelafterDate(string, optional) - ISO 8601 date stringbeforeDate(string, optional) - ISO 8601 date stringincludeArchived(boolean, optional, default: true) - Whether to include archived threads
Returns:
threads_foundevent with total thread countthread_progressevents for each thread being processedMessage batches from all threads
completeorpartial_completeevent with summary
discord_archive_multiple_forums
Archives multiple forum channels at once.
Parameters:
forumChannelIds(string[], required) - Array of forum channel IDsafterDate(string, optional) - ISO 8601 date stringbeforeDate(string, optional) - ISO 8601 date stringincludeArchived(boolean, optional, default: true) - Include archived threads
Returns: Aggregated results from all forums.
Basic Functions
discord_login: Login to Discord using the configured tokendiscord_list_servers: List all Discord servers the bot is a member ofdiscord_send: Send a message to a specified channel (supports both channel ID and channel name)discord_get_server_info: Get Discord server information
Channel Management
discord_create_text_channel: Create a text channeldiscord_delete_channel: Delete a channeldiscord_create_category: Create a channel categorydiscord_edit_category: Edit a categorydiscord_delete_category: Delete a category
Forum Functions
discord_get_forum_channels: Get a list of forum channelsdiscord_create_forum_post: Create a forum postdiscord_get_forum_post: Get a forum post (limited to 10 messages - usediscord_get_forum_post_streamfor more)discord_list_forum_threads: List all threads in a forumdiscord_reply_to_forum: Reply to a forum postdiscord_delete_forum_post: Delete a forum post
Messages and Reactions
discord_search_messages: Search messages in a serverdiscord_read_messages: Read channel messages (limited to 100 - usediscord_read_messages_streamfor more)discord_add_reaction: Add a reaction to a messagediscord_add_multiple_reactions: Add multiple reactions to a messagediscord_remove_reaction: Remove a reaction from a messagediscord_delete_message: Delete a specific message from a channel
Webhook Management
discord_create_webhook: Creates a new webhook for a Discord channeldiscord_send_webhook_message: Sends a message to a Discord channel using a webhookdiscord_edit_webhook: Edits an existing webhook for a Discord channeldiscord_delete_webhook: Deletes an existing webhook for a Discord channel
Streaming Features Explained
Time Range Filtering
All streaming tools support time-range filtering via ISO 8601 date strings:
// Fetch messages from a specific time range
{
afterDate: "2024-01-01T00:00:00Z", // Start date (inclusive)
beforeDate: "2024-12-31T23:59:59Z" // End date (inclusive)
}
// Fetch messages from last X days (omit both dates to use default 10 days)
{
afterDate: "2024-01-15T00:00:00Z" // Last 10+ days
}
// Fetch ALL messages (no time limit - use with caution!)
{
afterDate: "2015-01-01T00:00:00Z" // Discord's founding year
}Stream Event Types
Streaming tools return different event types to provide real-time feedback:
progress- Periodic progress updates during fetchingbatch- Contains message data (up to 100 messages per batch)threads_found- (Forums only) Total number of threads discoveredthread_progress- (Forums only) Current thread being processedrate_limited- Discord rate limit hit, includes retry wait timecomplete- All data fetched successfullypartial_complete- Partial data returned (e.g., due to rate limits or errors)
Rate Limit Handling
When Discord rate limits are hit:
The tool returns a
rate_limitedevent with wait timeAlready-fetched data is returned as
partial_completeYou can retry the request after the wait period
Performance Tips
Use specific date ranges - Narrow time ranges = faster responses
Process channels sequentially - Use
discord_read_multiple_channelsinstead of parallel requestsMonitor rate limits - Discord has per-channel and global rate limits
Archive during off-peak hours - Large archives work best when server activity is low
Development
# Install dependencies
npm install
# Development mode with auto-reload
npm run dev
# Run tests
npm test
# Build for production
npm run build
# Run built version
npm startContributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
License
Acknowledgments
This project is a fork of barryyip0625/mcp-discord with significant enhancements for unlimited message streaming and archiving capabilities.
Special thanks to:
Barry Yip (@barryyip0625) for the original MCP-Discord implementation
The Anthropic team for the Model Context Protocol
Discord.js community for the excellent Discord API library
Available Tools
31 toolsdiscord_add_multiple_reactionsB
Adds multiple emoji reactions to a Discord message at once
Inputs: emojis (required), channelId (required), messageId (required).
discord_add_reactionC
Adds an emoji reaction to a specific Discord message
Inputs: emoji (required), channelId (required), messageId (required).
discord_archive_forum_streamB
Archives an entire forum channel by streaming all threads and their messages. Includes active and archived threads with time range filtering.
Inputs: forumChannelId (required), afterDate, beforeDate, includeArchived.
discord_archive_multiple_forumsA
Archives multiple forum channels at once. Processes each forum sequentially, collecting all threads and messages.
Inputs: forumChannelIds (required), afterDate, beforeDate, includeArchived.
discord_create_categoryC
Creates a new category in a Discord server.
Inputs: name (required), guildId (required), reason, position.
discord_create_forum_postB
Creates a new post in a Discord forum channel with optional tags
Inputs: title (required), content (required), forumChannelId (required), tags.
discord_create_text_channelB
Creates a new text channel in a Discord server with an optional topic
Inputs: guildId (required), channelName (required), topic.
discord_create_webhookC
Creates a new webhook for a Discord channel
Inputs: name (required), channelId (required), avatar, reason.
discord_delete_categoryB
Deletes a Discord category by ID.
Inputs: categoryId (required), reason.
discord_delete_channelB
Deletes a Discord channel with an optional reason
Inputs: channelId (required), reason.
discord_delete_forum_postC
Deletes a forum post or thread with an optional reason
Inputs: threadId (required), reason.
discord_delete_messageB
Deletes a specific message from a Discord text channel
Inputs: channelId (required), messageId (required), reason.
discord_delete_webhookC
Deletes an existing webhook for a Discord channel
Inputs: webhookId (required), reason, webhookToken.
discord_edit_categoryB
Edits an existing Discord category (name and position).
Inputs: categoryId (required), name, reason, position.
discord_edit_webhookC
Edits an existing webhook for a Discord channel
Inputs: webhookId (required), name, avatar, reason, +2 more.
discord_get_channel_listA
Lists all channels in a Discord server with optional filtering by channel type (text, voice, forum, etc.)
Inputs: guildId (required), channelTypes.
discord_get_forum_channelsA
Lists all forum channels in a specified Discord server (guild)
Inputs: guildId (required).
discord_get_forum_postB
Retrieves details about a forum post including its messages
Inputs: threadId (required).
discord_get_forum_post_streamA
Streams all messages from a single forum post/thread with time range filtering (default: last 10 days)
Inputs: threadId (required), afterDate, beforeDate.
discord_get_server_infoB
Retrieves detailed information about a Discord server including channels and member count
Inputs: guildId (required).
discord_list_forum_threadsA
Lists all threads (posts) in a Discord forum channel, including both active and archived threads
Inputs: forumChannelId (required), limit, includeArchived.
discord_list_serversA
Lists all Discord servers the bot is a member of
Inputs: no named parameters.
discord_loginB
Logs in to Discord using the configured token
Inputs: token.
discord_read_messagesA
Retrieves messages from a Discord text channel with a configurable limit
Inputs: channelId (required), limit.
discord_read_messages_streamA
Streams messages from a Discord channel with time range filtering (default: last 10 days). Returns all message events including progress updates.
Inputs: channelId (required), afterDate, beforeDate.
discord_read_multiple_channelsA
Streams messages from multiple Discord channels at once. Processes each channel sequentially with time range filtering.
Inputs: channelIds (required), afterDate, beforeDate.
discord_remove_reactionB
Removes a specific emoji reaction from a Discord message
Inputs: emoji (required), channelId (required), messageId (required), userId.
discord_reply_to_forumB
Adds a reply to an existing forum post or thread
Inputs: message (required), threadId (required).
discord_search_messagesC
Searches for messages in a Discord server
Inputs: guildId (required), has, limit, maxId, +10 more.
discord_sendA
Sends a message to a specified Discord text channel. Optionally reply to another message by providing its message ID.
Inputs: message (required), channelId (required), replyToMessageId.
discord_send_webhook_messageB
Sends a message to a Discord channel using a webhook
Inputs: content (required), webhookId (required), webhookToken (required), threadId, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 31 tools
Most tools target distinct resources and actions (create/delete/read/send), but there is overlap among the streaming and reading tools (e.g., read_messages vs read_messages_stream vs read_multiple_channels vs get_forum_post_stream). Descriptions help clarify the differences, though the streaming variants could be confused.
All tool names follow the consistent pattern 'discord_verb_noun', with verbs like create, delete, get, list, read, send, edit, remove, and archive. The convention is uniform and makes the tool's purpose predictable.
At 31 tools, the server exceeds the recommended range and feels heavy. Several tools are near-duplicates (e.g., archive_forum_stream vs archive_multiple_forums, get_forum_post vs get_forum_post_stream), suggesting consolidation would improve the set.
The server covers a broad range of Discord features including channels, categories, messages, reactions, webhooks, and forums. However, it lacks update operations for messages and most channels, and there is no member/role/permission management, leaving notable gaps in the domain.
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
An MCP server that integrates with Discord to provide AI-powered features.
- Discortics - Discord BotDeprecatedcom.discortics
Set up and manage your Discord server from MCP: channels, roles, verification, tickets and security.
An MCP server for deep research or task groups
Related MCP Servers
- AlicenseBqualityDmaintenanceA Discord MCP server that enables AI assistants to interact with Discord platforms, providing functionalities like sending messages, managing channels, creating forum posts, and handling webhooks.211MIT
- AlicenseBqualityBmaintenanceEnables 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.1919MIT
- FlicenseNot gradedqualityDmaintenanceA read-only Discord MCP server that allows AI agents to list channels, read messages, and get attachment images from a Discord server for summarization and reporting.-
- AlicenseNot gradedqualityDmaintenanceExtended MCP server for Discord with advanced server management capabilities including roles, channels, messages, permissions, forums, webhooks, and batch operations.1MIT