discord-mcp

Toolsets

A toolset is a group of tools you switch on together. Tick the ones your assistant needs and copy the line: the server then loads only those, and fewer tools leave more of its context for your conversation. The server has 100 tools in 14 toolsets, counted from its own tools/list.

Start from a README profile

  • Discovery

    discovery ~1.2k tokens

    Find servers and channels, and the IDs most other tools need.

    4 tools: 4 read-only

  • Messages

    messages ~9.2k tokens

    Read, search, send, edit, react to, pin, forward and delete messages, and manage threads.

    21 tools: 7 read-only, 11 write, 3 destructive

  • Channels

    channels ~1.9k tokens

    Create, edit, move, clone, follow and delete channels.

    8 tools: 7 write, 1 destructiveNo read-only tool

  • Permissions

    permissions ~1.9k tokens

    Inspect, set, copy and reset channel permission overwrites.

    6 tools: 2 read-only, 2 write, 2 destructive

  • Members

    members ~3.6k tokens

    List and search members, set nicknames, and kick, ban, time out or prune.

    11 tools: 4 read-only, 3 write, 4 destructive

  • Roles

    roles ~2.4k tokens

    Create, edit, assign, order and delete roles.

    9 tools: 2 read-only, 6 write, 1 destructive

  • Moderation

    moderation ~431 tokens

    Read the audit log.

    1 tool: 1 read-only

  • Screening

    screening ~685 tokens

    Read and update the membership screening form.

    2 tools: 1 read-only, 1 write

  • Stats

    stats ~426 tokens

    A snapshot of server metrics.

    1 tool: 1 read-only

  • Forums

    forums ~3.3k tokens

    Forum channels, posts, replies and tags.

    10 tools: 4 read-only, 4 write, 2 destructive

  • Webhooks

    webhooks ~3.0k tokens

    Create webhooks and post, edit or delete messages through them.

    8 tools: 2 read-only, 4 write, 2 destructive

  • Scheduled events

    scheduled_events ~3.0k tokens

    Create and manage events, see who is interested, and invite people to them.

    7 tools: 3 read-only, 3 write, 1 destructive

  • Invites

    invites ~1.7k tokens

    List, inspect, create and revoke invites.

    5 tools: 3 read-only, 1 write, 1 destructive

  • Direct messages

    dm ~2.4k tokens

    Send, read, edit and delete direct messages.

    7 tools: 1 read-only, 5 write, 1 destructive

Read-only mode

Set DISCORD_MCP_READ_ONLY=true to keep only the 35 tools annotated readOnlyHint: true. Your assistant can then look, never change anything. The mode works inside your toolset line: it removes tools from the toolsets you picked, and never adds a toolset.

So a toolset with no read-only tool drops out entirely. Channels is such a toolset: every one of its 8 tools changes something. To list or find channels, Discovery has the read-only tools discord_list_channels (read-only) and discord_find_channel_by_name (read-only).

If nothing read-only is left in your selection, as with DISCORD_MCP_TOOLSETS=channels alone, the server stops at startup rather than start with no tool.

~35.1k tokens100 tools in 14 toolsets

See the line