ban_member
Remove disruptive users from a Discord server by banning members with options to delete recent messages and specify reasons for moderation actions.
Instructions
Ban a member from the server
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guildId | Yes | The ID of the server (guild) | |
| userId | Yes | The ID of the user to ban | |
| deleteMessageSeconds | No | Number of seconds of messages to delete (0-604800) | |
| reason | No | Reason for the ban |
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);