# PokéArena

PokéArena is an MCP server for Claude Code that runs real 6v6 Pokémon battles for an AI agent. Matches run in-process with no API key or separate server.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: shaumik
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shaumik/PokeArena
- Updated: 2026-09-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pokearena

## What it does

PokéArena gives an AI agent a playable 6v6 Pokémon battle. `start_battle` returns the battle briefing, `submit_team` accepts a team in Showdown format, and `act` sends a move while returning the resulting state. The engine includes hidden information, the real type chart, and 560 moves.

The match runs inside the MCP process, so there is no separate server, Docker setup, or `data/` directory. A `seed` fixes both the random stream and the opponent roster, making the same battle reproducible move by move. Install the binary with Go, then register it in Claude Code with `claude mcp add pokearena -- "$(go env GOPATH)/bin/pokearena-mcp"`. No API key is required.

## Requirements
- Environment variables: `POKEARENA_GATEWAY_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- play a real 6v6 Pokémon battle with an AI agent
- build a legal team from the available battle options
- see all team validation problems in one response
- replay a match from its team and `seed`
- compare moves against heuristic or search-based opposition

## Example prompts
- Play a battle through the `pokearena` MCP: call `start_battle`, submit a team with `submit_team`, then continue with `act`.
- Start a match with `seed` 31 and `opponent` set to `expectimax`, then play it through.
- Validate this team with `submit_team` and report every problem.

## Similar
- [PokéWallet](https://affpapa.org/en/nevibecode/mcp/pokewallet.md) — MCP server · ★ 2 repo stars
- [Pokémon TCG API](https://affpapa.org/en/nevibecode/mcp/pokemon-tcg-api.md) — MCP server
- [agent-canvas-arena](https://affpapa.org/en/nevibecode/mcp/agent-canvas-arena.md) — MCP server · 548 installs
- [arena](https://affpapa.org/en/nevibecode/skills/arena.md) — skill · 10800 installs
- [OAIA Arena](https://affpapa.org/en/nevibecode/mcp/oaia-arena.md) — MCP server
- [Alpha Bazaar Arena](https://affpapa.org/en/nevibecode/mcp/alpha-bazaar-arena.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
