kick_member
Remove a member from a Discord server by specifying server and member IDs. Provide a reason for the kick to maintain server moderation records.
Instructions
Kick a member from the server
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guildId | Yes | The ID of the server (guild) | |
| memberId | Yes | The ID of the member to kick | |
| reason | No | Reason for the kick |
Implementation Reference
- src/tools/member-tools.ts:153-173 (handler)The handler function for the 'kick_member' tool. Fetches the Discord guild and member using the provided IDs, checks if the member is kickable, kicks the member with an optional reason, and returns a JSON-formatted success response 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: guildId (required string), memberId (required string), reason (optional string).{ 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:144-174 (registration)Registers the 'kick_member' tool on the MCP server within the registerMemberTools function, including name, description, input schema, and inline handler implementation.// Kick a member 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:55-55 (registration)Calls registerMemberTools to register all member-related tools, including 'kick_member', on the main MCP server instance.registerMemberTools(server);