Skip to main content
Glama
cordslite-mcp

cordslite-mcp

Official
by AnswerDotAI

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

  1. 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 bot scope and the "Read Messages/View Channels" and "Read Message History" permissions, then open it to invite the bot to your server.

  2. Open cordslite-mcp.mcpb in 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 the Authorization header the Discord web app sends, visible in the browser's developer tools. Claude Desktop installs Python and the dependencies itself through uv.

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 pack

mcpb pack writes cordslite-mcp.mcpb in the project directory.

Available Tools

12 tools
channel_messagesB

The latest messages in a channel or thread, oldest first

Inputs: channel_id (required), after, limit, before.

dm_messagesA

The latest messages in a DM or group DM, oldest first; needs the user token

Inputs: channel_id (required), after, limit, before.

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_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

    A3.5/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Local, 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
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      1
      MIT