MCP-Discord

// Discord API error handler for MCP tools import type { ToolResponse } from './tools/types.js'; /** * A unified error handler for Discord API errors * @param error - The error object from Discord API calls * @param clientId - Optional Discord Client ID for custom invite links * @returns A standard tool response with error message and potential solution */ export function handleDiscordError( // biome-ignore lint/suspicious/noExplicitAny: <> error: any, clientId?: string ): ToolResponse { // Ensure error is in the expected format for checking const errorMessage = typeof error === 'string' ? error : error?.message || String(error); const errorCode = error?.code; // Generate invite link based on client ID if provided const inviteLink = clientId ? `https://discord.com/oauth2/authorize?client_id=${clientId}&scope=bot&permissions=8` : 'https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=52076489808'; // Check for privileged intents errors if ( errorMessage.includes( 'Privileged intent provided is not enabled or whitelisted' ) ) { return { content: [ { type: 'text', text: `Error: Privileged intents are not enabled. Solution: Please enable the required intents (Message Content, Server Members, Presence) in the Discord Developer Portal for your bot application. For detailed instructions, check the Prerequisites section in our README.`, }, ], isError: true, }; } // Check for unauthorized/bot not in server errors if ( errorCode === 50_001 || // Missing Access errorCode === 10_004 || // Unknown Guild errorMessage.includes('Missing Access') || errorMessage.includes('Unknown Guild') || errorMessage.includes('Missing Permissions') ) { return { content: [ { type: 'text', text: `Error: The bot is not a member of the target Discord server or lacks required permissions. Solution: Please add the bot to the target server using this Discord invite link: ${inviteLink} According to Discord's security model, a bot can only access information from servers it has been explicitly added to.`, }, ], isError: true, }; } // Check for rate limiting if (errorCode === 429 || errorMessage.includes('rate limit')) { return { content: [ { type: 'text', text: `Error: Discord API rate limit reached. Solution: Please wait a moment before trying again. If this persists, consider spacing out your requests.`, }, ], isError: true, }; } // General error response for other cases return { content: [ { type: 'text', text: `Discord API Error: ${errorMessage}`, }, ], isError: true, }; }