Pokemon Gen3 Calc

Provides comprehensive status and damage calculations for Gen 3 Pokémon, including stats, types, items, weather, and special moves.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 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": {
    "ptrst102-pokemon-gen3-calc-mcp": {
      "command": "node",
      "args": [
        "path/to/pokemon-gen3-calc-mcp/dist/index.js"
      ]
    }
  }
}

You run a Pokémon Gen 3 calculator MCP server that lets AI clients perform precise stat and damage calculations for Ruby, Sapphire, Emerald, FireRed, and LeafGreen. This server is designed to be used as an external tool by MCP clients, ensuring accurate results for complex Pokémon mechanics.

How to use

Connect an MCP client to the local server to obtain accurate Pokémon calculations for status and damage based on species, IVs, EVs, nature, hold items, weather, field effects, abilities, critical hits, and special move rules. You’ll be able to request calculate_status, calculate_damage, and the specialized damage-matrix tools to explore how different EV allocations affect outcomes.

How to install

Prerequisites you need on your machine:

Node.js (Volta recommended)
npm

Install steps you should follow:

# Clone the repository
git clone https://github.com/ptrst102/pokemon-gen3-calc-mcp.git
cd pokemon-gen3-calc-mcp

# Install dependencies
npm install

Configuration and usage with an MCP client

After building the project, you enable your MCP client to connect using the provided local stdio configuration. Build produces the distribution files used by the MCP client.

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

Available tools

calculate_status

Compute accurate real-valued stats from base species stats, individual values, effort values, and nature.

calculate_damage

Perform comprehensive damage calculations considering type effectiveness, STAB, abilities, items, weather, field effects, accuracy of critical hits, and special move handling.

calculate_damage_matrix_varying_attack

Generate a damage matrix by fixing the defender's EVs and sweeping the attacker's EVs to find optimal offensive distributions.

calculate_damage_matrix_varying_defense

Generate a damage matrix by fixing the attacker's EVs and sweeping the defender's EVs to find distributions that survive specific attacks.