discord-mcp

Instructions

Implementation Reference

• src/tools/member-tools.ts:186-207 (handler)

  Handler function that executes the ban_member tool: fetches the guild, prepares ban options, calls guild.members.ban(), handles errors with withErrorHandling, and returns JSON response.

    async ({ guildId, userId, deleteMessageSeconds, reason }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
  
        const banOptions: { deleteMessageSeconds?: number; reason?: string } = {};
        if (deleteMessageSeconds !== undefined) {
          banOptions.deleteMessageSeconds = Math.min(Math.max(0, deleteMessageSeconds), 604800);
        }
        if (reason) banOptions.reason = reason;
  
        await guild.members.ban(userId, banOptions);
        return { userId, message: 'User banned 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/member-tools.ts:180-185 (schema)

  Zod input schema defining parameters for the ban_member tool: guildId (required), userId (required), deleteMessageSeconds (optional number), reason (optional string).

  {
    guildId: z.string().describe('The ID of the server (guild)'),
    userId: z.string().describe('The ID of the user to ban'),
    deleteMessageSeconds: z.number().optional().describe('Number of seconds of messages to delete (0-604800)'),
    reason: z.string().optional().describe('Reason for the ban'),
  },

• src/tools/member-tools.ts:177-207 (registration)

  Registration of the ban_member tool using server.tool() with name, description, input schema, and handler function.

  server.tool(
    'ban_member',
    'Ban a member from the server',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      userId: z.string().describe('The ID of the user to ban'),
      deleteMessageSeconds: z.number().optional().describe('Number of seconds of messages to delete (0-604800)'),
      reason: z.string().optional().describe('Reason for the ban'),
    },
    async ({ guildId, userId, deleteMessageSeconds, reason }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
  
        const banOptions: { deleteMessageSeconds?: number; reason?: string } = {};
        if (deleteMessageSeconds !== undefined) {
          banOptions.deleteMessageSeconds = Math.min(Math.max(0, deleteMessageSeconds), 604800);
        }
        if (reason) banOptions.reason = reason;
  
        await guild.members.ban(userId, banOptions);
        return { userId, message: 'User banned 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:56-56 (registration)

  Top-level call to registerMemberTools(server) in createMcpServer(), which includes registration of ban_member.

  registerMemberTools(server);