discord-mcp

Instructions

Implementation Reference

• src/tools/member-tools.ts:15-38 (handler)

  The handler function that executes the list_members tool: fetches up to 1000 members from the specified Discord guild using the Discord client, maps member data to a structured format including ID, username, display name, nickname, join date, roles, bot status, and avatar, handles errors, and returns the JSON-formatted list.

  async ({ guildId, limit = 100 }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const members = await guild.members.fetch({ limit: Math.min(limit, 1000) });
  
      return members.map((member) => ({
        id: member.id,
        username: member.user.username,
        displayName: member.displayName,
        nickname: member.nickname,
        joinedAt: member.joinedAt?.toISOString(),
        roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name })),
        isBot: member.user.bot,
        avatar: member.displayAvatarURL(),
      }));
    });
  
    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/member-tools.ts:11-14 (schema)

  Zod input schema defining parameters for the list_members tool: required guildId (string) and optional limit (number, default 100).

  {
    guildId: z.string().describe('The ID of the server (guild)'),
    limit: z.number().optional().describe('Maximum number of members to fetch (default: 100, max: 1000)'),
  },

• src/tools/member-tools.ts:8-39 (registration)

  Registration of the list_members tool via server.tool(), including name, description, input schema, and inline handler function.

  server.tool(
    'list_members',
    'List members in a Discord server (fetches up to 1000 members)',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      limit: z.number().optional().describe('Maximum number of members to fetch (default: 100, max: 1000)'),
    },
    async ({ guildId, limit = 100 }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const members = await guild.members.fetch({ limit: Math.min(limit, 1000) });
  
        return members.map((member) => ({
          id: member.id,
          username: member.user.username,
          displayName: member.displayName,
          nickname: member.nickname,
          joinedAt: member.joinedAt?.toISOString(),
          roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name })),
          isBot: member.user.bot,
          avatar: member.displayAvatarURL(),
        }));
      });
  
      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:13-56 (registration)

  Top-level import (line 13) and invocation (line 56) of registerMemberTools(server), which registers the list_members tool (and other member tools) with the MCP server.

  import { registerMemberTools } from './tools/member-tools.js';
  import { registerRoleTools } from './tools/role-tools.js';
  import { registerPermissionTools } from './tools/permission-tools.js';
  import { registerMessageTools } from './tools/message-tools.js';
  import { registerEmojiTools } from './tools/emoji-tools.js';
  import { registerWebhookTools } from './tools/webhook-tools.js';
  import { registerInviteTools } from './tools/invite-tools.js';
  import { registerEventTools } from './tools/event-tools.js';
  import { registerThreadTools } from './tools/thread-tools.js';
  import { registerAuditTools } from './tools/audit-tools.js';
  import { registerDiscordPrompts } from './prompts/discord-prompts.js';
  
  /**
   * Discord MCP Server
   *
   * This MCP server provides comprehensive tools for managing Discord servers.
   * It requires the DISCORD_BOT_TOKEN environment variable to be set.
   *
   * Available tool categories:
   * - Server Management: list_servers, get_server_info, modify_server
   * - Channel Management: list_channels, get_channel_info, create_channel, delete_channel, modify_channel
   * - Member Management: list_members, get_member_info, modify_member, kick_member, ban_member, unban_member, list_bans
   * - Role Management: list_roles, get_role_info, create_role, delete_role, modify_role, assign_role, remove_role
   * - Permission Management: get_channel_permissions, set_channel_permission, delete_channel_permission, list_permissions, sync_channel_permissions
   * - Message Management: send_message, get_messages, edit_message, delete_message, bulk_delete_messages, pin/unpin, reactions
   * - Emoji & Sticker Management: list_emojis, create_emoji, delete_emoji, modify_emoji, sticker operations
   * - Webhook Management: list_channel_webhooks, list_guild_webhooks, create_webhook, delete_webhook, modify_webhook, send_webhook_message
   * - Invite Management: list_invites, get_invite_info, create_invite, delete_invite
   * - Event Management: list_events, get_event_info, create_event, modify_event, delete_event, get_event_subscribers
   * - Thread Management: list_threads, create_thread, create_forum_post, modify_thread, delete_thread, join/leave, member management
   * - Audit & Moderation: get_audit_logs, list_audit_log_types, list_automod_rules, get_automod_rule, delete_automod_rule, toggle_automod_rule
   */
  
  // Create a configured MCP server instance
  function createMcpServer(): McpServer {
    const server = new McpServer({
      name: 'discord-mcp',
      version: '1.1.0',
    });
  
    // Register all tool categories
    registerServerTools(server);
    registerChannelTools(server);
    registerMemberTools(server);