pokeapi-mcp-server

An MCP server wrapping the PokéAPI. Provides tools to look up Pokémon, moves, abilities, items, locations, evolutions, and more — directly from Claude or any MCP-compatible client.

Features

• Full coverage of the PokéAPI — Pokémon, species, moves, abilities, items, types, locations, evolutions, berries, natures, and more

• Fuzzy name matching with autocorrect — misspell a name and the server will either fix it automatically or suggest the closest matches

• Paginated results for large lists (egg groups, growth rates, pokédexes, etc.)

Related MCP server: PokeMCP

Tools

Each resource has two tools: a list_* tool for pagination and a get_* tool for full details.

get_pokemon accepts an optional move_learn_method parameter (level-up, machine, egg, tutor, or all) to filter the moves list.

Installation

npm install
npm run build

Running the server

The server speaks the MCP Streamable HTTP transport. Start it and point an MCP client at the HTTP endpoint.

npm start                              # http://127.0.0.1:3000/mcp
PORT=4000 npm start                    # custom port
HOST=0.0.0.0 npm start                 # bind all interfaces (intended for fronting behind another service)
ALLOWED_HOSTS=mcp.example.com npm start  # restrict Host header when not on localhost

All requests go to POST /mcp. GET and DELETE return 405.

Usage with Claude Code

Add to your MCP client config:

{
  "mcpServers": {
    "pokeapi": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3000/mcp"
    }
  }
}

Exact keys vary by client — consult your MCP client's docs for its HTTP transport config syntax.

Development

npm run dev   # run with tsx (no build step)
npm run build # compile TypeScript
npm start     # run compiled output

Data source

All data is fetched live from pokeapi.co. No API key required.