random-pokemon-from-region
Generate a random Pokémon from a specified region like Kanto, Johto, or Hoenn using a dedicated tool that fetches data from the PokeAPI for easy discovery.
Instructions
Get a random Pokémon from a specific region
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | Yes | The Pokémon region (e.g., kanto, johto, hoenn, etc.) |
Implementation Reference
- src/index.ts:152-234 (handler)Main handler function that implements the logic to retrieve and format a random Pokémon from the specified region using PokeAPI data.
async function getRandomPokemonFromRegion( region: string ): Promise<PokemonResponse> { const normalizedRegion = region.toLowerCase(); const generation = REGION_TO_GENERATION[normalizedRegion]; if (!generation) { return { content: [ { type: "text", text: `Unknown region: ${region}. Available regions are: ${Object.keys( REGION_TO_GENERATION ).join(", ")}`, }, ], }; } // Get all Pokémon from this generation const generationData = await fetchFromPokeAPI<GenerationData>( `/generation/${generation}` ); if ( !generationData || !generationData.pokemon_species || generationData.pokemon_species.length === 0 ) { return { content: [ { type: "text", text: `Failed to retrieve Pokémon from the ${normalizedRegion} region.`, }, ], }; } // Select a random Pokémon const randomPokemon = getRandomItem(generationData.pokemon_species); // Get detailed information about this Pokémon const details = await getPokemonDetails(randomPokemon.name); if (!details) { return { content: [ { type: "text", text: `Failed to retrieve details for the selected Pokémon from ${normalizedRegion}.`, }, ], }; } // Add region information to the response const types = formatPokemonTypes(details.pokemon.types); const abilities = formatPokemonAbilities(details.pokemon.abilities); const flavorText = getEnglishFlavorText(details.species); return { content: [ { type: "text", text: ` # Random ${capitalizeFirstLetter( normalizedRegion )} Pokémon: ${capitalizeFirstLetter(details.pokemon.name)} (#${ details.pokemon.id }) **Types:** ${types} **Height:** ${details.pokemon.height / 10}m **Weight:** ${details.pokemon.weight / 10}kg **Abilities:** ${abilities} **Description:** ${flavorText} `.trim(), }, ], }; } - src/index.ts:327-338 (registration)Registration of the 'random-pokemon-from-region' tool with the MCP server, including input schema and handler reference.
server.tool( "random-pokemon-from-region", "Get a random Pokémon from a specific region", { region: z .string() .describe("The Pokémon region (e.g., kanto, johto, hoenn, etc.)"), }, async ({ region }, _extra) => { return await getRandomPokemonFromRegion(region); } ); - src/index.ts:330-334 (schema)Zod input schema defining the 'region' parameter for the tool.
{ region: z .string() .describe("The Pokémon region (e.g., kanto, johto, hoenn, etc.)"), }, - src/index.ts:20-30 (helper)Mapping of region names to Pokémon generations used by the handler.
const REGION_TO_GENERATION: Record<string, number> = { kanto: 1, johto: 2, hoenn: 3, sinnoh: 4, unova: 5, kalos: 6, alola: 7, galar: 8, paldea: 9, };