# pokeapi-mcp-server

pokeapi-mcp-server is an MCP server for Claude Code that queries Pokémon data through PokéAPI v2. It supports agent tasks involving game information and type-effectiveness calculations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1621 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/pokeapi-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pokeapi-mcp-server

## What it does

The server gives an agent tools to find Pokémon and filter results by generation, type, Pokédex, or egg group. A Pokémon profile combines stats, types, abilities, evolution data, and sprites. Separate lookups cover moves, items, abilities, and natures, while another tool calculates offensive and defensive type interactions.

In Claude Code, add the server over HTTP with `claude mcp add --transport http pokeapi-mcp-server https://pokeapi-mcp-server--cyanheads.run.tools`. Pokémon can be identified by name or numeric record ID. Species names resolve to their default variety, so a lookup for `deoxys` returns `deoxys-normal`; account for that when you need a particular form.

## Requirements
- Remote server: `https://pokeapi-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http pokeapi-mcp-server https://pokeapi-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add pokeapi-mcp-server --url https://pokeapi-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pokeapi-mcp-server": {
            "url": "https://pokeapi-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pokeapi-mcp-server": {
            "type": "http",
            "url": "https://pokeapi-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http pokeapi-mcp-server https://pokeapi-mcp-server--cyanheads.run.tools
```

## When to use it
- find Pokémon by generation, type, or egg group
- retrieve a Pokémon profile with stats and evolution data
- compare defensive matchups for a dual-type Pokémon
- look up an ability or item’s effect
- check a move’s attributes and its possible learners

## Example prompts
- Find Water-type Pokémon from the second generation.
- Compare the defensive weaknesses of `deoxys` and tell me which form was resolved.
- Show the power, accuracy, and effect of the move `surf`.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
