Skip to main content
Glama
Sign In
deenesjakoruzh

PokeMCP

by ChiragAgg5k
GitHub
Python
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides access to the PokeAPI through a GitHub-hosted MCP server framework, enabling users to fetch detailed Pokémon information and simulate battles

  • Requires Python 3.11.4+ as the runtime environment for the MCP server implementation

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

Requirements

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):

uv run mcp dev server.py

Connecting with Claude

Run the following command to connect with Claude:

uv run mcp install server.py

Result should look like this:

Added server 'poke-mcp' to Claude config Successfully installed poke-mcp in Claude app

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:

{ "name": "pikachu", "id": 25, "base_stats": { "hp": 35, "attack": 55, ... }, "types": ["electric"], "abilities": [ {"name": "static", "effect": "May paralyze on contact."}, ... ], "moves": [ {"name": "thunder-shock", "effect": "Has a 10% chance to paralyze the target."}, ... ], "evolution_chain": ["pichu", "pikachu", "raichu"] }
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:

{ "pokemon1": "pikachu", "pokemon2": "charizard", "initial_hp": { "pikachu": 35, "charizard": 78 }, "battle_log": [ "Turn 1:", "charizard uses mega-punch and deals 75 damage! (pikachu HP: 0)", "pikachu fainted!", "Winner: charizard!" ], "winner": "charizard" }
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.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that provides detailed Pokémon information by integrating with the PokeAPI, allowing users to fetch comprehensive data about Pokémon and simulate battles.

  1. Features
    1. Requirements
      1. Installation
        1. Usage
          1. Development Server
          2. Connecting with Claude
        2. API
          1. Tool: get_pokemon_info
          2. Tool: simulate_battle
        3. License

          Related MCP Servers

          • Poke-MCP

            NaveenBandarage
            A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that provides Pokémon information by connecting to the PokeAPI, enabling users to query detailed Pokémon data, discover random Pokémon, and find Pokémon by region or type.
            Last updated -
            4
            2
            TypeScript

          • balldontlie-mcp

            mikechao
            A
            security
            A
            license
            A
            quality
            An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.
            Last updated -
            4
            22
            4
            JavaScript
            MIT License

          • PokeAPI MCP Server

            AkhrHysd
            -
            security
            -
            license
            -
            quality
            A Model Context Protocol server that interfaces with PokeAPI to provide Pokémon information to LLM applications through JSON-RPC over stdio.
            Last updated -
            TypeScript

          • MCP Pokemon Server

            sarathvad1811
            -
            security
            F
            license
            -
            quality
            An MCP server implementation that enables users to interact with the PokeAPI to fetch Pokemon information through natural language queries.
            Last updated -
            Python
            • Linux
            • Apple

          View all related MCP servers

          New MCP Servers

          ID: 0r0palz954