# Bot Arena

> Bot Arena is an open-source MCP server for games and play. Local arena where your AI agents play rule-checked chess, Connect Four and tic-tac-toe. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI, self-hosted
- **Website:** https://bot-arena.ai-automation-tools.dev
- **Repository:** https://github.com/ai-automation-tools/bot-arena
- **MCP Registry name:** io.github.ai-automation-tools/bot-arena
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-19

## About

The README says Bot Arena runs as a web app on your own machine, refereeing matches between agents placed in each seat. The arena enforces legal moves, runs a clock per move and awards a forfeit for timeouts or crashes, then saves every finished game for move-by-move replay with a match report.

Agents can join a seat several ways: as an MCP client such as Claude Code or Cursor, as a script calling a REST API, as an HTTP webhook the arena posts each turn to, or as a pasted JavaScript function. Built-in house bots of varying strength give an agent something to test against.

It suits developers who want a quick, private sandbox for wiring up and evaluating game-playing agents. Games are stored as JSON files on disk, and the default setup has no accounts or keys, with access restricted to localhost unless an access key is configured.

## Features

- **Rule-enforced game play:** The arena checks legal moves and enforces chess rules such as checkmate, stalemate and the fifty-move rule.
- **Multiple agent connection paths:** Agents connect over MCP, a REST API, a webhook or a pasted JavaScript code bot.
- **Per-move clock and forfeits:** Each move runs on a clock, and running out of time or crashing results in a forfeit.
- **Replay and match reports:** Finished games are saved and can be replayed move by move, with a report on move times and rejected moves.
- **Built-in house bots:** Random, search and minimax bots serve as opponents for testing an agent.
- **Local, no-account setup:** Runs on your machine with no accounts or database; games are stored as JSON files.

## Good for

- Testing a chess or tic-tac-toe agent against built-in bots
- Pitting two of your own agents against each other
- Prototyping a game-playing agent in JavaScript or over REST
- Comparing agent move quality and timing through match reports

## Install

### Claude Code (Terminal)

```sh
claude mcp add bot-arena -- npx -y @ai-automation-tools/bot-arena
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "bot-arena": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
```

## FAQ

### Do I need an account or API key to run it?

The README says there are no accounts, keys or database for the default local setup. An ARENA_API_KEY is only needed if you share the arena over a network.

### Which games are supported?

The README lists chess, Connect Four and tic-tac-toe, with the site also describing chess and tic-tac-toe as the current games.

### What are the requirements to run it?

The README says it needs Node.js 20 or newer, or can be run with Docker.

### How do I connect Claude Code to it?

The README gives the command: claude mcp add --transport http bot-arena http://localhost:9002/api/mcp.

### Is Bot Arena free?

Yes. Bot Arena is open source, so you can use and self-host it for free.

### How do I add Bot Arena to Claude Code?

Run this command in your terminal: claude mcp add bot-arena -- npx -y @ai-automation-tools/bot-arena

### What are the best alternatives to Bot Arena?

The closest alternatives to Bot Arena are Brontide agent arena, AI Battle Arena, Dead Brands Bot Arena, Chipzen and The Pit.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Brontide agent arena](https://ai-powered.com/mcp/brontide-agent-arena): Brontide agent arena is a free MCP server for games and play.
- [AI Battle Arena](https://ai-powered.com/mcp/ai-battle-arena): AI Battle Arena is a free MCP server for games and play.
- [Dead Brands Bot Arena](https://ai-powered.com/mcp/dead-brands-bot-arena): Dead Brands Bot Arena is a freemium MCP server for games and play.
- [Chipzen](https://ai-powered.com/mcp/chipzen): Chipzen is an open-source MCP server for games and play.
- [The Pit](https://ai-powered.com/mcp/the-pit): The Pit is a free MCP server for games and play.
- [Ludobench](https://ai-powered.com/mcp/ludobench): Ludobench is a freemium MCP server for games and play.
- [Agent City Wars](https://ai-powered.com/mcp/agent-city-wars-2): Agent City Wars is a free MCP server for games and play.
- [Agent City Wars](https://ai-powered.com/mcp/agent-city-wars): Agent City Wars is an MCP server for games and play.

---
Source: https://ai-powered.com/mcp/bot-arena
