What you can do with Discord

Built for

Community Managers, Developer Relations, Gaming Teams, Internal Operations

Example workflows

Summarize a busy channel

Turns message history into a community operations brief.

Try this

Read recent Discord messages in the support channel, summarize the main issues, and list unanswered questions that need staff follow-up.

Prepare announcement replies

Uses thread context while keeping posting explicit.

Try this

Review replies to the latest announcement thread and draft responses for common questions without posting yet.

Audit pinned context

Improves server hygiene around fixed channel context.

Try this

Fetch pinned messages in the onboarding channel and recommend which pins are stale or missing for new members.

Review member activity

Connects members, messages, and channels for moderation workflows.

Try this

List recent server members and message activity in key channels, then summarize potential moderation or support follow-up.

Context to know first

What Discord data can agents use?

Agents can inspect guilds, channels, messages, thread channels, members, pins, reactions, and bot-managed messages available to the connected server.

Can agents post to Discord?

Yes, where the bot has permission. Prompts should be explicit about the target guild, channel, thread, and whether the agent should draft or actually post.

Does Discord support global message search here?

No. Work by reading known channels or threads. For research-style tasks, start by discovering channels, then fetch relevant message history.

Related editorial

Discord Workflows with AI

How AI agents can post messages, open threads, manage reactions and pins, moderate members, and answer questions across a Discord server.

Read article

AI Skill
SKILL.md

Domain knowledge for Discord — workflow patterns, data models, and gotchas for your AI agent.

Discord

Typical Workflow

  1. Discover guilds: List servers the bot can access, or resolve one by guild id.
  2. Discover channels: Within a guild, list channels or open a specific channel by id.
  3. Read messages: Fetch history for a channel (or thread channel id).
  4. Post a message: Send new content to a channel.
  5. Reply to a message: Thread the reply using channel id, parent message id, and content.
  6. React: Add an emoji reaction to a message.
  7. Look up members: List members in a guild or fetch one by user id.

Key Concepts

  • Guild = a Discord server. The bot is added to a guild when the user authorizes via OAuth.
  • Channel IDs are snowflake strings (e.g. 1234567890123456789).
  • Message IDs are also snowflakes, used for replies and reactions.
  • Threads are channels with a parent_id — read and post using the thread’s channel id like any other channel.
  • Snowflake pagination: use before / after message IDs instead of cursors.
  • Reactions use emoji characters (👍, ❤️, 🔥) or name:id for custom emoji.

Thread Management

  • Create a thread from an existing message: parent channel id, parent message id, and thread name.
  • Create a standalone thread: parent channel id and thread name (no parent message).
  • Read/post in threads: Threads have their own channel id; use the same read/send flows as regular channels.

Message Management

  • Edit the bot's own messages: channel id, message id, new body.
  • Delete messages: bot can always delete its own; deleting others needs MANAGE_MESSAGES.
  • Pin/Unpin: requires MANAGE_MESSAGES where applicable.
  • Read pins: Fetch pinned messages first when you need fixed channel context.

Gotchas

  • Rate limit: 50 requests/second globally, per-route limits vary—back off when responses indicate throttling.
  • Emoji for reactions: use the Unicode character directly. Custom emoji use name:id format.
  • No server-side message search: Work by reading known channels/threads rather than global keyword search.
  • Gateway intents: Reading literal message bodies or enumerating every guild member requires the corresponding privileged intents to be enabled for the bot application.
  • Max 50 pins per channel: Discord enforces this limit.

Tools in this Server (14)

Discord Add Reaction

Add a reaction emoji to a Discord message. Use Unicode emoji directly (thumbs up, heart, fire, eyes, check mark, rocket, party popper) or custom emoji...

Discord Channels

Get Discord channels. Pass channel_id to get a single channel's details, or pass guild_id to list all channels in a guild. Returns id, name, type, top...

Discord Create Thread

Create a thread in a Discord channel. Pass message_id to start a thread from an existing message (the message becomes the thread starter), or omit to ...

Discord Delete Message

Delete a message from a Discord channel. The bot can always delete its own messages, and can delete others' messages if it has MANAGE_MESSAGES permiss...

Discord Edit Message

Edit a message previously sent by the bot. Use this to correct typos, update information, or iteratively refine a message. Only messages sent by the b...

Discord Guilds

Get Discord guilds (servers). Pass guild_id to get a single guild's details, or omit to list all guilds the bot is in. Use this to discover guild IDs ...

Discord Members

Get Discord guild members. Pass user_id to get a single member's details (display name, roles, join date), or omit to list members. Use this to discov...

Discord Messages

Read messages from a Discord channel or thread. Returns message content, author name, timestamp, reactions, attachments, and reply references. Use bef...

Discord Pin Message

Pin a message in a Discord channel. Pinned messages appear in the channel's pin list (readable via discord_pinned_messages). Max 50 pins per channel. ...

Discord Pinned Messages

Get all pinned messages in a Discord channel. Pinned messages are important reference messages marked by moderators or users. Read these first to unde...

Discord Post Message

Post a message to a Discord channel. Supports Discord markdown (**bold**, *italic*, `code`) and mentions (<@user_id>, <#channel_id>). Returns the crea...

Discord Reply To Message

Reply to a specific message in a Discord channel. Creates a reply that references the original message (shown with a quote preview). Use the message's...

Discord Search Messages

Search messages across a Discord guild. Filter by keyword (content), author, channel, message type (has: link/image/file), or pinned status. Returns m...

Discord Unpin Message

Unpin a message from a Discord channel. The message is not deleted, just removed from the pinned messages list. Call discord_pinned_messages to see cu...

Frequently Asked Questions

What is the Discord MCP server?

Discord MCP server for community and team communication. Read and post messages, reply to threads, react to messages, browse guilds and channels, and look up member profiles. It provides 14 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Discord to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/discord. Authentication is handled automatically.

How many tools does Discord provide?

Discord provides 14 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Discord require?

Discord uses One-click sign in. Discord requires credentials. Connect via MCPBundles and authentication is handled automatically.

What Discord data can agents use?

Agents can inspect guilds, channels, messages, thread channels, members, pins, reactions, and bot-managed messages available to the connected server.

Can agents post to Discord?

Yes, where the bot has permission. Prompts should be explicit about the target guild, channel, thread, and whether the agent should draft or actually post.

Does Discord support global message search here?

No. Work by reading known channels or threads. For research-style tasks, start by discovering channels, then fetch relevant message history.

What permissions matter most?

Viewing channels, reading message history, sending messages, managing messages, adding reactions, creating threads, and pinning messages all depend on the bot's server permissions.

Setup Instructions

Connect Discord to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/discord

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Discord and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Discord will appear under Not connected — select it and click Connect to complete OAuth.
Name: Discord
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/discord
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Discord?

Sign in to connect your credentials and start running tools from the chat.

Discord MCP Server & Skill — 14 Tools