get_member_info
Retrieve detailed Discord member information by providing server and user IDs to access roles, permissions, and activity data.
Instructions
Get detailed information about a specific member
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guildId | Yes | The ID of the server (guild) | |
| memberId | Yes | The ID of the member (user ID) |
Implementation Reference
- src/tools/member-tools.ts:49-92 (handler)The main handler function for the 'get_member_info' tool. It fetches detailed information about a Discord member using the Discord client, handles errors with withErrorHandling, and returns formatted JSON data.async ({ guildId, memberId }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const member = await guild.members.fetch(memberId); return { id: member.id, username: member.user.username, displayName: member.displayName, nickname: member.nickname, discriminator: member.user.discriminator, joinedAt: member.joinedAt?.toISOString(), premiumSince: member.premiumSince?.toISOString(), communicationDisabledUntil: member.communicationDisabledUntil?.toISOString(), pending: member.pending, isBot: member.user.bot, avatar: member.displayAvatarURL(), banner: member.user.bannerURL(), roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name, color: r.hexColor, position: r.position, })), permissions: member.permissions.toArray(), highestRole: { id: member.roles.highest.id, name: member.roles.highest.name, }, isOwner: member.id === guild.ownerId, manageable: member.manageable, kickable: member.kickable, bannable: member.bannable, moderatable: member.moderatable, }; }); 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:45-48 (schema)Zod schema defining the input parameters for the get_member_info tool: guildId (string) and memberId (string).{ guildId: z.string().describe('The ID of the server (guild)'), memberId: z.string().describe('The ID of the member (user ID)'), },
- src/tools/member-tools.ts:42-93 (registration)Registration of the 'get_member_info' tool on the MCP server using server.tool(), including name, description, input schema, and handler function.server.tool( 'get_member_info', 'Get detailed information about a specific member', { guildId: z.string().describe('The ID of the server (guild)'), memberId: z.string().describe('The ID of the member (user ID)'), }, async ({ guildId, memberId }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const member = await guild.members.fetch(memberId); return { id: member.id, username: member.user.username, displayName: member.displayName, nickname: member.nickname, discriminator: member.user.discriminator, joinedAt: member.joinedAt?.toISOString(), premiumSince: member.premiumSince?.toISOString(), communicationDisabledUntil: member.communicationDisabledUntil?.toISOString(), pending: member.pending, isBot: member.user.bot, avatar: member.displayAvatarURL(), banner: member.user.bannerURL(), roles: member.roles.cache.map((r) => ({ id: r.id, name: r.name, color: r.hexColor, position: r.position, })), permissions: member.permissions.toArray(), highestRole: { id: member.roles.highest.id, name: member.roles.highest.name, }, isOwner: member.id === guild.ownerId, manageable: member.manageable, kickable: member.kickable, bannable: member.bannable, moderatable: member.moderatable, }; }); 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)Invocation of registerMemberTools which registers the get_member_info tool among others.registerMemberTools(server);