discord-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DISCORD_BOT_TOKEN | Yes | Bot token for Discord authentication. Without it, every tool call returns an auth_error. | |
| DISCORD_MCP_TIMEOUT_S | No | Per-request timeout in seconds. | 10.0 |
| DISCORD_MCP_ENABLE_WRITE | No | Set to '1', 'true', 'yes', or 'on' to enable the seven write tools (e.g., create_channel, delete_channel). Default is off. | unset |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_channelsA | List all channels (every type, including categories and voice channels) in a Discord guild. |
| list_rolesB | List all roles in a Discord guild. |
| list_categoriesA | List only the category channels (Discord channel type 4) in a guild -- filtered client-side, since Discord has no dedicated categories-only endpoint. |
| get_channel_permission_overwritesA | Get the permission overwrites (role/member allow+deny bitfields) set on a single channel. |
| get_member_rolesA | Get the role ids currently assigned to one guild member. |
| create_channelA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Create a channel (text/voice/category -- any Discord-valid |
| edit_channelA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Rename/re-topic/re-parent/reorder an existing channel. Only the fields explicitly passed are changed. |
| create_roleB | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Create a role in a guild. |
| edit_roleA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Edit an existing role. Only the fields explicitly passed are changed. |
| edit_guildA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Update guild-level identity (name/icon/banner/description). icon_base64/banner_base64 are base64-encoded image bytes (assumed PNG unless already a full |
| delete_channelA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Delete a channel. Genuinely destructive and irreversible against a real guild -- gated behind the exact same write gate as every other write tool, no separate/lower bar. |
| create_messageA | [WRITE, gated behind DISCORD_MCP_ENABLE_WRITE=1] Post a message to a text channel. content must be a non-empty string of at most 2000 characters (Discord's real message content limit). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools target distinct resources and actions, but list_channels and list_categories overlap as the latter is a filtered subset of the former. get_member_roles and list_roles could also be mildly confused, though descriptions clarify scope.
Consistent verb_noun pattern: list_* for collections, get_* for specific sub-resources, create_/edit_/delete_ for mutations. All snake_case with predictable naming.
12 tools is a well-scoped set for a Discord guild management server, fitting the 3-15 range.
Core channel lifecycle is covered (list/create/edit/delete) plus role create/edit, but delete_role is missing and there's no way to assign roles to members or edit permission overwrites, creating notable gaps.