# pokeapi-mcp-server [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/cyanheads/pokeapi-mcp-server  
**GitHub Stars:** 1  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pokeapi-mcp-server-2

## Description
Look up Pokémon, moves, abilities, items, natures, and type matchups from PokéAPI v2.

## Tools
Capabilities this server exposes over MCP:

- **pokeapi_get_pokemon** — Denormalized Pokémon dossier in one call — stats, types, abilities, evolution chain, sprites, and species data
- **pokeapi_get_type_matchups** — Computed offensive and defensive type effectiveness for a type or Pokémon, with correctly composed dual-type matchups
- **pokeapi_get_move** — Move details — type, damage class, power, accuracy, PP, priority, stat changes, and effect text
- **pokeapi_get_ability** — Ability details — effect text and the Pokémon that have it, with hidden-ability flag and slot
- **pokeapi_get_item** — Item details — effect text, category, versioned prices, fling power, attributes, and common holders
- **pokeapi_get_nature** — Nature details — stat boost/penalty and berry flavor preferences; lists all 25 when called without an identifier
- **pokeapi_find_pokemon** — Filter Pokémon by generation, type, pokédex, or egg group, with name-token matching and pagination

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What pokeapi-mcp-server MCP server does

The pokeapi-mcp-server MCP server connects MCP clients to PokéAPI v2 and presents structured, read-only game data for the 🎮 Gaming category. Its seven tools cover Pokémon, moves, abilities, items, natures, type relationships, and filtered Pokémon searches. Two MCP resources provide Pokémon dossiers and raw type damage relations.

`pokeapi_get_pokemon` combines stats, types, abilities, evolution data, sprites, species details, varieties, and other profile fields into one response. Move summaries can be added when requested. Species names resolve to their default varieties, and lookups accept lowercase-hyphenated names or numeric PokéAPI record IDs.

## Tools and capabilities

- Retrieve move properties such as type, damage class, power, accuracy, PP, priority, stat changes, and English effect text.
- Inspect ability effects and the Pokémon that have an ability, including hidden-ability status and slot information.
- Examine item categories, effects, attributes, prices by version and currency, fling power, sprites, and common holders.
- Get nature stat changes and berry flavor preferences, or request all 25 natures at once.
- Calculate offensive and defensive type effectiveness for a type or Pokémon. Dual-type defensive multipliers are composed, with immunities taking precedence.
- Filter Pokémon with generation, type, Pokédex, or egg-group criteria. Filters use AND logic, while name-token matching and limit/offset pagination narrow the results.

The `pokeapi://pokemon/{identifier}` resource returns a Pokémon dossier without moves. The `pokeapi://type/{typeName}` resource returns raw offensive and defensive multiplier tables for one of the 18 canonical types. Resource data is also available through tools.

## How it works

The pokeapi-mcp-server MCP server consolidates related PokéAPI records for Pokémon requests, including data from Pokémon, species, evolution-chain, and ability endpoints. The result is a single dossier rather than separate responses that an agent must join. Optional parameters control expanded responses, such as move inclusion, learner lists, game-version flavor text, or a selected nature.

Search results provide PokéAPI IDs and names for follow-up detail requests. Type-only searches can include forms, while generation, Pokédex, and egg-group searches return species. Invalid identifiers produce `not_found`; unsupported filter categories produce `invalid_filter`. Empty searches do not return entries because at least one category filter is required.

## Setup and configuration

The server supports STDIO and Streamable HTTP transports. The repository provides installation paths for Claude Desktop, Cursor, and VS Code, and publishes the package as `@cyanheads/pokeapi-mcp-server`. A public hosted MCP endpoint is available at `https://pokeapi.caseyjhand.com/mcp`.

No API key, authentication, or runtime configuration is required for the keyless read-only PokéAPI use case. The implementation is built on `@cyanheads/mcp-ts-core`; its documented framework capabilities include optional authentication modes, storage backends, structured logging, and OpenTelemetry tracing.

## Limitations and notes

The pokeapi-mcp-server MCP server reads from PokéAPI and does not provide write operations. Pokémon, move, ability, item, and resource identifiers must resolve to PokéAPI records. `pokeapi_find_pokemon` requires at least one category filter, and a page beyond the available matches keeps the total count while advising a reset to offset zero. Game-version text falls back to the most recent English entry when the requested version does not provide one.

_Full upstream README: https://allmcps.com/mcp/pokeapi-mcp-server-2/readme_