discord-mcp-lite
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DISCORD_TOKEN | Yes | Bot token from the developer portal. Required. | |
| DISCORD_API_BASE | No | Override for tests, e.g. http://127.0.0.1:8787. Defaults to https://discord.com/api/v10. Optional. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Read-only Discord access. Typical flow: list_guilds -> list_channels -> read_messages. Message bodies require the Message Content intent to be enabled in the Discord developer portal.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_guildsA | List the Discord servers (guilds) this bot can see. Start here when you do not know any ids. |
| list_channelsA | List readable text, announcement, forum, and media channels in a guild. Threads are not included; use list_threads. |
| find_channelA | Find channels by name (case-insensitive substring). Searches every guild when guild_id is omitted. |
| read_messagesA | Read channel or thread messages, newest first by default. Paginates past 100 up to 1000 per call. Works on thread ids too; forum channels must be read through their threads (list_threads first). Read-only: this server cannot post. |
| list_threadsA | List a guild's active threads, plus archived public threads when channel_id is given. |
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 5 tools
Each tool targets a distinct operation: enumerate guilds, enumerate channels, name-search channels, list threads, read messages. The only mild overlap is list_channels vs find_channel, but descriptions make clear one enumerates a guild's channels while the other does cross-guild name lookup. Thread vs channel boundaries are explicitly spelled out.
All five tools follow a strict verb_noun snake_case pattern (list_guilds, list_channels, find_channel, read_messages, list_threads). Plural/singular nouns are used correctly, so signatures are predictable.
Five tools is a well-scoped surface for a deliberately read-only, 'lite' Discord reader. Each tool covers a necessary navigation step (guild -> channel/thread -> messages) with no filler.
The read path is fully covered end to end, including pagination and forum-via-thread handling, and read-only scope is stated so missing write tools aren't a gap. Minor gaps remain: no message search, no user/member lookup, and no way to fetch a message or channel by id directly.