wenjiavv

Cascadero — AI skill for Claude Code

AI community

卡斯卡德罗 · Cascadero MCP — an MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Codex CLI…) play the board game Cascadero against built-in bots through text tool calls.

How to install Cascadero

This entry records only its repository, not the path inside it, so there is no exact command to give. Open wenjiavv/cascadero and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Cascadero does

卡斯卡德罗 · Cascadero MCP — an MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Codex CLI…) play the board game Cascadero against built-in bots through text tool calls. Same repo: the browser game, the self-play + value-net AI stack behind the bots, a private table server. Unofficial, non-commercial fan project.

Alternatives in AI

  • Hexstrike AI — HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomousl 8.2k ★
  • Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★
  • Paca — AI-native, free, open-source alternative to Jira, Trello, ClickUp & Monday 1.8k ★

README

Cascadero MCP — let an AI agent play a board game through tool calls

**[中文说明 → README.zh-CN.md](README.zh-CN.md)**

![MCP stdio](https://img.shields.io/badge/MCP-stdio-blue) ![Node.js 20+](https://img.shields.io/badge/node-%3E%3D20-brightgreen) ![License MIT](https://img.shields.io/badge/license-MIT-lightgrey) ![Unofficial fan project](https://img.shields.io/badge/status-unofficial%20fan%20project-orange)

`mcp/` is a [Model Context Protocol](https://modelcontextprotocol.io) server that lets Claude Code, Claude Desktop, Cursor, Codex CLI or any other MCP client play complete games of *Cascadero* (卡斯卡德罗, the hex route-building board game by Reiner Knizia) against built-in bots — through plain text tool calls, no screen capture, no vision model. The agent reads the position as text, sees the exact outcome of every legal move, answers the decisions the rules engine asks for, and any illegal answer is refused with the reason.

Everything the server stands on lives in the same repository: the browser game (one HTML file), the three bot levels and the AI stack that trained them (self-play, a learned value network, a paired-duel evaluation harness), and a private table server for friends. This is an unofficial, non-commercial fan project — see [Legal notice](#legal-notice) and [NOTICE.md](NOTICE.md).

![Claude Code playing Cascadero through the MCP server](mcp/docs/claude-code-en.png)

Get an agent playing

git clone https://github.com/wenjiavv/cascadero.git
cd cascadero/mcp && npm install && npm run build       # Node 20+; the build step needs python3 (generates ../online/engine.js)
claude mcp add cascadero -- node "$PWD/src/index.mjs"   # Claude Code

Claude Desktop, Cursor and Codex CLI point at the same `node …/mcp/src/index.mjs` command from their JSON or TOML config — copy-paste snippets are in [mcp/README.md](mcp/README.md#install). Set `CASC_MCP_LANG=zh` for a Chinese game log and handbook.

Then tell the agent:

Play a game of Cascadero against