discord-mcp-lite
Provides read-only access to a Discord bot's servers: lists guilds and their text, announcement, forum, and thread channels, finds channels by name across guilds, and reads paginated message history from channels and threads (up to 1000 messages per call, with before/since/oldest_first paging). Also lists active guild threads and archived public threads for a given channel, which is the way to read forum channels. No write or posting capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@discord-mcp-lite Summarize the last 100 messages in #general"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
discord-mcp-lite
A read-only Discord MCP server in a single file with zero dependencies. No clone-and-build: download server.mjs, set a bot token, point your MCP client at it.
server.mjs ~400 lines, Node >= 20, no npm packages
tests/ runs offline against a mock Discord APIWhy another Discord MCP server
Existing Discord MCP servers require git clone, npm install, and npm run build. This one is one file. It is also read-only by design: there is no post or delete tool, so an LLM mistake cannot send anything to anyone.
Related MCP server: Discord MCP
Requirements
Node.js 20 or newer
A Discord bot that is a member of the servers you want to read
1. Create the bot
Open https://discord.com/developers/applications and create an application.
In Bot, reset and copy the token. Treat it like a password.
In Bot, enable Message Content Intent. Without it, Discord sends empty message bodies and the server can only see who spoke, not what they said.
Invite the bot with the
botscope and these permissions: View Channels, Read Message History, and Send Messages is not needed:https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot&permissions=6656066560 = View Channels (1024) + Read Message History (65536).
2. Run it
node server.mjsIt speaks JSON-RPC over stdio and prints nothing else to stdout, so it is meant to be launched by an MCP client, not used in a terminal.
Published package (after the maintainer runs npm publish):
npx -y discord-mcp-lite3. Configure your MCP client
Qoder: Settings → MCP → Add, or your client's mcpServers JSON:
{
"mcpServers": {
"discord": {
"command": "node",
"args": ["C:/path/to/discord-mcp-lite/server.mjs"],
"env": {
"DISCORD_TOKEN": "your_bot_token_here"
}
}
}
}Or, with the npm package:
{
"mcpServers": {
"discord": {
"command": "npx",
"args": ["-y", "discord-mcp-lite"],
"env": { "DISCORD_TOKEN": "your_bot_token_here" }
}
}
}The token belongs in the MCP config or environment. Never in this repository, never in a chat message.
Tools
Tool | Arguments | What it does |
| none | Servers the bot can see. Start here. |
|
| Text, announcement, forum, and thread channels with ids. |
|
| Case-insensitive name search across all guilds. |
|
| Paginated message history for a channel or thread. |
|
| Active threads; the first 100 archived public threads when a channel is given. |
Typical prompts this enables:
"Summarize the last 500 messages in #general on the BetterGov server."
"What has been discussed about taxes since 2026-11-01?"
"Find the channel about tax and list its most recent threads."
read_messages returns messages in chronological order with Oldest id and Newest id in the footer, so the model can page further back by passing before.
Forum channels are read through their threads: call list_threads with the forum's channel_id, then read_messages with a thread id. Discord rejects read_messages on a forum channel id itself.
Protocol versions 2024-11-05, 2025-03-26, and 2025-06-18 are supported; any other requested version falls back to 2024-11-05.
Environment
Variable | Required | Meaning |
| yes | Bot token from the developer portal. |
| no | Override for tests, e.g. |
What it cannot do
Post messages. There is no send tool in this version.
Search Discord globally. Discord does not expose message search to bots over the REST API.
Read forum channels directly. Read their threads instead (see above).
Read channels the bot cannot see. Permissions are enforced by Discord, not by this server.
Read DMs. Not implemented.
Security model
Read-only tool surface; no write endpoints are called anywhere in
server.mjs.The token is read from the environment once at startup and sent only to the Discord API base.
Error messages contain HTTP status and response body from Discord, never the token.
Rate limits (HTTP 429) are honoured using Discord's
retry_after, with bounded retries.
Development
node --test tests/server.test.mjsThe suite spawns the server, speaks JSON-RPC to it, and points it at a local mock of the Discord API. It needs no token and no network access.
Publishing (maintainer)
The name discord-mcp-lite was unclaimed on npm as of 2026-11-19. To publish:
npm publish --dry-run
npm publishLicense
MIT
Available Tools
5 toolsfind_channelARead-only
Find channels by name (case-insensitive substring). Searches every guild when guild_id is omitted.
Inputs: query (required), guild_id.
list_channelsARead-only
List readable text, announcement, forum, and media channels in a guild. Threads are not included; use list_threads.
Inputs: guild_id (required).
list_guildsARead-only
List the Discord servers (guilds) this bot can see. Start here when you do not know any ids.
Inputs: no named parameters.
list_threadsARead-only
List a guild's active threads, plus archived public threads when channel_id is given.
Inputs: guild_id (required), channel_id.
read_messagesARead-only
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.
Inputs: channel_id (required), limit, since, before, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Read-only MCP server for interior design studios: projects, overviews, weekly activity. No writes.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Free, read-only MCP server to search and compare AI tools for making video games. No API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA read-only Discord MCP server that allows AI agents to list channels, read messages, and get attachment images from a Discord server for summarization and reporting.-
- FlicenseAqualityDmaintenanceLocal, read-only MCP server that connects to Discord via REST API, allowing listing guilds, channels, and messages with strict access controls and no write operations.5-

cordslite-mcpofficial
FlicenseAqualityCmaintenanceProvides read-only Discord access, enabling listing guilds, mapping channels, reading and searching messages, following threads, and viewing attachments without posting.121-- AlicenseNot gradedqualityBmaintenanceEnables authorized MCP clients to perform five read-only operations — checking connection status, listing conversations, reading messages, searching, and polling for changes — over selected Discord server channels and DMs, with scope-based authentication, retention limits, and no ability to send messages or moderate.1MIT