discord-mcp

Instructions

Implementation Reference

• src/tools/event-tools.ts:247-278 (handler)

  Complete implementation of the 'get_event_subscribers' MCP tool, including registration, input schema using Zod, and handler logic that fetches Discord scheduled event subscribers using event.fetchSubscribers() with error handling.

  server.tool(
    'get_event_subscribers',
    'Get users subscribed to a scheduled event',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      eventId: z.string().describe('The ID of the event'),
      limit: z.number().optional().describe('Max users to fetch (default 100)'),
    },
    async ({ guildId, eventId, limit = 100 }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const event = await guild.scheduledEvents.fetch(eventId);
        const subscribers = await event.fetchSubscribers({ limit, withMember: true });
  
        return subscribers.map((sub) => ({
          id: sub.user.id,
          username: sub.user.username,
          member: sub.member ? {
            nickname: sub.member.nickname,
            joinedAt: sub.member.joinedAt?.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/index.ts:63-63 (registration)

  Main server initialization calls registerEventTools(server), which registers all event management tools including 'get_event_subscribers'.

  registerEventTools(server);

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

  Imports the registerEventTools function used to register the event tools module containing 'get_event_subscribers'.

  import { registerEventTools } from './tools/event-tools.js';