using-discord-mcp
Use when working with the Discord MCP server, choosing the right tool, or deciding whether the bot's current read-only permissions allow an action or require your human partner to widen them.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- using-discord-mcp
- license
- MIT
- metadata
- { "owner": "Harley Bartles", "status": "active", "use_when": [ "you need to read Discord messages, list servers/channels, search messages, or download attachments through the `discord` MCP server.", "you are unsure which Discord MCP tool to call.", "a task may require write, manage, or moderation privileges and you need to check whether the bot is allowed to run it." ], "source-id": "using-discord-mcp", "source-path": "skills/using-discord-mcp/SKILL.md", "do_not_use_when": [ "the bot has not been granted the required Discord permissions for a write/moderation action.", "another more specific skill owns the task." ], "provenance-name": "Using Discord MCP first-party skill", "source-category": "first_party" }
- description
- Use when working with the Discord MCP server, choosing the right tool, or deciding whether the bot's current read-only permissions allow an action or require your human partner to widen them.
02 资源文件 4
- 参考文档agents/openai.yaml516 B
- 资产文件assets/icon.svg1.7 KB
- 参考文档references/authed-tool-map.md7.0 KB
- 参考文档references/tool-map.md37.1 KB
03 SKILL.md 正文
Using Discord MCP
Use this skill to pick the right discord MCP tool and to stay inside the bot's current read-only scope.
Runtime availability
Inspect the tools exposed in the current runtime before calling this server. The consuming repository does not need a Discord plugin subscription. If the required Discord tool is absent, report the missing capability and do not imply that a repository configuration can make an unavailable runtime tool callable.
Server context
- MCP server name:
discord - Package:
@rayenking/discord-mcp@1.0.2 - Default server (guild) ID:
<your-guild-id> - Current permissions: View Channels, Read Message History, Message Content Intent, Server Members Intent, Presence Intent.
- The bot is not an admin. It cannot send messages, manage messages/channels/roles, kick/ban, create invites, or perform any other write or moderation action unless your human partner explicitly widens its permissions.
Fast rules
- Read is safe; write is not. If a tool only inspects data, the bot can run it. If a tool creates, updates, deletes, sends, or manages anything, stop and ask your human partner to add the Discord permission first.
- Use IDs, not names. Discord tools accept snowflake IDs (
guild_id,channel_id,message_id). Usediscord_list_channelsordiscord_find_channel_by_nameto resolve a channel name to an ID. - The default
guild_idis<your-guild-id>. Use it for any tool that requiresguild_idunless your human partner gives you a different one.
Router
| Intent | Read first |
|---|---|
| Normal reading, listing, searching, or downloading attachments | references/authed-tool-map.md |
| A tool not in the authed map, or any write/moderation/server-management task | references/tool-map.md |
| You are unsure whether the bot has permission | Ask your human partner before calling the tool. |
Reading pattern
- If you do not already have a
channel_id, usediscord_list_channelsordiscord_find_channel_by_namewithguild_id<your-guild-id>. - Call
discord_read_messageswithchannel_idand a smalllimit. - For each message, inspect
attachments[].url. If a message contains an image or file, calldiscord_download_attachmentwith that URL to save it locally.
Widening permission
If a task requires a non-authed tool, explain to your human partner exactly which Discord permission is needed and why, then wait for confirmation before calling the tool. Do not attempt a write call with the bot's current permissions.
04 同仓库更多 Skills
writing
Use when drafting, revising, or reviewing prose for human readers and clarity, an authorised voice, or reader-fatigue concerns may interact.
writing-with-clarity
Use when drafting, revising, or reviewing prose intended for human readers, including documentation, README files, reports, explanations, UI copy, errors, comments, commit messages, and pull request text.
writing-style
Use when revising or reviewing human-facing prose against an authorised voice card or a contextual reader-fatigue profile.
skill
暂无简介
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
writing-roadmaps
Use when a goal is too large for one writing-plans plan and requires a sequenced roadmap of consecutive plans.