🧩 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

Related MCP server: Pokédex MCP Server

📦 Requirements

• Python 3.8+

• Node.js (for some LLM hosts that require it)

• 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]"

⚙️ 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