discord-mcp

Instructions

Implementation Reference

• src/tools/member-tools.ts:153-173 (handler)

  Handler function for kick_member tool. Fetches the Discord guild and member, verifies the member is kickable, executes member.kick(reason), and returns a success message or error.

  async ({ guildId, memberId, reason }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const member = await guild.members.fetch(memberId);
  
      if (!member.kickable) {
        throw new Error('Cannot kick this member: insufficient permissions or role hierarchy');
      }
  
      const username = member.user.username;
      await member.kick(reason);
      return { memberId, username, message: 'Member kicked 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:148-152 (schema)

  Zod input schema defining parameters for the kick_member tool: required guildId and memberId, optional reason.

  {
    guildId: z.string().describe('The ID of the server (guild)'),
    memberId: z.string().describe('The ID of the member to kick'),
    reason: z.string().optional().describe('Reason for the kick'),
  },

• src/tools/member-tools.ts:145-174 (registration)

  Registration of the kick_member tool via server.tool() call within registerMemberTools function, including name, description, schema, and handler.

  server.tool(
    'kick_member',
    'Kick a member from the server',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      memberId: z.string().describe('The ID of the member to kick'),
      reason: z.string().optional().describe('Reason for the kick'),
    },
    async ({ guildId, memberId, reason }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const member = await guild.members.fetch(memberId);
  
        if (!member.kickable) {
          throw new Error('Cannot kick this member: insufficient permissions or role hierarchy');
        }
  
        const username = member.user.username;
        await member.kick(reason);
        return { memberId, username, message: 'Member kicked 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 registration call to registerMemberTools(server) which includes the kick_member tool among other member management tools.

  registerMemberTools(server);