Pokemon MCP Server

A Model Context Protocol (MCP) server that provides access to Pokemon data through the PokeAPI. This server allows Claude and other MCP-compatible clients to fetch detailed information about Pokemon, including stats, types, moves, and evolution chains.

Features

Pokemon Overview: Get comprehensive information about any Pokemon including name, types, base stats, and description
Move Details: Fetch detailed information about Pokemon moves including power, PP, type, and damage class
Evolution Chains: Retrieve complete evolution chains for any Pokemon

Prerequisites

Node.js 18 or higher
npm or yarn package manager

Installation

Clone this repository:

git clone <your-repository-url>
cd pokemon-mcp

Install dependencies:

npm install

Build the project:

npm run build

Usage

Development

To run the server in development mode:

npm run dev

Production

After building, you can run the compiled server:

node build/index.js

Available Tools

1. Get Pokemon Overviews

Tool Name: get_pokemon_overviews
Description: Get overview information for multiple Pokemon
Parameters:
- pokemonNames: Array of Pokemon names (e.g., ['pikachu', 'charizard'])
Returns: Name, types, base stats, and description for each Pokemon

2. Get Move Detail

Tool Name: get_move_detail
Description: Get detailed information about a specific Pokemon move
Parameters:
- move: Move name (e.g., 'hyper beam', 'thunder bolt')
Returns: Move name, power, PP, type, category, and damage class

3. Get Evolution Chain

Tool Name: get_evolution_chain
Description: Get the complete evolution chain for a Pokemon
Parameters:
- pokemonName: Pokemon name (e.g., 'bulbasaur')
Returns: Complete evolution chain from base form to final evolution

Connecting to Claude Desktop

To use this MCP server with Claude Desktop, you need to configure it in your Claude Desktop settings.

Configuration

Open Claude Desktop
Navigate to Settings → Developer → Edit Config
Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/your/pokemon-mcp/build/index.js"],
      "env": {}
    }
  }
}

Important: Replace /path/to/your/pokemon-mcp/ with the actual absolute path to your project directory.

Alternative: Using npx (if published)

If you've published this as an npm package, you can use:

{
  "mcpServers": {
    "pokemon": {
      "command": "npx",
      "args": ["pokemon-mcp"],
      "env": {}
    }
  }
}

Verification

Restart Claude Desktop after updating the configuration
Look for the 🔌 icon in the Claude interface, which indicates MCP servers are connected
You should see "pokemon" listed as an available MCP server
Test the connection by asking Claude about Pokemon information

Example Usage with Claude

Once connected, you can ask Claude questions like:

"Can you get information about Pikachu and Charizard?"
"What are the details of the move Thunder Bolt?"
"Show me the evolution chain for Squirtle"
"Compare the stats of Bulbasaur, Charmander, and Squirtle"

API Data Source

This server fetches data from PokeAPI, a free and open Pokemon API. The server includes caching to improve performance and reduce API calls. For this project specifically, we are using pokedex-promise-v2

Project Structure

pokemon-mcp/
├── src/
│   ├── index.ts          # Main MCP server implementation
│   └── pokemonHelper.ts  # Pokemon API helper functions
├── build/                # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Development Scripts

npm run dev - Run the server in development mode with hot reload
npm run build - Compile TypeScript to JavaScript

Dependencies

@modelcontextprotocol/sdk - MCP SDK for building MCP servers
pokedex-promise-v2 - Promise-based PokeAPI wrapper
zod - Schema validation library

Troubleshooting

Server Not Connecting

Ensure the path in your Claude Desktop config is correct and absolute
Verify that the build directory exists and contains compiled JavaScript
Check that Node.js is installed and accessible from the command line

Pokemon Not Found

Ensure Pokemon names are spelled correctly (case-insensitive)
Use the official Pokemon names (e.g., "nidoran-f" for female Nidoran)

Move Not Found

Move names should use hyphens instead of spaces (e.g., "hyper-beam" instead of "hyper beam")
The server automatically converts spaces to hyphens, but using the correct format is recommended

License

ISC

Contributing

Feel free to submit issues and enhancement requests!