discord-mcp

Instructions

Implementation Reference

• src/tools/thread-tools.ts:9-56 (registration)

  Registration of the 'list_threads' tool, including description, input schema using Zod, and the complete inline handler function that fetches threads from a Discord channel using discord.js.
  server.tool( 'list_threads', 'List all threads in a channel', { guildId: z.string().describe('The ID of the server (guild)'), channelId: z.string().describe('The ID of the parent channel'), archived: z.boolean().optional().describe('Include archived threads (default false)'), }, async ({ guildId, channelId, archived = false }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const channel = await guild.channels.fetch(channelId); if (!channel || (channel.type !== ChannelType.GuildText && channel.type !== ChannelType.GuildAnnouncement && channel.type !== ChannelType.GuildForum)) { throw new Error('Channel does not support threads'); } const threadChannel = channel as TextChannel | NewsChannel | ForumChannel; const threads = archived ? await threadChannel.threads.fetchArchived() : await threadChannel.threads.fetchActive(); return threads.threads.map((thread) => ({ id: thread.id, name: thread.name, type: ChannelType[thread.type], parentId: thread.parentId, ownerId: thread.ownerId, archived: thread.archived, locked: thread.locked, autoArchiveDuration: thread.autoArchiveDuration, messageCount: thread.messageCount, memberCount: thread.memberCount, createdAt: thread.createdAt?.toISOString(), archiveTimestamp: thread.archiveTimestamp ? new Date(thread.archiveTimestamp).toISOString() : null, })); }); if (!result.success) { return { content: [{ type: 'text', text: result.error }], isError: true }; } return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] }; } );
• src/tools/thread-tools.ts:17-55 (handler)

  The core handler logic for list_threads: fetches guild and channel, validates channel type, fetches active or archived threads, maps to structured data, handles errors with withErrorHandling, and returns JSON stringified response.
  async ({ guildId, channelId, archived = false }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const channel = await guild.channels.fetch(channelId); if (!channel || (channel.type !== ChannelType.GuildText && channel.type !== ChannelType.GuildAnnouncement && channel.type !== ChannelType.GuildForum)) { throw new Error('Channel does not support threads'); } const threadChannel = channel as TextChannel | NewsChannel | ForumChannel; const threads = archived ? await threadChannel.threads.fetchArchived() : await threadChannel.threads.fetchActive(); return threads.threads.map((thread) => ({ id: thread.id, name: thread.name, type: ChannelType[thread.type], parentId: thread.parentId, ownerId: thread.ownerId, archived: thread.archived, locked: thread.locked, autoArchiveDuration: thread.autoArchiveDuration, messageCount: thread.messageCount, memberCount: thread.memberCount, createdAt: thread.createdAt?.toISOString(), archiveTimestamp: thread.archiveTimestamp ? new Date(thread.archiveTimestamp).toISOString() : null, })); }); if (!result.success) { return { content: [{ type: 'text', text: result.error }], isError: true }; } return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] }; }
• src/tools/thread-tools.ts:12-16 (schema)

  Input schema defined using Zod for parameters: guildId, channelId, and optional archived flag.
  { guildId: z.string().describe('The ID of the server (guild)'), channelId: z.string().describe('The ID of the parent channel'), archived: z.boolean().optional().describe('Include archived threads (default false)'), },
• src/index.ts:64-64 (registration)

  Invocation of registerThreadTools(server) in the MCP server creation, which registers the list_threads tool among other thread management tools.
  registerThreadTools(server);