mcpkmn-showdown

A Model Context Protocol (MCP) server that provides Pokemon Showdown data to LLMs. Enables AI assistants like Claude to look up Pokemon stats, moves, abilities, items, and type matchups during conversations.

What is MCP?

Model Context Protocol is an open standard that allows AI assistants to securely access external tools and data sources. This server exposes Pokemon game data as MCP tools that Claude and other compatible LLMs can call.

Features

• Pokemon Lookup - Stats, types, abilities for any Pokemon

• Move Database - Power, accuracy, effects, priority, descriptions

• Ability Info - Full descriptions of what abilities do in battle

• Item Effects - Held item descriptions and battle effects

• Type Calculator - Calculate type effectiveness multipliers

• Priority Moves - Search for moves with priority (Quick Attack, etc.)

• Ability Search - Find all Pokemon with a specific ability

• Dangerous Abilities - List battle-critical abilities (immunities, etc.)

Installation

Option 1: Using uvx (Recommended)

The easiest way to use mcpkmn-showdown is with uvx:

Option 2: Using pip

Then run:

Option 3: From Source

Usage with Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Or if installed via pip:

Restart Claude Desktop after updating the config.

Available Tools

get_pokemon

Look up a Pokemon by name. Returns base stats, types, abilities with descriptions, weight, and competitive tier.

get_move

Look up a move by name. Returns power, accuracy, type, category, priority, effects, and full description.

get_ability

Look up an ability by name. Returns full description of what the ability does in battle.

get_item

Look up a held item by name. Returns full description of what the item does in battle.

get_type_effectiveness

Calculate type effectiveness multiplier for an attack against a Pokemon's types.

search_priority_moves

Find all moves with priority (moves that go before normal moves).

search_pokemon_by_ability

Find all Pokemon that can have a specific ability.

list_dangerous_abilities

List abilities that can significantly affect battle outcomes.

Example Conversations

Once configured, you can ask Claude things like:

• "What are Garchomp's stats and abilities?"

• "Is Earthquake effective against Rotom-Wash?"

• "What does the ability Protean do?"

• "What priority moves can hit Ghost types?"

• "Which Pokemon have the ability Intimidate?"

Data Sources

Pokemon data is sourced from Pokemon Showdown, the popular competitive Pokemon battle simulator. Data includes:

• pokedex.json - Pokemon stats, types, abilities

• moves_showdown.json - Move data with effects

• abilities_full.json - Ability descriptions

• items.json - Item descriptions

• typechart.json - Type effectiveness chart

Development

Running Locally

Updating Pokemon Data

The cache data can be refreshed using the data fetcher:

Related Projects

• pokemon-llm-battle-bot - An LLM-powered Pokemon battle bot that uses this MCP server

• Pokemon Showdown - The source of Pokemon data

• Model Context Protocol - The protocol specification

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Andrew Sung - @drewsungg