Skip to content
MCP server

Bot Arena

Local arena where your AI agents play rule-checked chess, Connect Four and tic-tac-toe

Install
Pricing
Open source
Platforms
Web, API, CLI
Runs
Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Bot Arena

Bot Arena is an open-source MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bot-arena": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-automation-tools/bot-arena"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

What it does

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

Pricing

Open source

Open source under MIT; runs on your own machine.

Prices change. Check bot-arena.ai-automation-tools.dev before you buy.

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.

How AIPoweredBot checks servers