list_members
Retrieve member lists from Discord servers to manage community data, fetching up to 1000 members per request.
Instructions
List members in a Discord server (fetches up to 1000 members)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guildId | Yes | The ID of the server (guild) | |
| limit | No | Maximum number of members to fetch (default: 100, max: 1000) |
Implementation Reference
- src/tools/member-tools.ts:15-38 (handler)The handler function that implements the core logic of the list_members tool. It fetches guild members using the Discord client, limits the fetch, maps to a formatted structure including id, username, displayName, etc., handles errors with withErrorHandling, and returns JSON string.async ({ guildId, limit = 100 }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const members = await guild.members.fetch({ limit: Math.min(limit, 1000) }); return members.map((member) => ({ id: member.id, username: member.user.username, displayName: member.displayName, nickname: member.nickname, joinedAt: member.joinedAt?.toISOString(), roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name })), isBot: member.user.bot, avatar: member.displayAvatarURL(), })); }); 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:12-14 (schema)Input schema for the list_members tool defined using Zod. Requires guildId (string), optional limit (number).guildId: z.string().describe('The ID of the server (guild)'), limit: z.number().optional().describe('Maximum number of members to fetch (default: 100, max: 1000)'), },
- src/tools/member-tools.ts:9-39 (registration)Registration of the list_members tool on the MCP server, including name, description, input schema, and handler function.'list_members', 'List members in a Discord server (fetches up to 1000 members)', { guildId: z.string().describe('The ID of the server (guild)'), limit: z.number().optional().describe('Maximum number of members to fetch (default: 100, max: 1000)'), }, async ({ guildId, limit = 100 }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const members = await guild.members.fetch({ limit: Math.min(limit, 1000) }); return members.map((member) => ({ id: member.id, username: member.user.username, displayName: member.displayName, nickname: member.nickname, joinedAt: member.joinedAt?.toISOString(), roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name })), isBot: member.user.bot, avatar: member.displayAvatarURL(), })); }); 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)High-level registration call to registerMemberTools function, which includes the list_members tool registration.registerMemberTools(server);