Pokemon MCP Server
A MCP (Model Context Protocol) server that connects to two APIs — PokéAPI for live Pokémon data and the Wikipedia REST API (free, no key needed) for real-world animal facts — and exposes tools that an LLM (like Claude) can use to fetch, explore, and battle Pokémon.
Built with FastMCP and httpx.
Tools
| Tool | Description |
|---|---|
get_pokemon_info | Get detailed info (types, abilities, stats) for any Pokémon by name |
list_popular_pokemon | List popular tournament-ready Pokémon picks |
create_tournament_squad | Build a powerful 6-Pokémon squad for a tournament |
find_pokemon_by_type | Find top 5 Pokémon of a given type (e.g. fire, water, psychic) with stats |
battle_simulator | Simulate a 1v1 battle between two Pokémon based on their stats |
pokemon_real_animal | Find which real animal a Pokémon resembles, with fun facts pulled from the Wikipedia API |
How pokemon_real_animal Works
For animal data, the tool uses the Wikipedia API (free, no API key needed) to pull real-world animal facts. Here's how it works:
- Uses a hardcoded mapping of Pokémon → real animal (e.g. Pikachu → Mouse, Garchomp → Hammerhead Shark)
- Hits Wikipedia's REST API to fetch a summary about that animal
- Returns a fun comparison alongside the Pokémon's stats
Covers 60+ Pokémon with known real-world inspirations.
Requirements
- Python 3.8+
httpxmcp(Model Context Protocol library)
Installation
# Clone the repo
git clone https://github.com/your-username/pokemon-mcp-server
cd pokemon-mcp-server
# Create a virtual environment
python -m venv venv
.\venv\Scripts\Activate # On Windows
# source venv/bin/activate # On macOS/Linux
# Install dependencies
pip install httpx "mcp[cli]"
Running the Server
python poke.py
The server runs over stdio transport, making it compatible with Claude Desktop and other MCP-compatible LLM hosts.
Connect to Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"pokemon": {
"command": "python",
"args": ["/path/to/poke.py"]
}
}
}
Example Interactions
- "What are Charizard's stats?"
- "Find me the top fire type Pokémon"
- "Simulate a battle between Pikachu and Mewtwo"
- "What real animal does Garchomp resemble?"
- "Build me a tournament squad"