# Pokebattler

> Pokémon GO battle simulator. Pokebattler runs large-scale Monte Carlo combat
> simulations to rank raid counters, Max/Dynamax battle teams, Team GO Rocket
> lineups, and PvP matchups, using the game's real damage, energy, and dodging
> mechanics rather than a damage formula approximation.

Results are simulated, not hand-curated, and they change whenever Niantic
changes movesets, stats, or the raid rotation. Anything scraped from these pages
goes stale within days.

Key conventions for reading Pokebattler data:

- **Estimator** is the headline ranking metric: the estimated number of trainers
  needed to win the raid. **Lower is better.** It is not a damage number.
- Raid teams are always **6 Pokémon**. A Mega (or Primal) evolution boosts the
  whole lobby, so a recommended team normally includes one.
- Max battle teams are **3 Pokémon** each, and a lobby is up to 4 trainers. The
  role matters: each Pokémon is scored on the metric for its role. **Attackers**
  do the big damage, but only in the max phase, and are usually paired with 2
  Chargers or 2 Defenders. **Defenders** take hits and fill the Max Meter.
  **Chargers** fill the Max Meter fastest and survive attacks that hit the whole
  team. **Healers** restore the team's HP with Max Spirit. **Shielders** block
  damage with Max Guard and draw the boss's attacks.
- Max boss names: Dynamax bosses are written "Dynamax Registeel" at
  `/max/DYNAMAX_<SPECIES>`; Gigantamax and Eternamax bosses never say Dynamax
  (`/max/<SPECIES>_GIGANTAMAX`, `/max/ETERNATUS_ETERNAMAX_FORM`). Each boss has
  six pages: `/max/<BOSS>` (Attackers) and `/max/<BOSS>/CHARGER` (Defenders),
  `/METER_CHARGE` (Chargers), `/TOTAL_HEAL` (Healers), `/TANK` (Shielders) and
  `/PARTY` (Lobby).
- Team GO Rocket uses different mechanics from raids (3v3 with shields). Raid
  counter rankings do not transfer to Rocket battles.

## Live data via MCP

Prefer this over scraping. Pokebattler runs a Model Context Protocol server that
exposes the simulation engine directly as tools, so an assistant can request
counters for a specific boss, weather, and trainer level and get current,
structured results instead of parsing rendered HTML.

- [Pokebattler MCP server](https://mcp.pokebattler.com/mcp): streamable-HTTP MCP
  endpoint. Tools cover raid counters, best attackers, the live raid rotation,
  Max battle counters, Rocket lineups, single-fight simulation, team building,
  and Pokédex lookups. Requires a free Pokebattler account and a personal
  access token from the account page; personalized tools that read a user's
  own Pokémon collection require a subscription.
- [Developer reference](https://www.pokebattler.com/developers): human-readable
  documentation for both the MCP server and the public HTTP API — base URLs,
  endpoints, parameters, worked examples, and fair-use expectations.
- [Connecting to Pokebattler](https://www.pokebattler.com/help#help-mcp): setup
  steps for MCP clients (Claude Code, Gemini CLI, Codex and others).
- [Account page](https://www.pokebattler.com/user): where a signed-in user
  creates the personal access token, shown once, with copyable client setup.

## Public HTTP API

If MCP is not an option, the same simulation data is available over plain HTTP
with no authentication, at `https://fight.pokebattler.com`. The website's v2
URLs are short and are not the API paths; use the endpoints below.

- `GET /raids` — current raid rotation and announced upcoming raids.
- `GET /raids/defenders/{boss}/levels/{tier}/attackers/levels/{level}/strategies/{attack}/{defense}` — ranked counters for one boss.
- `GET /fights/attackers/{a}/quickMoves/{m}/cinMoves/{m}/cp/{cp}/defenders/{d}/...` — one specific matchup.
- `GET /pokemon`, `GET /moves` — Pokédex, base stats, typings, and move data.
- `GET /rocket` — current Team GO Rocket lineups.

These responses are very large (a counters query is ~1.3 MB, `/pokemon` is
~7 MB). The MCP server returns the same results trimmed to ~1-5 KB, so prefer
it for anything model-facing. Full parameter documentation is on the
[developer reference](https://www.pokebattler.com/developers).

## Site

- [Raid counters](https://www.pokebattler.com/raids): current raid bosses with
  ranked counters per boss.
- [Raid attacker rankings](https://www.pokebattler.com/raids/attackers/rankings):
  which attackers are worth investing in across all bosses.
- [Raid guides](https://www.pokebattler.com/raids/guides): written per-boss
  breakdowns of counters, weather, and strategy.
- [Raid advice](https://www.pokebattler.com/raid-advice): what to power up next
  for a boss.
- [Max battles](https://www.pokebattler.com/max): Dynamax, Gigantamax and
  Eternamax boss counters, one page per role (Attackers, Defenders, Chargers,
  Healers, Shielders) plus a Lobby page that suggests a 4 trainer lobby.
- [Max battle simulator](https://www.pokebattler.com/max/simulator): build a
  lobby and simulate the whole max battle.
- [Battle simulator](https://www.pokebattler.com/simulator): simulate one
  specific matchup with custom levels, IVs, movesets, weather, and friendship.
- [Team GO Rocket](https://www.pokebattler.com/rocket): current Rocket lineups
  with counters.
- [Pokédex](https://www.pokebattler.com/pokemon): stats, movesets, and typings.
- [Type chart](https://www.pokebattler.com/type-chart): type effectiveness.
- [Rankings](https://www.pokebattler.com/rankings): every ranking surface in one
  index.
- [PvP rankings](https://www.pokebattler.com/pvp/rankings): league rankings;
  the [matchup matrix](https://www.pokebattler.com/pvp/matrix) is separate.

## Optional

- [About Pokebattler](https://www.pokebattler.com/about)
- [Pokebox](https://www.pokebattler.com/pokebox): a signed-in trainer's own
  Pokémon collection, used to rank counters they actually own.
- [Subscription](https://www.pokebattler.com/subscription)
- [Terms](https://www.pokebattler.com/terms) and
  [Privacy](https://www.pokebattler.com/privacy)

Pokebattler is an independent fan project and is not affiliated with, endorsed
by, or sponsored by Niantic, Nintendo, Creatures Inc., GAME FREAK Inc., or The
Pokémon Company.