MCP kmn Showdown Server

Provides local Pokemon Showdown data for fast, offline querying by 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": {
    "drewsungg-mcpkmn-showdown": {
      "command": "mcpkmn-showdown",
      "args": []
    }
  }
}

You can run mcpkmn-showdown as an MCP server so your Claude-compatible AI gets instant, offline access to Pokemon stats, moves, abilities, items, and type matchups. This keeps data consistent, fast, and free of external API limits, helping your AI reason accurately about battles and team decisions.

How to use

You use the server from an MCP client by starting the local MCP server process and pointing your client to the local runtime. In this setup, you configure a local stdio MCP endpoint that Claude Desktop (or another MCP-enabled client) can query. Once running, you can ask your AI questions like which ability is best for a given Pokemon, how a move interacts with type matchups, or which items influence damage calculations. The data comes from the integrated local JSON data for Pokemon Showdown, so responses are structured and reliable for reasoning and agent-driven workflows.

Example configuration for your MCP client

{
  "mcpServers": {
    "pokemon": {
      "command": "mcpkmn-showdown",
      "args": [],
      "env": []
    }
  }
}

Usage workflow with Claude Desktop

Install the MCP server package and run it from your environment.
Configure your AI client to connect to the local MCP endpoint as shown in the example configuration.
Restart Claude Desktop or your MCP client to pick up the new server. Then you can query: “What’s the best ability for Garchomp and why?” or “Build a Trick Room team that handles Fairy types.”

Available tools

get_pokemon

Look up a Pokemon's complete data set including types, stats, abilities, weight, and tier.

get_move

Retrieve move details such as type, category, power, accuracy, PP, priority, and its effects.

get_ability

Explain what a specific ability does in battle.

get_item

Describe held item effects and their in-battle implications.

get_type_effectiveness

Calculate damage multipliers for attack types against defending types.

search_priority_moves

Find moves that act before normal speed order by their priority.

search_pokemon_by_ability

List Pokemon that have a specific ability.

list_dangerous_abilities

List abilities that significantly impact battle outcomes by category.