# io.github.cyanheads/pokeapi-mcp-server (remote · pokeapi.caseyjhand.com)

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

- Trust score: 73/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `pokeapi.caseyjhand.com`: 73/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi.md), [page](https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi)
- npm · `@cyanheads/pokeapi-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/cyanheads-pokeapi-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/cyanheads-pokeapi-mcp-server)

## Channel facts

- Endpoint: `https://pokeapi.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.7`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 7 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 88/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1709 tokens (~63/item across 27 items; 7 tools + 20 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-pokeapi-mcp-server https://pokeapi.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-pokeapi-mcp-server]
url = "https://pokeapi.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-pokeapi-mcp-server": {
      "type": "remote",
      "url": "https://pokeapi.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-pokeapi-mcp-server --url https://pokeapi.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-pokeapi-mcp-server:
    url: "https://pokeapi.caseyjhand.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-pokeapi-mcp-server": {
      "type": "http",
      "url": "https://pokeapi.caseyjhand.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 72, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 71, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 69, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 69)

First indexed and scored.

## MCP tools (7)

### `pokeapi_get_pokemon` (~320 tokens)

Get Pokémon

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, legendary/mythical flags, egg groups, and (optionally) a summarized learnable-move list. Accepts a name (lowercase, hyphens for spaces, e.g. "bulbasaur", "mr-mime") or Pokédex number. Set include_moves=true to include the move summary (large); defaults to false. Use game_version to select flavor text from a specific game (e.g. "sword", "red"); falls back to the most recent English entry when the version is not found. Use pokeapi_find_pokemon to discover Pokémon by type, generation, or egg group before calling this tool.

Input parameters:

- `game_version` (string): 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, required): Pokémon name (lowercase hyphenated, e.g. "bulbasaur", "mr-mime") or Pokédex number as a string (e.g. "1", "25").
- `include_moves` (boolean): Include the full learnable-move summary. Defaults to false because the list is large (100–200+ moves).

Output parameters:

- `abilities` (array): Abilities with full effect text.
- `captureRate` (number): Base capture rate (0–255).
- `eggGroups` (array): Egg group names.
- `evolutionChain`: Evolution tree rooted at the base species.
- `genderRate` (number): Gender ratio: -1 genderless, 0 always male, 8 always female, 1–7 fraction (eighths) female.
- `generation` (string): Generation introduced (e.g. "generation-i").
- `genus`: English genus (e.g. "Seed Pokémon"). Null when unavailable.
- `growthRate` (string): Growth rate name (e.g. "medium-slow").
- `heightDm` (number): Height in decimetres.
- `id` (number): National Pokédex number.
- `isLegendary` (boolean): True for legendary Pokémon.
- `isMythical` (boolean): True for mythical Pokémon.
- `moveCount` (number): Total number of learnable moves regardless of include_moves.
- `moves` (array): Learnable moves (populated when include_moves=true, empty otherwise).
- `name` (string): Canonical Pokémon name in hyphenated lowercase.
- `speciesFlavorText`: Flavor text from the selected (or most recent) game version. Null when none available.
- `sprites` (object): Sprite URLs.
- `stats` (array): Base stats.
- `types` (array): Type names ordered by slot (e.g. ["fire", "flying"]).
- `varieties` (array): All forms and variants of this species.
- `weightHg` (number): Weight in hectograms.

### `pokeapi_get_type_matchups` (~152 tokens)

Get Type Matchups

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 dex number). For dual-type Pokémon, the defensive multipliers are correctly composed (e.g. Fire/Flying vs Rock = 4× because both types are weak to Rock). Exactly one of type or pokemon must be provided.

Input parameters:

- `pokemon` (string): Pokémon name or Pokédex number. The server resolves the types automatically. Provide this or type, not both.
- `type` (string): Type name in lowercase (e.g. "fire", "water", "psychic"). Provide this or pokemon, not both.

Output parameters:

- `composedMultipliers` (object): Multiplier (0, 0.25, 0.5, 1, 2, 4) for every attacking type touched by at least one of the resolved defending type(s), including net-neutral 1× entries where a dual type composes to a cancellation (e…
- `defensiveMatchups` (object): Defensive matchups — composed correctly for dual-type Pokémon.
- `offensiveRelations`: Offensive effectiveness (populated for single-type queries; null for dual-type Pokémon where per-type breakdown does not compose cleanly).
- `queryType` (string): How the query was resolved: "type" for a direct type query, "pokemon" for a Pokémon lookup.
- `resolvedTypes` (array): The type name(s) the query resolved to.

### `pokeapi_get_move` (~147 tokens)

Get Move

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 pokeapi_get_pokemon when include_moves=true.

Input parameters:

- `identifier` (string, required): Move name in lowercase hyphenated form (e.g. "flamethrower", "close-combat") or numeric ID as a string.
- `include_learners` (boolean): Include the list of Pokémon that can learn this move. Defaults to false as the list can be large.

Output parameters:

- `accuracy`: Accuracy percentage (0–100). Null for moves that always hit.
- `damageClass`: Damage class: physical, special, or status. Null when unavailable.
- `effectChance`: Secondary effect chance percentage. Null when not applicable.
- `effectText`: Full English effect description. Null when unavailable.
- `id` (number): Move ID.
- `learnedByPokemon` (array): Pokémon names that can learn this move (populated when include_learners=true).
- `name` (string): Move name in hyphenated lowercase.
- `power`: Base power. Null for status moves.
- `pp`: Base PP. Null when unavailable.
- `priority` (number): Priority bracket (positive = higher priority, negative = lower).
- `shortEffectText`: Short English effect summary. Null when unavailable.
- `statChanges` (array): Stat stage changes caused by this move.
- `target` (string): Target selection (e.g. "selected-pokemon", "all-opponents").
- `type` (string): Elemental type (e.g. "fire").

### `pokeapi_get_ability` (~99 tokens)

Get Ability

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.

Input parameters:

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

Output parameters:

- `effectText`: Full English effect description. Null when unavailable.
- `generation` (string): Generation in which the ability was introduced.
- `id` (number): Ability ID.
- `name` (string): Ability name in hyphenated lowercase.
- `pokemon` (array): Pokémon that have this ability.
- `shortEffectText`: Short English effect summary. Null when unavailable.

### `pokeapi_get_item` (~86 tokens)

Get Item

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

Input parameters:

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

Output parameters:

- `attributes` (array): Item attributes (e.g. "holdable", "consumable", "usable-in-battle").
- `category` (string): Item category (e.g. "held-items", "medicine").
- `cost` (number): Purchase cost in Pokédollars. 0 means not sold in shops.
- `effectText`: Full English effect description. Null when unavailable.
- `flingPower`: Fling move base power when this item is flung. Null if not throwable.
- `heldByPokemon` (array): Pokémon that commonly hold this item in the wild.
- `id` (number): Item ID.
- `name` (string): Item name in hyphenated lowercase.
- `shortEffectText`: Short English effect summary. Null when unavailable.
- `spriteUrl`: Item sprite URL. Null when no sprite is available.

### `pokeapi_get_nature` (~107 tokens)

Get Nature

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%.

Input parameters:

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

Output parameters:

- `isListAll` (boolean): True when all 25 natures are returned (no identifier provided).
- `natures` (array): One or all 25 natures depending on whether identifier was provided.

### `pokeapi_find_pokemon` (~281 tokens)

Find Pokémon

Filter Pokémon by generation, type, regional pokédex, or egg group. Returns names and Pokédex numbers suitable for follow-up pokeapi_get_pokemon calls. All filters are optional and combined with AND logic; query adds strict token matching on name. When no category filter is provided alongside query, returns an empty result — at least one categorical filter is required.

Input parameters:

- `egg_group` (string): Egg group name (e.g. "monster", "fairy", "dragon"). Filters to Pokémon in this egg group.
- `generation` (string): Generation name (e.g. "generation-i", "generation-iii"). Filters to Pokémon introduced in this generation.
- `limit` (integer): Maximum results to return. Positive integer; defaults to 50.
- `offset` (integer): Offset into the filtered result set for pagination. Non-negative integer; defaults to 0.
- `pokedex` (string): Regional pokédex name (e.g. "kanto", "hoenn", "galar"). Filters to entries in that dex.
- `query` (string): Strict token match on name. "chu" matches "pikachu" and "raichu". Case-insensitive.
- `type` (string): Type name (e.g. "fire", "psychic"). Filters to Pokémon of this type.

Output parameters:

- `notice` (string): Guidance when no Pokémon matched the filters.
- `pokemon` (array): Matching Pokémon entries.
- `shown` (number): Number of results in this response.
- `totalCount` (number): Total matching Pokémon before limit/offset.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi#diagnostics

## Score history

- 2026-08-03: 73
- 2026-08-02: 72
- 2026-08-01: 72
- 2026-07-31: 72
- 2026-07-30: 71
- 2026-07-29: 71
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 69

## Links

- Remote endpoint: https://pokeapi.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/pokeapi-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-pokeapi-mcp-server/pokeapi