README.md
Fetch detailed Pokémon information and manage tournament squads.
🧩 Pokemon MCP Server Demo
This is a simple MCP (Model Context Protocol) server that connects to the PokéAPI and exposes tools that an LLM can use to fetch Pokémon data, list popular Pokémon, and build a tournament squad.
It uses the FastMCP library and httpx to fetch live Pokémon info via a standardized protocol that works seamlessly with LLMs and AI agents.
🚀 Features
- Get detailed info about any Pokémon
- Create a powerful tournament squad
- List popular Pokémon picks
📦 Requirements
- Python 3.8+
- Node.js (for some LLM hosts that require it)
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]"
⚙️ Quick Start Using `uv`
If you prefer using uv, follow these steps:
# Create a new directory for our project
uv init pokemon
cd pokemon
# Create virtual environment and activate it
uv venv
.venv\Scripts\activate # On Windows
# source .venv/bin/activate # On macOS/Linux
# Install dependencies
uv add mcp[cli] httpx
# Create our server file
new-item pokemon.py # On PowerShell
Tools (3)
get_pokemon_infoGet detailed info about any Pokémoncreate_tournament_squadCreate a powerful tournament squadlist_popular_pokemonList popular Pokémon picksConfiguration
claude_desktop_config.json
{
"mcpServers": {
"pokemon": {
"command": "python",
"args": ["/path/to/pokemon.py"]
}
}
}Try it
→Get detailed information and stats for Pikachu.
→Show me a list of popular Pokémon picks.
→Help me create a powerful tournament squad using Charizard, Blastoise, and Venusaur.
→What are the base stats and abilities of Mewtwo?