discord-mcp

Instructions

Implementation Reference

• src/tools/emoji-tools.ts:153-184 (registration)

  Registration of the 'list_stickers' MCP tool, including description, input schema (guildId), and complete handler function that lists custom stickers from a Discord guild.

  server.tool(
    'list_stickers',
    'List all custom stickers in a server',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
    },
    async ({ guildId }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const stickers = await guild.stickers.fetch();
  
        return stickers.map((sticker) => ({
          id: sticker.id,
          name: sticker.name,
          description: sticker.description,
          tags: sticker.tags,
          format: sticker.format,
          available: sticker.available,
          guildId: sticker.guildId,
          user: sticker.user ? { id: sticker.user.id, username: sticker.user.username } : null,
          url: sticker.url,
        }));
      });
  
      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:60-60 (registration)

  Top-level registration call that invokes registerEmojiTools to add the 'list_stickers' tool (among others) to the main MCP server instance.

  registerEmojiTools(server);

• src/tools/emoji-tools.ts:159-183 (handler)

  The handler function executing the 'list_stickers' tool logic: fetches Discord client, retrieves guild stickers, maps to formatted objects, handles errors with withErrorHandling, and returns JSON string.

  async ({ guildId }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const stickers = await guild.stickers.fetch();
  
      return stickers.map((sticker) => ({
        id: sticker.id,
        name: sticker.name,
        description: sticker.description,
        tags: sticker.tags,
        format: sticker.format,
        available: sticker.available,
        guildId: sticker.guildId,
        user: sticker.user ? { id: sticker.user.id, username: sticker.user.username } : null,
        url: sticker.url,
      }));
    });
  
    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/emoji-tools.ts:156-158 (schema)

  Input schema for 'list_stickers' tool using Zod: requires guildId as string.

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