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:

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

# 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"