# Pokemon MCP Server
A MCP (Model Context Protocol) server that connects to two APIs — **[PokéAPI](https://pokeapi.co/)** for live Pokémon data and the **[Wikipedia REST API](https://en.wikipedia.org/api/rest_v1/)** (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](https://github.com/chain-ml/model-context-protocol) 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:
1. Uses a hardcoded mapping of Pokémon → real animal (e.g. Pikachu → Mouse, Garchomp → Hammerhead Shark)
2. Hits Wikipedia's REST API to fetch a summary about that animal
3. Returns a fun comparison alongside the Pokémon's stats
> Covers 60+ Pokémon with known real-world inspirations.
## Requirements
- Python 3.8+
- `httpx`
- `mcp` (Model Context Protocol library)
## Installation
```bash
# 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
```bash
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`:
```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"
