Skip to main content

Discord MCP

Automate community workflows in Discord with read/search, posting, and moderation tools.

Authentication​

  • Header: Authorization

  • Format: Bearer mad_live_***

  • Discord connector credentials are configured in Integrations.

  • Respect server moderation policies before automating writes.

Catalog Coverage​

  • Raw provider tools: 52
  • Exposed compatibility tools: 52
  • Agent-ready tools: 46
  • Documented descriptors: 52
  • Public reference pages: 49
  • Source repository: https://github.com/MADPANDA3D/DISCORD-MCP
  • Catalog version: discord-2026.07.12.3
  • Catalog verified: 2026-07-12T20:23:20.897873+00:00 (5 days old)
  • Guide verified: not manually verified (not verified)
  • Committed snapshot: catalog-5ec40de147b11c40
  • Docs generated: 2026-07-18T00:19:58.776Z

Read-only Tools​

  • Analyze Discord Image Attachment — Use this when you need OCR or visual analysis of an attached image. Do not use it for non-images or when vision is not configured. This reads the attachment and sends it to the configured OpenAI vision endpoint through Discord's API and returns attachment metadata and extracted or described text. It requires a configured Discord bot and guild with the relevant permissions.
  • Audit One Discord Channel Day — Use this when you need a categorized summary of one channel day. This reads bounded channel history without changing state through Discord's API and returns audit totals, classifications, samples, date bounds, and warnings. It requires a configured Discord bot and guild with the relevant permissions.
  • Check Discord MCP Configuration — Use this when you need to know whether this request has required provider setup. This checks safe configuration presence and policy flags through Discord's API and returns readiness, missing field names, capability flags, and warnings without credential values. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Check Discord Provider Health — Use this when you need a live permission and readiness check for the configured guild. This reads bot, guild, channel, permission, and rate-limit state through Discord's API and returns a red/yellow/green report, safe configuration flags, warnings, and capabilities. It requires a configured Discord bot and guild with the relevant permissions.
  • Find Discord Category — Use this when you need a category ID from its name. This searches guild categories without changing state through Discord's API and returns matching category IDs, names, positions, and guild ID. It requires a configured Discord bot and guild with the relevant permissions.
  • Find Discord Channel — Use this when you need a channel ID from a name. This searches readable guild channels without changing state through Discord's API and returns matching IDs, names, types, and category context. It requires a configured Discord bot and guild with the relevant permissions.
  • Find Discord Tools — Use this when you need ranked tools for a multi-word task or alias. This searches the deterministic catalog in memory through Discord's API and returns compact ranked matches with risk, category, tier, and next action. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Find Discord User ID by Name — Use this when you need a member snowflake from a username or display name. This searches guild members without changing state through Discord's API and returns matching IDs, usernames, display names, and match quality. It requires a configured Discord bot and guild with the relevant permissions.
  • Get Discord Daily Audit Status — Use this when you need progress or accumulated results for a daily audit. This reads an in-memory audit record without contacting Discord through Discord's API and returns cursor, status, completed counts, timing, and optional results. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Get Discord Endpoint Coverage — Use this when you need to understand covered and excluded Discord API areas. This reads the maintained coverage matrix from memory through Discord's API and returns official links, coverage state, tools, configuration, and gap reasons. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Get Discord Server Information — Use this when you need identity and high-level statistics for the configured server. This reads guild metadata without changing state through Discord's API and returns guild identity, owner, creation date, channel/member counts, and boost status. It requires a configured Discord bot and guild with the relevant permissions.
  • Get Discord Tool Usage — Use this when you need the lossless descriptor for one tool. This reads one canonical descriptor from memory through Discord's API and returns complete parameters, output, risk, confirmation, and follow-up guidance. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Get Legacy Discord Job Status — Use this when you need status or an optional result for discord_job_submit. This reads the in-memory legacy job record without changing Discord through Discord's API and returns job status, timing, action, and an optional result or error. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • List Discord Category Channels — Use this when you need readable children of one category. This reads category membership without changing state through Discord's API and returns category ID plus channel IDs, names, types, and count. It requires a configured Discord bot and guild with the relevant permissions.
  • List Discord Channels — Use this when you need the readable channel inventory. This reads guild channels without changing state through Discord's API and returns channel IDs, names, types, positions, and category context. It requires a configured Discord bot and guild with the relevant permissions.
  • List Discord MCP Capabilities — Use this when you need capability groups, counts, or the lossless ToolManifest. This reads the provider-owned catalog from memory through Discord's API and returns catalog identity, counts, categories, and optionally every descriptor. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • List Discord Threads — Use this when you need active and optionally archived threads under a channel. This reads thread metadata without changing state through Discord's API and returns thread IDs, names, archive state, parent channel, and counts. It requires a configured Discord bot and guild with the relevant permissions.
  • Read Discord Direct Messages — Use this when you need recent DM history and DM access is enabled. This reads direct-message history without changing state through Discord's API and returns recipient/channel IDs and recent message records. It requires a configured Discord bot and guild with the relevant permissions.
  • Read Messages — Read channel history slices for context and moderation triage.
  • Search Messages — Find messages by query, author, and date ranges.

Write and Destructive Tools​

  • Add Discord Member Role — Use this when an authorized operator must grant a configured role. This adds one role after hierarchy checks through Discord's API and returns member ID, role ID, and reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Add Discord Reaction — Use this when you need the bot to react to an existing message. This adds one emoji reaction through Discord's API and returns channel/message IDs and the applied emoji. It requires a configured Discord bot and guild with the relevant permissions.
  • Archive Discord Thread — Use this when you need to close an active thread while preserving history. This changes a thread to archived state through Discord's API and returns thread ID, name, and archived state. It requires a configured Discord bot and guild with the relevant permissions.
  • Ban Discord Member — Use this when an authorized moderator must prohibit a user from joining. This bans the member and can delete bounded recent messages through Discord's API and returns banned member ID, deleted-message days, and reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Create Discord Category — Use this when you need a new category to organize channels. This creates a channel category through Discord's API and returns new category ID, name, and guild ID. It requires a configured Discord bot and guild with the relevant permissions.
  • Create Discord Text Channel — Use this when you need a new text channel in the guild or category. This creates a guild text channel through Discord's API and returns new channel ID, name, guild ID, and category ID. It requires a configured Discord bot and guild with the relevant permissions.
  • Create Discord Thread — Use this when you need to start a thread from an existing message. This creates a thread under the specified channel and message through Discord's API and returns the new thread ID, name, parent channel, and archive duration. It requires a configured Discord bot and guild with the relevant permissions.
  • Delete Discord Category — Use this when you need to remove a category after handling child channels. This deletes the category object through Discord's API and returns deleted category ID, name, and guild ID. It requires a configured Discord bot and guild with the relevant permissions.
  • Delete Discord Channel — Use this when you need to permanently remove a channel. This deletes the guild channel through Discord's API and returns deleted channel ID, name, and guild ID. It requires a configured Discord bot and guild with the relevant permissions.
  • Delete Discord Direct Message — Use this when you need to permanently remove a bot-authored direct message. This deletes an existing direct message through Discord's API and returns recipient/channel/deleted-message IDs. It requires a configured Discord bot and guild with the relevant permissions.
  • Delete Discord Message — Use this when you need to permanently remove an existing message. This deletes a message after admin and confirmation checks through Discord's API and returns deleted message/channel IDs or a dry-run plan. It requires a configured Discord bot and guild with the relevant permissions.
  • Delete Discord Webhook — Use this when you need to permanently remove a known webhook by ID. This deletes the webhook through Discord's API and returns deleted webhook ID and name. It requires a configured Discord bot and guild with the relevant permissions.
  • Edit Discord Direct Message — Use this when you need to replace a bot-authored direct message. This overwrites an existing direct message through Discord's API and returns recipient/channel/message IDs, content, and jump URL. It requires a configured Discord bot and guild with the relevant permissions.
  • Edit Discord Member Nickname — Use this when an authorized operator must set or clear a nickname. This overwrites the guild nickname after hierarchy checks through Discord's API and returns member ID, resulting nickname, and reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Edit Discord Message — Use this when you need to replace an existing message's content. This overwrites a message after admin and confirmation checks through Discord's API and returns message/channel IDs, updated content, jump URL, or a dry-run plan. It requires a configured Discord bot and guild with the relevant permissions.
  • Kick Discord Member — Use this when an authorized moderator must remove a member without banning re-entry. This removes the member after hierarchy checks through Discord's API and returns kicked member ID and reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Process Next Discord Audit Channel — Use this when you need to advance a resumable audit by one channel. This reads one channel and advances the in-memory cursor through Discord's API and returns the processed audit, updated cursor, progress, and task status. It requires a configured Discord bot and guild with the relevant permissions.
  • Remove Discord Member Role — Use this when an authorized operator must revoke a configured role. This removes one role after hierarchy checks through Discord's API and returns member ID, role ID, and reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Remove Discord Member Timeout — Use this when an authorized moderator must restore a timed-out member. This clears the member timeout after hierarchy checks through Discord's API and returns member ID and moderation reason. It requires a configured Discord bot and guild with the relevant permissions.
  • Remove Discord Reaction — Use this when you need to remove the bot's reaction from a message. This removes one emoji reaction through Discord's API and returns channel/message IDs and the removed emoji. It requires a configured Discord bot and guild with the relevant permissions.
  • Run Discord Write Smoke Test — Use this when an operator needs an end-to-end write diagnostic. Do not use it for routine health checks because it changes state. This may send, edit, read back, and delete a test message through Discord's API and returns step-by-step health, write, read-back, and cleanup evidence. It requires a configured Discord bot and guild with the relevant permissions.
  • Send Discord Acknowledgement — Use this when you need to post a short standardized acknowledgement in an allowed channel. This creates one guild message through Discord's API and returns the channel ID, created message ID, and jump URL. It requires a configured Discord bot and guild with the relevant permissions.
  • Send Discord Direct Message — Use this when you need to send a private message and DM access is enabled. Do not use it for guild channels; use send_message. This creates one direct message through Discord's API and returns recipient/channel/message IDs and jump URL. It requires a configured Discord bot and guild with the relevant permissions.
  • Send Message — Post messages or embeds to channels and threads.
  • Start Discord Daily Audit Job — Use this when you need a resumable audit across multiple channels. This creates an in-memory audit cursor without changing Discord through Discord's API and returns task ID, channel totals, date, timezone, and status. It requires an authenticated MAD MCP Portal request, but does not contact Discord.
  • Submit Legacy Discord Job — Use this when a legacy automation must run a supported action asynchronously. Do not use it when a typed direct tool is available. This queues behavior selected through a generic action field through Discord's API and returns a task ID, queued status, and selected action. It requires a configured Discord bot and guild with the relevant permissions.
  • Timeout Member — Apply a timed moderation timeout to a member.
  • Unarchive Discord Thread — Use this when you need to reopen an archived thread. This changes a thread to active state through Discord's API and returns thread ID, name, and archived state. It requires a configured Discord bot and guild with the relevant permissions.
  • Unban Discord User — Use this when an authorized moderator must allow a banned user to rejoin. This removes a guild ban through Discord's API and returns unbanned user ID and reason. It requires a configured Discord bot and guild with the relevant permissions.