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

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"