pokemcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pokemcp show me Charizard's stats and abilities"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pokemcp
A Model Context Protocol (MCP) server that exposes the PokéAPI as tools and resources, letting any MCP-compatible AI assistant look up Pokémon data in real time.
Features
22 tools across Pokémon, moves, items, and types
8 MCP resources for direct URI-based data access
Optional Redis caching with a local in-memory fallback
Automatic retry with exponential back-off on API errors
Zero configuration required — works out of the box against the public PokéAPI
Related MCP server: PokeMCP
Requirements
Python ≥ 3.11
uv package manager
Installation
git clone https://github.com/Ragde54/pokemcp.git
cd pokemcp
uv syncRunning the server
PYTHONPATH=src uv run pokemcpNote: The
PYTHONPATH=srcprefix is required due to a known incompatibility between Homebrew Python's venv and editable-install.pthfile processing.
Claude Desktop integration
Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"pokemcp": {
"command": "uv",
"args": ["run", "pokemcp"],
"cwd": "/path/to/pokemcp",
"env": {
"PYTHONPATH": "/path/to/pokemcp/src"
}
}
}
}Replace /path/to/pokemcp with the absolute path to this repository, then restart Claude Desktop.
Configuration
Settings are read from environment variables or a .env file in the project root.
Variable | Default | Description |
|
| PokéAPI base URL |
| (none) | Redis URL for persistent caching (e.g. |
|
| Cache time-to-live in seconds |
|
| Python logging level |
Tools
🐾 Pokémon
Tool | Description |
| Full Pokémon details: types, stats, abilities, sprites, forms, held items, and more |
| Species data: Pokédex flavor text, habitat, generation, legendary/mythical status, gender rate |
| Base stats (HP, Attack, Defense, Sp. Atk, Sp. Def, Speed) plus total BST |
| All abilities and whether each is a hidden ability |
| Full evolution chain with trigger conditions |
| Paginated list of all Pokémon (max 100 per page) |
| All Pokémon belonging to a given type |
⚔️ Moves
Tool | Description |
| Full move details: type, power, accuracy, PP, damage class, effect, and more |
| Concise move summary with effect description |
| All moves a Pokémon can learn, grouped by learn method (level-up, TM/HM, egg, tutor) |
| Paginated list of all moves (max 100 per page) |
| All moves that belong to a specific type |
🎒 Items
Tool | Description |
| Full item details: category, cost, effect, attributes, and held-by Pokémon |
| Concise item summary with short effect and Pokédex flavor text |
| Paginated list of all items (max 100 per page) |
| All items in a category (e.g. |
| All Pokémon that hold an item in the wild, with per-version rarity |
🔥 Types
Tool | Description |
| Full type details including damage relations, resident Pokémon, and moves |
| Offensive chart: super effective / not very effective / no effect / normal |
| Defensive chart: weak to / resists / immune to |
| Combined defensive multipliers for a dual-type Pokémon (4×, 2×, 1×, 0.5×, 0.25×, 0×) |
| List all 18 Pokémon types |
Resources
Resources are accessible via URI and return raw JSON.
URI pattern | Description |
| Full Pokémon data |
| Species data including Pokédex entries |
| Full move data |
| Full item data |
| Full type data with damage relations |
| Ability data with effect descriptions |
| Generation data with Pokémon species and version groups |
| Regional Pokédex entries (e.g. |
Project structure
src/pokemcp/
├── app.py # Shared FastMCP instance
├── server.py # Entry point — imports all tools/resources
├── config.py # Settings via pydantic-settings
├── api/
│ ├── client.py # Async HTTP client with retry logic
│ └── cache.py # Redis / in-memory cache layer
├── models/
│ └── pokemon.py # Pydantic models (Pokemon, PokemonSummary, EvolutionChain)
├── tools/
│ ├── pokemon.py # Pokémon tools
│ ├── moves.py # Move tools
│ ├── items.py # Item tools
│ └── types.py # Type tools
└── resources/
└── pokedex.py # MCP resourcesData source
All data is fetched from the PokéAPI — a free, open REST API for Pokémon data. No API key required.
Available Tools
22 toolsget_dual_type_matchupsA
Calculate the combined defensive matchup for a dual-type Pokémon. Multiplies the damage modifiers from both types together to give the final effective multiplier (e.g. 4x, 2x, 1x, 0.5x, 0.25x, 0x).
Inputs: type_one (required), type_two (required).
get_evolution_chainA
Get the full evolution chain for a Pokémon species. Returns the chain of evolutions with trigger conditions.
Inputs: name_or_id (required).
get_itemA
Get full details for an item by name or ID. Includes category, cost, effect, attributes, and Pokémon it's held by.
Inputs: name_or_id (required).
get_item_held_by_pokemonA
Get all Pokémon that can hold a specific item in the wild, along with the rarity of them holding it per game version.
Inputs: item_name (required).
get_items_by_categoryB
Get all items in a specific category (e.g. 'pokeballs', 'healing', 'held-items', 'berries', 'evolution').
Inputs: category (required).
get_item_summaryC
Get a concise summary of an item: name, category, cost, and
its short effect description.
Inputs: name_or_id (required).
get_moveB
Get full details for a move by name or ID. Includes type, power, accuracy, PP, damage class, effect, and more.
Inputs: name_or_id (required).
get_moves_by_typeA
Get all moves that belong to a specific type (e.g. 'fire', 'psychic'). Returns move names and their URLs for further lookup.
Inputs: type_name (required).
get_moves_learned_by_pokemonA
Get all moves a Pokémon can learn, grouped by learn method (level-up, TM/HM, egg, tutor).
Inputs: name_or_id (required).
get_move_summaryB
Get a concise summary of a move: name, type, power, accuracy, PP,
damage class (physical/special/status), and short effect description.
Inputs: name_or_id (required).
get_pokemonA
Get full details for a Pokémon by name or Pokédex ID. Returns species info, types, stats, abilities, sprites, and more.
Inputs: name_or_id (required).
get_pokemon_abilitiesC
Get all abilities for a Pokémon, including whether they are hidden abilities.
Inputs: name_or_id (required).
get_pokemon_speciesB
Get species-level data for a Pokémon including flavor text (Pokédex entries), habitat, generation, legendary/mythical status, and gender rate.
Inputs: name_or_id (required).
get_pokemon_statsB
Get base stats for a Pokémon (HP, Attack, Defense, Sp. Atk, Sp. Def, Speed) along with the total base stat sum.
Inputs: name_or_id (required).
get_typeA
Get full details for a type by name or ID. Includes damage relations, Pokémon of that type, and moves of that type.
Inputs: name_or_id (required).
get_type_defensesB
Get the defensive matchup chart for a type — what it takes super effective, not very effective, or no damage from.
Inputs: defending_type (required).
get_type_matchupsA
Get the offensive matchup chart for a type — which types it hits for super effective (2x), not very effective (0.5x), no effect (0x), or normal damage.
Inputs: attacking_type (required).
list_itemsA
List all items with pagination. Returns names and URLs. Max limit is 100 per request.
Inputs: limit, offset.
list_movesB
List all moves with pagination. Returns names and URLs. Max limit is 100 per request.
Inputs: limit, offset.
list_pokemonB
List Pokémon with pagination. Returns names and URLs. Max limit is 100 per request.
Inputs: limit, offset.
list_typesA
List all available Pokémon types.
Inputs: no named parameters.
search_pokemon_by_typeA
Get all Pokémon that belong to a given type (e.g. 'fire', 'water', 'dragon').
Inputs: type_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Each tool has a clearly distinct purpose, covering different aspects of Pokémon data (Pokémon, moves, items, types, evolutions). Even the type defense tools are differentiated between single-type and dual-type matchups, and offensive vs. defensive. No significant overlap.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_pokemon, list_items, search_pokemon_by_type). There are no deviations or mixed conventions, making the naming predictable and easy to navigate.
With 22 tools, the server is slightly above the typical well-scoped range (3-15), but it is justified by the breadth of Pokémon data (Pokémon, moves, items, types, evolution). The number feels appropriate for a comprehensive Pokémon information server.
The tool set covers core CRUD/lifecycle operations for Pokémon, moves, items, and types, including details, summaries, listings, filtering by type or category, and evolution chains. There are no obvious gaps for a Pokémon information API.
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that gives your AI access to the source code and docs of all public github repos
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server implementation that enables users to interact with the PokeAPI to fetch Pokemon information through natural language queries.-
- FlicenseBqualityDmaintenanceAn MCP server that provides detailed Pokémon information by integrating with the PokeAPI, allowing users to fetch comprehensive data about Pokémon and simulate battles.22-
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server that provides an interface to access Pokémon data through the PokéAPI, enabling agents to retrieve information about Pokémon species, abilities, moves, and more via natural language.-
- AlicenseNot gradedqualityFmaintenanceAn MCP server that provides standardized access to Pokemon data, allowing users to search, compare, and retrieve detailed information about Pokemon through natural language tools.6ISC