cordslite-mcp
OfficialClick 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., "@cordslite-mcp show me the latest 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.
cordslite-mcp
Read-only Discord access for Claude Desktop. The extension serves cordslite through an MCP server built with mcpmini, packed as an MCPB bundle. Claude can list the servers a bot has joined, map their channels, read and search messages, follow threads, and view image and text attachments. It cannot post, edit, or delete anything.
Install
Create a bot in the Discord Developer Portal: create an application, add a bot under "Bot", and copy its token. Under "OAuth2", generate an invite URL with the
botscope and the "Read Messages/View Channels" and "Read Message History" permissions, then open it to invite the bot to your server.Open
cordslite-mcp.mcpbin Claude Desktop. It asks for the bot token, and optionally a default server id and your own account token. The account token unlocks the three DM tools. Discord's terms forbid automating a user account, so leave it empty unless you accept that; the token is theAuthorizationheader the Discord web app sends, visible in the browser's developer tools. Claude Desktop installs Python and the dependencies itself throughuv.
Related MCP server: Discord MCP
Tools
list_guilds: the servers the bot has joined, with their ids.guild_tree: a map of a server: categories, channels with their ids and topics, and members.guild_channels: the channels of a server, with ids, types, parent categories, and topics.channel_messages: the latest messages in a channel or thread, oldest first.guild_search: search a server's messages across all channels and threads, with author, channel, content type, and date filters.channel_search: search one channel's or thread's messages.message_context: the messages around one message.find_member: the user id of a server member, by username or nickname.fetch_attachment: an attachment's contents. Images come back as images, text files as text. Other types, and files above 8 MB, come back as metadata only.list_dms: the account's DMs and group DMs with their channel ids. Needs the user token.dm_messages: the latest messages in a DM or group DM, oldest first. Needs the user token.dm_search: search a DM or group DM. Needs the user token.
Message lines carry the timestamp, author, url, content, and any attachments as [attachment: name (type, size) url].
Development
src/cordslite_mcp.py holds the tools. Its module docstring is the guidance the server sends to the model, and each function's docments become the tool schema.
uv sync
DISCORD_BOT_TOKEN=... uv run mcpmini src/cordslite_mcp.py
npx @anthropic-ai/mcpb validate manifest.json
npx @anthropic-ai/mcpb packmcpb pack writes cordslite-mcp.mcpb in the project directory.
Available Tools
12 toolschannel_messagesB
The latest messages in a channel or thread, oldest first
Inputs: channel_id (required), after, limit, before.
channel_searchB
Search one channel's or thread's messages, newest first
Inputs: channel_id (required), has, after, limit, +3 more.
dm_messagesA
The latest messages in a DM or group DM, oldest first; needs the user token
Inputs: channel_id (required), after, limit, before.
dm_searchB
Search a DM or group DM, newest first; needs the user token
Inputs: channel_id (required), has, after, limit, +3 more.
fetch_attachmentB
An attachment's contents: an image as an image, a text file as text, anything else as its metadata
Inputs: url (required).
find_memberA
The user id of the first server member matching name, for author_id searches
Inputs: name (required), guild_id.
guild_channelsB
The channels of a server, one per line, with ids, types (0 text, 2 voice, 4 category), parent categories, and topics
Inputs: guild_id.
guild_searchA
Search a server's messages across all channels and threads, newest first
Inputs: has, after, limit, before, +4 more.
guild_treeB
A map of a server: categories, channels with their ids and topics, and members
Inputs: guild_id, include_members.
list_dmsA
The account's open DMs and group DMs with their channel ids; needs the user token
Inputs: limit.
list_guildsB
The servers the bot has joined, with their ids
Inputs: no named parameters.
message_contextB
The messages around one message, oldest first
Inputs: channel_id (required), message_id (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools target clearly distinct actions: listing servers, mapping a server, reading messages, searching, fetching attachments, and resolving members. The only mild overlap is between guild_tree and guild_channels, since both describe a server's structure, but their output purposes differ enough to avoid serious confusion.
The naming is readable and mostly thematic, with search tools consistently suffixed as *_search and list tools prefixed as list_*. However, it mixes styles: verb_noun (find_member, fetch_attachment), noun_noun (channel_messages, message_context, guild_tree), and noun_verb (guild_search). The pattern is not chaotic, but it is not consistently applied.
Twelve tools is a reasonable size for a Discord-focused server. Each tool covers a distinct need such as discovery, navigation, message retrieval, search, member lookup, attachment access, and DM support, without feeling padded or redundant.
The toolset provides strong read-side coverage of Discord: guilds, channels, categories, threads, messages, DMs, members, attachments, and search. The main gap is that it is entirely read-only, so sending messages or modifying Discord resources is not possible, but for a search/retrieval-oriented MCP server this is likely acceptable.
Maintenance
Related MCP Connectors
Read-only access to your CodeMouse accounts, repositories, and AI pull-request reviews.
Read-only access to your Citlyze workspace: AI search visibility, citations, and recommendations.
Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only).
Read-only access to your Infrly services, deploys, logs, metrics and billing.
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-
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to read Discord channels, recent messages, and searchable history, then turn that evidence into freshness-aware team context, briefs, decision baselines, and signed checkpoint diffs through remote MCP and GPT Actions. It keeps Discord access read-only while supporting OAuth/Bearer authentication for multiple clients.Apache 2.0
- 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