Skip to main content
Glama

poke-mcp

A Model Context Protocol server that turns your favorite LLM client into a Pokédex. Backed by a dataset of 801 Pokémon (generations 1–7).

Tools

Tool

Description

get_pokemon

Look up a Pokémon by name. Supports exact, partial, and misspelled names (pika, mrmime, charmandr all work). Returns types, abilities, base stats, height/weight, generation, and legendary status. Ambiguous queries return candidate names.

predict_battle

Predict the winner of a battle between two Pokémon using a deterministic model based on base stats and type effectiveness. Same inputs always produce the same result, with a full breakdown of why.

Related MCP server: Pokemon MCP Server

Setup

Requires Node.js 18+.

npm install
npm run build

Client Configuration

opencode

Add to opencode.json (project) or ~/.config/opencode/opencode.json (global):

{
  "mcp": {
    "poke-mcp": {
      "type": "local",
      "command": ["node", "/absolute/path/to/poke-mcp/dist/index.js"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json (found via Claude Desktop → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "poke-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/poke-mcp/dist/index.js"]
    }
  }
}

Restart Claude Desktop after saving.

Other MCP clients

The server speaks standard MCP over stdio — launch it with any client that supports local MCP servers:

node /absolute/path/to/poke-mcp/dist/index.js

Development

npm run build   # compile TypeScript to dist/
npm start       # run the server (stdio transport)

Data

data/pokemon.csv — 801 Pokémon with base stats, types, abilities, and per-type defensive multipliers used for battle predictions.

Sourced from the Pokémon with stats dataset by Rounak Banik on Kaggle.

Available Tools

2 tools
get_pokemonGet Pokemon InfoA

Look up a Pokemon by name. Supports exact, partial, and misspelled names. Returns types, abilities, base stats, and other pokedex info. If the name is ambiguous, a list of candidate names is returned.

Inputs: query (required).

predict_battlePredict Pokemon BattleA

Predict the winner of a battle between two Pokemon using a deterministic model based on base stats and type effectiveness. Same inputs always produce the same result.

Inputs: pokemon_a (required), pokemon_b (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools serve clearly distinct purposes: one retrieves Pokemon information, the other predicts battle outcomes. There is no overlap or ambiguity in their intended use.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern (get_pokemon, predict_battle), making the naming predictable and easy to reason about.

    Tool Count3/5

    With only 2 tools, the server feels thin for a 'Pokemon' domain, but the tools are focused and each serves a distinct purpose, making it borderline acceptable for a narrow scope.

    Completeness2/5

    The server lacks common operations such as listing all Pokemon, retrieving moves, or detailed type charts. The stated domain implies a broader surface, leaving significant gaps that agents may need to work around.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to access comprehensive Pokémon data from PokéAPI and simulate battles between any two Pokémon with realistic mechanics including type effectiveness, stat-based damage calculations, and status effects.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables querying Pokemon information from PokeAPI, including Pokemon details, types, moves, abilities, evolution chains, and search functionality, through natural language.
      8
      8 npm
      Apache 2.0