discord-mcp

Instructions

Implementation Reference

• src/tools/thread-tools.ts:280-301 (handler)

  Handler function that fetches the Discord guild and thread, validates the thread, calls thread.join() to make the bot join, and returns a formatted response or error.

    async ({ guildId, threadId }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const thread = await guild.channels.fetch(threadId);
  
        if (!thread || !thread.isThread()) {
          throw new Error('Thread not found');
        }
  
        await thread.join();
  
        return { threadId, threadName: thread.name, message: 'Joined thread successfully' };
      });
  
      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:277-279 (schema)

  Zod input schema defining required string parameters: guildId and threadId.

    guildId: z.string().describe('The ID of the server (guild)'),
    threadId: z.string().describe('The ID of the thread'),
  },

• src/tools/thread-tools.ts:274-301 (registration)

  Registration of the 'join_thread' tool on the MCP server using server.tool(), including name, description, schema, and inline handler.

    'join_thread',
    'Make the bot join a thread',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      threadId: z.string().describe('The ID of the thread'),
    },
    async ({ guildId, threadId }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const thread = await guild.channels.fetch(threadId);
  
        if (!thread || !thread.isThread()) {
          throw new Error('Thread not found');
        }
  
        await thread.join();
  
        return { threadId, threadName: thread.name, message: 'Joined thread successfully' };
      });
  
      if (!result.success) {
        return { content: [{ type: 'text', text: result.error }], isError: true };
      }
  
      return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
    }
  );

• src/index.ts:64-64 (registration)

  Call to registerThreadTools on the main MCP server instance in the application entry point, which includes the join_thread tool registration.

  registerThreadTools(server);