Overview
What is Pokemon MCP Server?
A modular MCP server for Pokemon information and strategy. It provides Pokemon data retrieval, side-by-side comparisons, type matchup analysis, and team composition suggestions, aimed at trainers and developers building Pokemon‑related tools.
How to use Pokemon MCP Server?
Install uv, set the GROQ_API_KEY environment variable, then run uv run pokemon_mcp.py to start the server on port 8000. Optionally, launch the web frontend with uv run web_interface.py on port 8080. Configure the server in Claude Desktop by adding an MCP entry pointing to the pokemon_mcp.py script via uv.
Key features of Pokemon MCP Server
- Retrieve detailed Pokemon stats, types, abilities, and moves
- Compare multiple Pokemon side-by-side
- Analyze type matchups and recommend counters
- Suggest balanced teams based on roles and coverage
Use cases of Pokemon MCP Server
- Get Pokemon info:
get info pikachu - Compare two Pokemon:
compare pikachu charizard - Find type matchups:
strategy mewtwo - Build a balanced team:
team balanced offensive
FAQ from Pokemon MCP Server
What exactly does this server do?
It exposes Pokemon data and strategy capabilities through the Model Context Protocol, allowing AI assistants like Claude to retrieve Pokemon information, compare creatures, analyze type matchups, and generate team suggestions.
What dependencies are required?
The server requires uv (install via curl -LsSf https://astral.sh/uv/install.sh | sh) and a valid GROQ_API_KEY environment variable. Python scripts pokemon_mcp.py and web_interface.py are provided.
How do I run the server?
Navigate to the pokemon directory and run uv run pokemon_mcp.py. The server will listen on port 8000. For the frontend, run uv run web_interface.py to serve on port 8080.
How do I integrate it with Claude Desktop?
Add an MCP configuration entry in Claude Desktop settings using the command uv with arguments --directory /path/to/pokemon run pokemon_mcp.py. Replace /path/to/pokemon with the actual directory path.
What transport and authentication does it use?
The server communicates via stdio inside the uv run command. Authentication is handled through the GROQ_API_KEY environment variable (Groq API key). No network ports are exposed by default unless the frontend is used.
