PokeMCP

PokeMCP is an MCP (Modular Command Platform) server that provides detailed Pokémon information by integrating with the PokeAPI. It exposes a tool to fetch comprehensive data about any Pokémon, including base stats, types, abilities (with effects), moves (with effects), and evolution chain.

Features

• Fetches Pokémon base stats, types, and abilities (with effect descriptions)

• Retrieves up to 10 moves per Pokémon, including move effects

• Provides the full evolution chain for a given Pokémon

• Handles errors gracefully and returns informative error messages

Related MCP server: Poke-MCP

Requirements

• Python 3.11.4+

• httpx (for async HTTP requests)

• mcp.server.fastmcp (for MCP server framework)

Installation

1. Clone this repository:

   git clone https://github.com/ChiragAgg5k/poke-mcp.git cd poke-mcp

2. Install dependencies using uv:

   uv sync

Usage

Development Server

Run the server using uv (ensure you have the required MCP infrastructure):

Connecting with Claude

Run the following command to connect with Claude:

Result should look like this:

Now you can use the poke-mcp MCP tools in Claude:

Get Pokemon Info

Simulate Battle

Learn how to connect the server with other MCP clients like Cursor here.

API

Tool: get_pokemon_info

Fetches detailed information about a Pokémon.

Arguments

• pokemon_name (str): The name of the Pokémon (case-insensitive)

Returns

A dictionary with the following structure:

Error Handling

If the Pokémon is not found or there is a network error, the response will include an error key with a descriptive message.

Tool: simulate_battle

Simulates a Pokémon battle between two Pokémon using core mechanics (stats, type, and status effects).

Arguments

• pokemon1 (str): Name of the first Pokémon (case-insensitive)

• pokemon2 (str): Name of the second Pokémon (case-insensitive)

Returns

A dictionary with the following structure:

Error Handling

If either Pokémon is not found or there is a network error, the response will include an error key with a descriptive message.

License

This project uses the PokeAPI and is intended for educational and non-commercial use.