Skip to main content
Glama
MCP-Discord Stream

MCP-Discord Stream

by Yv3s-y4ng

MCP-Discord Stream

npm version

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

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-stream

Or 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 build

Configuration

A Discord bot token is required for proper operation. The server supports two transport methods: stdio and streamable HTTP.

Transport Methods

  1. stdio (Default)

    • Traditional stdio transport for basic usage

    • Suitable for simple integrations

  2. streamable HTTP

    • HTTP-based transport for more advanced scenarios

    • Supports stateless operation

    • Configurable port number

Configuration Options

You can provide configuration in two ways:

  1. Environment variables:

DISCORD_TOKEN=your_discord_bot_token
  1. Using 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

  1. Using stdio transport:

{
    "mcpServers": {
        "discord": {
            "command": "npx",
            "args": [
                "@yangyifei/mcp-discord-stream",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}
  1. Using streamable HTTP transport:

{
    "mcpServers": {
        "discord": {
            "command": "npx",
            "args": [
                "@yangyifei/mcp-discord-stream",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

Cursor

  1. 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 from

  • afterDate (string, optional) - ISO 8601 date string (e.g., "2024-01-01T00:00:00Z") - only fetch messages after this date

  • beforeDate (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, and complete events

  • Each 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 from

  • afterDate (string, optional) - ISO 8601 date string

  • beforeDate (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 server

  • channelTypes (number[], optional) - Array of Discord ChannelType numbers to filter by

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 thread

  • afterDate (string, optional) - ISO 8601 date string

  • beforeDate (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 channel

  • afterDate (string, optional) - ISO 8601 date string

  • beforeDate (string, optional) - ISO 8601 date string

  • includeArchived (boolean, optional, default: true) - Whether to include archived threads

Returns:

  • threads_found event with total thread count

  • thread_progress events for each thread being processed

  • Message batches from all threads

  • complete or partial_complete event with summary

discord_archive_multiple_forums

Archives multiple forum channels at once.

Parameters:

  • forumChannelIds (string[], required) - Array of forum channel IDs

  • afterDate (string, optional) - ISO 8601 date string

  • beforeDate (string, optional) - ISO 8601 date string

  • includeArchived (boolean, optional, default: true) - Include archived threads

Returns: Aggregated results from all forums.


Basic Functions

  • discord_login: Login to Discord using the configured token

  • discord_list_servers: List all Discord servers the bot is a member of

  • discord_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 channel

  • discord_delete_channel: Delete a channel

  • discord_create_category: Create a channel category

  • discord_edit_category: Edit a category

  • discord_delete_category: Delete a category

Forum Functions

  • discord_get_forum_channels: Get a list of forum channels

  • discord_create_forum_post: Create a forum post

  • discord_get_forum_post: Get a forum post (limited to 10 messages - use discord_get_forum_post_stream for more)

  • discord_list_forum_threads: List all threads in a forum

  • discord_reply_to_forum: Reply to a forum post

  • discord_delete_forum_post: Delete a forum post

Messages and Reactions

  • discord_search_messages: Search messages in a server

  • discord_read_messages: Read channel messages (limited to 100 - use discord_read_messages_stream for more)

  • discord_add_reaction: Add a reaction to a message

  • discord_add_multiple_reactions: Add multiple reactions to a message

  • discord_remove_reaction: Remove a reaction from a message

  • discord_delete_message: Delete a specific message from a channel

Webhook Management

  • discord_create_webhook: Creates a new webhook for a Discord channel

  • discord_send_webhook_message: Sends a message to a Discord channel using a webhook

  • discord_edit_webhook: Edits an existing webhook for a Discord channel

  • discord_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:

  1. progress - Periodic progress updates during fetching

  2. batch - Contains message data (up to 100 messages per batch)

  3. threads_found - (Forums only) Total number of threads discovered

  4. thread_progress - (Forums only) Current thread being processed

  5. rate_limited - Discord rate limit hit, includes retry wait time

  6. complete - All data fetched successfully

  7. partial_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_limited event with wait time

  • Already-fetched data is returned as partial_complete

  • You can retry the request after the wait period

Performance Tips

  1. Use specific date ranges - Narrow time ranges = faster responses

  2. Process channels sequentially - Use discord_read_multiple_channels instead of parallel requests

  3. Monitor rate limits - Discord has per-channel and global rate limits

  4. 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 start

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

License

MIT 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 tools
discord_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

    B3.1/5.0

    Scored across 31 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      21
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      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.
      19
      19
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Extended MCP server for Discord with advanced server management capabilities including roles, channels, messages, permissions, forums, webhooks, and batch operations.
      1
      MIT