Pokemon VGC Damage Calculator

You can run a dedicated MCP server that performs Pokémon VGC damage calculations using the @smogon/calc library. This server exposes a single, well-defined tool for calculating damage, accepts rich Pokémon data, and works smoothly with MCP clients to automate damage checks in your workflows or UIs.

How to use

You use an MCP client to connect to the Pokémon VGC Damage Calculator MCP Server and invoke the primary tool to compute damage between an attacker and a defender. Provide the attacker and defender Pokémon details, the move being used, and the current field conditions. The tool returns a human-readable description, the damage range, knockout likelihood, and the full result object from the underlying calculation library.

Key inputs include attacker, defender, move, and field. The attacker and defender carry species, level, stats, abilities, items, and related battle modifiers. A move object includes its name and any special flags. The field object captures game type, weather, terrain, and side effects. The output consists of a concise damage summary plus a full calculation payload for advanced analysis.

How to install

Prerequisites you need before installing the server:

• Node.js 18+
• npm

Install the MCP server package globally so you can run the calculator from anywhere.

Installation and development steps

npm install -g pokemon-vgc-calc-mcp

Build and test during development to verify the calculation tool remains accurate.

npm run build
npm run test

MCP client configuration

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

Local development

For local development you can run the server directly from your project after building.

git clone git@github.com:jpbullalayao/pokemon-vgc-calc-mcp.git
npm install
npm run build

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

Tools available

The server exposes a single primary tool you can call via MCP clients:

Tool: calculateDamage — Calculates battle damage between an attacking and defending Pokémon.

Available tools

calculateDamage

Calculates battle damage between an attacking and defending Pokémon, returning a human-readable description, a damage range, KO chance, and the full calculation payload.