kick_member
Remove a member from a Discord server by specifying the server and member IDs, with an optional reason for the action.
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)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);