MCP-Discord

Instructions

Implementation Reference

• src/tools/forum.ts:130-174 (handler)

  The core handler function implementing the discord_get_forum_post tool. Fetches a forum thread by ID, retrieves recent messages, and returns formatted details.
  export const getForumPostHandler: ToolHandler = async (args, { client }) => { const { threadId } = GetForumPostSchema.parse(args); try { if (!client.isReady()) { return { content: [{ type: 'text', text: 'Discord client not logged in.' }], isError: true, }; } const thread = await client.channels.fetch(threadId); if (!thread?.isThread()) { return { content: [ { type: 'text', text: `Cannot find thread with ID: ${threadId}` }, ], isError: true, }; } // Get messages from the thread const messages = await thread.messages.fetch({ limit: 10 }); const threadDetails = { id: thread.id, name: thread.name, parentId: thread.parentId, messageCount: messages.size, createdAt: thread.createdAt, messages: messages.map((msg) => ({ id: msg.id, content: msg.content, author: msg.author.tag, createdAt: msg.createdAt, })), }; return { content: [{ type: 'text', text: JSON.stringify(threadDetails, null, 2) }], }; } catch (error) { return handleDiscordError(error); } };
• src/tool-list.ts:95-104 (schema)

  The tool schema definition including name, description, and input schema (requires threadId) used for MCP tools/list response.
  { name: 'discord_get_forum_post', description: 'Retrieves details about a forum post including its messages', inputSchema: { type: 'object', properties: { threadId: { type: 'string' }, }, required: ['threadId'], },
• src/server.ts:123-126 (registration)

  Registration/dispatch of the tool handler in the main MCP server's call_tool request handler switch statement.
  case 'discord_get_forum_post': this.logClientState('before discord_get_forum_post handler'); toolResponse = await getForumPostHandler(args, this.toolContext); return toolResponse;
• src/transport.ts:325-327 (registration)

  Additional dispatch of the tool handler in the HTTP transport layer's method switch for legacy tool calls.
  case 'discord_get_forum_post': result = await getForumPostHandler(params, this.toolContext!); break;
• src/transport.ts:513-515 (registration)

  Dispatch of the tool handler in the HTTP transport layer for modern tools/call method format.
  case 'discord_get_forum_post': result = await getForumPostHandler(toolArgs, this.toolContext!); break;