MCP Pokemon Server

Provides an MCP server to fetch Pokémon data from the PokeAPI and expose it to MCP clients.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sarathvad1811-mcp-pokemon": {
      "command": "mcp",
      "args": [
        "dev",
        "server.py"
      ]
    }
  }
}

You run an MCP server that bridges data from the PokeAPI to MCP clients. It lets you fetch Pokémon information through a lightweight, scriptable server you control, with an inspector for debugging and a simple run workflow.

How to use

You interact with the server via the MCP client workflow. Start the server and use its tooling to request Pokémon data, inspect responses, and iterate on data retrieval patterns. Use the inspector to troubleshoot requests and verify that your client receives the expected data shapes. The server exposes a get_pokemon_info tool to fetch Pokémon details from the PokeAPI, and is designed to be extended with additional resources to support dynamic client interactions.

How to install

Prerequisites: You need Python 3.12 or higher installed on your system.

Steps to set up the server on your machine:

git clone <repository-url>
cd mcp-pokemon

python3 -m venv mcppoke_venv
source mcppoke_venv/bin/activate  # On Windows, use `mcppoke_venv\Scripts\activate

How to run the server

To run the MCP server, you have two options depending on your goal. Use the inspector for debugging, or run the server directly for normal operation.

mcp dev server.py  # for inspector debugging
mcp run server.py  # for running the server directly

Available tools

get_pokemon_info

Fetches Pokémon data from the PokeAPI for a given Pokémon name or ID and returns structured information to the MCP client.