List Discord servers
TL;DR
About
Searching a server's messages or listing its channels starts from its guildId, and Discord only gives those out one server at a time, as the first number after /channels/ in a channel's URL or through Copy Server ID once Developer Mode is on. Reading the sidebar gets you all of them in one go, each server's name next to its guildId. Say a Paper plugin author sits in 70 Discord servers, most of them Minecraft communities, and asks Claude where people reported a crash with the plugin this week. Claude lists the servers, picks out the eight plugin-support ones by name, and runs search_messages on each guildId, since that search covers one server per call. You get names and IDs only, no icons, member counts or roles. Only the account signed in to that browser is covered, and a second open Discord tab can make the run stop with an error, so queue Discord jobs one after another.
Input
None
Output
count requiredTotal advertised by Discord (aria-setsize on the sidebar).
servers requiredServers in sidebar order.
Example output
Shape only: placeholder values generated from the output schema, not a real run.
{
"count": 3,
"servers": [
{
"name": "Example",
"guildId": "abc123"
}
]
}FAQ
Search Discord server messages
Search one Discord server's message history with Discord's own search, as the signed-in account, newest first. Search by words (content), and narrow by authors, channels, mentioned users and content type, each given as ids: get user ids from discord.com/get_member_list and channel ids from discord.com/list_channels. Returns one page of up to 25 matching messages with their author, text, time and link, Discord's total count of matches, and next_offset to read the next page (null on the last one). Fails with a clear error when the browser is not signed in to Discord, when the account is not a member of the server or can see no text channel in it, or when Discord is still indexing the server. Direct messages are not searched.
Read Discord messages
Reads the most recent messages of a Discord channel or direct message (author, timestamp, text), newest first, scrolling up to load more until the requested count. Requires being logged in. A DM or group DM is read the same way: pass its url from discord.com/list_dms. It also reads a thread or a forum post, since both are channels in their own right: pass the post's url (from discord.com/list_forum_posts) and you get its replies plus the opening post, newest first — there is no separate thread-reading script. To list the posts of a forum channel rather than its messages, use discord.com/list_forum_posts instead.
Post a Discord message
Posts a text message, optionally with a file attached, in a Discord channel addressed by its URL. Requires being logged in to Discord. Returns `sent` plus the created message's messageId, channelId, timestamp and content as Discord stored it. The message is visible to everyone who can see the channel. Empty messages and messages over 2000 characters are refused with a clear reason. Use dry_run to check a channel and message without posting.