Pokeapi Mcp Server

cyanheads/pokeapi-mcp-server

Connects to PokéAPI v2 and surfaces seven tools covering the full Pokémon data surface. The flagship tool is `pokeapi_get_pokemon`, which fans out across multiple endpoints in parallel and returns a denormalized dossier with stats, abilities, evolution chain, sprites, and optionally learnable moves. `pokeapi_get_type_matchups` computes offensive and defensive effectiveness with dual-type composition already handled. The other five tools cover moves, abilities, items, natures, and filtered Pokémon lookups by generation, type, or egg group. No API key needed, aggressive caching to respect fair-use limits, and all responses are English-first. Reach for this when you need structured game data for team building, damage calculations, or any agent workflow that references Pokémon mechanics.

GitHub stars: 1
tools: 7
transport: STDIO, HTTP
env vars: 7
last updated: Nov 11, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://pokeapi.caseyjhand.com/mcp --name pokeapi

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http pokeapi https://pokeapi.caseyjhand.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

pokeapi_get_pokemonGet a fully denormalized Pokémon dossier in a single call — base stats, types, abilities (with full English effect text), height/weight, resolved evolution chain, sprite URLs including official artwork, species flavor text, variety list, capture rate, growth rate, gender rate,...3 params

Get a fully denormalized Pokémon dossier in a single call — base stats, types, abilities (with full English effect text), height/weight, resolved evolution chain, sprite URLs including official artwork, species flavor text, variety list, capture rate, growth rate, gender rate,...

Parameters* required

game_versionstring

PokéAPI version name to filter flavor text (e.g. "sword", "red", "scarlet"). Falls back to the most recent English entry when the version is not found.

identifier*string

Pokémon name (lowercase hyphenated, e.g. "bulbasaur", "charizard-mega-x") or PokéAPI Pokémon-record ID as a string (e.g. "1", "10034"). A species name (e.g. "deoxys") resolves to its default variety.

include_movesboolean

Include the full learnable-move summary. Defaults to false because the list is large (100–200+ moves).default: false

pokeapi_get_type_matchupsGet the full offensive and defensive type effectiveness breakdown. Provide either a type name (e.g. "fire", "psychic") or a Pokémon identifier (name or PokéAPI Pokémon-record ID; a species name resolves to its default variety). For dual-type Pokémon, the defensive multipliers...2 params

Get the full offensive and defensive type effectiveness breakdown. Provide either a type name (e.g. "fire", "psychic") or a Pokémon identifier (name or PokéAPI Pokémon-record ID; a species name resolves to its default variety). For dual-type Pokémon, the defensive multipliers...

Parameters* required

pokemonstring

Pokémon name or PokéAPI Pokémon-record ID; a species name resolves to its default variety. The server resolves the types automatically. Provide this or type, not both.

typestring

Type name in lowercase (e.g. "fire", "water", "psychic"). Provide this or pokemon, not both.

pokeapi_get_moveGet move details by name or numeric ID — type, damage class, power, accuracy, PP, priority, target, stat changes, status-effect chance, and full English effect text. Set include_learners=true to include the list of Pokémon that can learn the move. Move names are available from...2 params

Get move details by name or numeric ID — type, damage class, power, accuracy, PP, priority, target, stat changes, status-effect chance, and full English effect text. Set include_learners=true to include the list of Pokémon that can learn the move. Move names are available from...

Parameters* required

identifier*string

Move name in lowercase hyphenated form (e.g. "flamethrower", "close-combat") or numeric ID as a string.

include_learnersboolean

Include the list of Pokémon that can learn this move. Defaults to false as the list can be large.default: false

pokeapi_get_abilityGet ability details by name or numeric ID — full English effect text, short effect text, generation introduced, and the list of Pokémon that have the ability (including hidden-ability flag and slot). Ability names are returned by pokeapi_get_pokemon in the abilities array.1 params

Get ability details by name or numeric ID — full English effect text, short effect text, generation introduced, and the list of Pokémon that have the ability (including hidden-ability flag and slot). Ability names are returned by pokeapi_get_pokemon in the abilities array.

Parameters* required

identifier*string

Ability name in lowercase hyphenated form (e.g. "overgrow", "speed-boost") or numeric ID as a string.

pokeapi_get_itemGet item details by name or numeric ID — effect text, category, versioned purchase and sell prices, fling power, item attributes (holdable, consumable, etc.), sprite URL, and Pokémon that commonly hold it.1 params

Get item details by name or numeric ID — effect text, category, versioned purchase and sell prices, fling power, item attributes (holdable, consumable, etc.), sprite URL, and Pokémon that commonly hold it.

Parameters* required

identifier*string

Item name in lowercase hyphenated form (e.g. "choice-specs", "leftovers") or numeric ID as a string.

pokeapi_get_natureGet nature details — the stat boosted (+10%), stat reduced (-10%), and preferred/disliked berry flavors. Omit the identifier to list all 25 natures at once. Natures are critical for competitive team-building: every non-neutral nature modifies two stats by ±10%.1 params

Get nature details — the stat boosted (+10%), stat reduced (-10%), and preferred/disliked berry flavors. Omit the identifier to list all 25 natures at once. Natures are critical for competitive team-building: every non-neutral nature modifies two stats by ±10%.

Parameters* required

identifierstring

Nature name (e.g. "modest", "jolly") or ID 1–25 as a string. Omit to list all 25 natures.

pokeapi_find_pokemonFilter Pokémon by generation, type, regional pokédex, or egg group. Returns names and PokéAPI IDs; every returned name works as a pokeapi_get_pokemon identifier, where a species name resolves to its default variety. At least one of generation, type, pokedex, or egg_group is re...7 params

Filter Pokémon by generation, type, regional pokédex, or egg group. Returns names and PokéAPI IDs; every returned name works as a pokeapi_get_pokemon identifier, where a species name resolves to its default variety. At least one of generation, type, pokedex, or egg_group is re...

Parameters* required

egg_groupstring

Egg group name (e.g. "monster", "fairy", "dragon"). Filters to Pokémon in this egg group.

generationstring

Generation name (e.g. "generation-i", "generation-iii"). Filters to Pokémon introduced in this generation.

limitinteger

Maximum results to return. Positive integer; defaults to 50.default: 50

offsetinteger

Offset into the filtered result set for pagination. Non-negative integer; defaults to 0.default: 0

pokedexstring

Regional pokédex name (e.g. "kanto", "hoenn", "galar"). Filters to entries in that dex.

querystring

Strict token match on name. "chu" matches "pikachu" and "raichu". Case-insensitive. At most 100 characters; whitespace separates tokens, and every token must match.

typestring

Type name (e.g. "fire", "psychic"). Filters to Pokémon of this type.