# VGC Teambuilder

> VGC Teambuilder is a free MCP server for gaming. Read-only Pokemon Champions VGC data: usage, legality, type checks and damage calcs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://docs.pokemcp.com
- **Repository:** https://github.com/rborkow/pokemcp
- **MCP Registry name:** com.pokemcp/vgc-teambuilder
- **Categories:** gaming
- **Listing updated:** 2026-11-14

## About

Competitive players can check a team against a regulation's allowed list, Species Clause and Item Clause, confirm which moves a Pokemon can learn, and see how a team's typing holds up defensively. Usage tools show the most-used Pokemon in a regulation, how each is usually built, common teammates and the Pokemon that reliably beat it.

Trend tools compare usage between two months, follow one Pokemon over time and list risers and fallers. For matchups, `calculate_damage` works out damage for one move, `compare_speed` gives turn order, and `check_team_threats` tests a team against the most-used Pokemon.

The server needs no account, stores nothing about you and only reads data. Coverage is limited to Pokemon Champions regulations. It is an unofficial fan project, not affiliated with Nintendo, Creatures, GAME FREAK or The Pokemon Company, and tournament results and monthly meta reports live on a separate website.

## Features

- **Team legality check:** Validate a team against a regulation, Species Clause and Item Clause.
- **Usage statistics:** See most-used Pokemon and how each is built.
- **Teammates and counters:** Find common teammates and reliable checks.
- **Usage trends:** Follow one Pokemon over time and see risers and fallers.
- **Damage and Speed:** Calculate damage and compare Speed order.
- **Defensive typing:** Analyse how a team's types hold up.

## Good for

- Check a team is legal before a tournament
- Find common teammates for a Pokemon
- See which Pokemon are rising this month
- Calculate a damage roll
- Test a team against the top threats

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vgc-teambuilder https://api.pokemcp.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.pokemcp.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vgc-teambuilder": {
      "url": "https://api.pokemcp.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vgc-teambuilder": {
      "type": "http",
      "url": "https://api.pokemcp.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vgc-teambuilder": {
      "serverUrl": "https://api.pokemcp.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vgc-teambuilder": {
      "type": "http",
      "url": "https://api.pokemcp.com/mcp"
    }
  }
}
```

## Tools

- `list_formats`: List the Pokémon Champions regulations this connector supports, with each one's id, dates, whether it is current, team rules, number of legal Mega Evolutions and whether usage statistics are available. Use it to find the `format` value other tools accept and to see which format they use by default.
- `lookup_pokemon`: Get a Pokémon's types, base stats, abilities, weight, alternate forms and any Mega Evolutions legal in the supported regulations (with the Mega's types, ability and base stats). Data comes from Pokémon Showdown; it does not say whether the Pokémon itself is legal in a format — use validate_team for that.
- `validate_moveset`: Check whether a Pokémon can learn each of the given moves in any Pokémon game, counting moves inherited from its pre-evolutions and base form. Based on Pokémon Showdown learnset data across all generations, not Pokémon Champions' own move lists: a move learnable only in an older game may not exist in Champions, and a move added only in Champions may be reported as not learnable.
- `validate_team`: Check a team against a Pokémon Champions regulation: each Pokémon is on the regulation's allowed list, Species Clause, Item Clause, at most four moves each, moves are learnable and abilities belong to the Pokémon. A Mega Evolution named directly (e.g. "Charizard-Mega-Y") is checked as its base Pokémon holding its Mega Stone. It does not check stat spreads or held-item availability. Move data comes
- `analyze_team_types`: For a list of Pokémon, count how many are weak to, resist or are immune to each attacking type, and report shared weaknesses, types nothing on the team resists, and defensive types that would patch the most gaps. It considers typing only — not abilities, items or moves — and suggests types, not specific Pokémon. Pass a Mega form's name (e.g. "Charizard-Mega-Y") to analyse its post-Mega typing.
- `get_top_usage`: Rank the most-used Pokémon in a regulation by the share of ladder teams they appear on, from the most recent month of usage statistics loaded for that regulation (the month itself is not reported; get_usage_trend shows dated history). Use it to see what a team should expect to face. Mega Evolutions are ranked as separate entries.
- `get_pokemon_usage`: Show how one Pokémon is typically built in a regulation: its usage and rank, and the most common abilities, items, moves and stat spreads as a share of its recorded sets. Spreads use the stat-point scale the ladder records (0–32 per stat in Pokémon Champions).
- `get_teammates`: List the Pokémon that most often share a team with the given Pokémon in a regulation, as the share of its teams that include each one. Use it to find proven partners and cores.
- `get_checks_and_counters`: List the Pokémon that most reliably beat the given Pokémon on the ladder, ranked by Smogon's checks-and-counters score. The data records one-on-one outcomes (a knockout or a forced switch), so in doubles treat it as a rough signal. Pokémon with few recorded matchups have no data.
- `get_usage_trend`: Show one Pokémon's monthly usage and rank in a regulation across a range of months, with its net change and peak. History exists only for months the regulation's ladder was active.
- `get_meta_shifts`: Compare a regulation's usage between two months: the biggest risers and fallers, Pokémon that newly reached meaningful usage and Pokémon that dropped out. Use it to see how the metagame changed. Needs at least two months of history.
- `get_usage_momentum`: Fit a trend to each Pokémon's monthly usage across a range and list the fastest rising, fastest declining and most volatile. These are descriptive trends, not forecasts. Needs at least three months of history in the range; with so few points, treat the result as a direction, not a measurement.
- `calculate_damage`: Calculate how much damage one move does from one Pokémon to another in Pokémon Champions doubles: the damage range, the share of the defender's HP, and the chance to knock it out. Use it instead of estimating damage. Any part of a set that is left out is filled in from the regulation's usage statistics and listed under `assumptions`. A move that hits both opponents is calculated at its reduced dou
- `compare_speed`: Work out the Speed of several Pokémon in Pokémon Champions and the order they move in, including the effect of items such as Choice Scarf, Tailwind, paralysis, stat stages, weather abilities and Trick Room. Use it to answer who outspeeds whom. Any part of a set that is left out is filled in from the regulation's usage statistics and listed under `assumptions`. Speed decides order only among moves 
- `check_team_threats`: Check a team against the Pokémon it is most likely to face in a regulation. For each threat (the most used Pokémon by default, or the ones named) it reports the team's hardest hit into it, its hardest hit into the team, and which team members outspeed it. Each threat uses its most common set in the regulation's usage statistics. Results are single hits with no screens or stat changes, under the we

## FAQ

### Does it need an account?

No. It takes no personal information and stores nothing about you.

### Can it change anything?

No, it only reads data.

### Which formats are covered?

Pokemon Champions regulations only; `list_formats` shows the supported ones.

### Is it official?

No, it is an unofficial fan project.

### Is VGC Teambuilder free?

Yes. VGC Teambuilder is free to use.

### How do I add VGC Teambuilder to Claude Code?

Run this command in your terminal: claude mcp add --transport http vgc-teambuilder https://api.pokemcp.com/mcp

---
Source: https://ai-powered.com/mcp/vgc-teambuilder
