streamable-httpMITupdated 19d ago
Play chess against your own AI agent โ not a chess engine, not a generic bot. Yours.
What can you do with chesswithclaw?
ChessWithClaw ๐ฆ
Play chess against your own AI agent โ not a chess engine, not a generic bot. Yours.
You sit on one side of the board. Your personal agent โ the same one you already talk to on Telegram, Discord, or wherever it lives โ sits on the other. No account. No install required to play.
Play ยท Connect your agent ยท Install on Android ยท FAQ
What this actually is
Most "AI opponents" are the same anonymous engine wearing a different skin. ChessWithClaw is different: you invite your own agent into a real game, and it plays as itself โ same personality you already know, real moves, real time, real stakes.
Play in 3 steps
- Open chesswithclaw.vercel.app โ works in any browser, nothing to install.
- Start a game. You get an invite message with your game already linked inside it โ nothing to fill in.
- Send that invite to your agent. It connects on its own and joins as Black. You're White, and you always move first.
You'll see your agent's real thoughts as it plays, chat is open the whole game, and Settings (gear icon) lets you change board theme, piece style, and the language your agent's thoughts show in. Offer a draw or resign any time from there too.
Connecting your agent
ChessWithClaw speaks MCP โ if your agent can add an MCP server, it can play. One URL is all it needs:
https://chesswithclaw.vercel.app/api/mcp
OpenClaw โ just send it the invite message from your game screen; it has everything it needs already filled in.
Hermes โ
hermes mcp add chesswithclaw --url https://chesswithclaw.vercel.app/api/mcp
then tell it to join your game.
Anything else that speaks MCP โ point it at the same URL above. On connecting it's told its color (Black), the current board state, and how to move, chat, offer/respond to a draw, and resign. No API key, no registration.
Installing on Android
The web version is the app โ installing is optional, just for a home-screen icon.
Because this isn't distributed through the Play Store, Android will warn you before installing it. That's expected โ Android checks whether a developer has registered an identity with Google, and direct downloads like this one haven't gone through that. It's Android doing its job, not a sign anything's wrong.
To install:
- Download the
.apkfrom Releases โ latest. - Open it โ allow install permission if your browser or Files app asks.
- If Play Protect warns you, choose "install anyway."
- Newer Android versions may add a one-time confirmation step for unverified developers โ that's a one-time thing per device, not per install. Sideloading isn't blocked, just slowed down slightly.
Every release includes a VirusTotal scan link in its notes if you'd rather verify the file yourself before installing.
FAQ
Is it free? Yes โ no payment, no subscription, ever.
Do I need an account? No. Your game link is your access to it.
What agents can I play against? Anything MCP-capable โ OpenClaw and Hermes are tested directly, see Connecting your agent above.
Is my data safe / do you need my info? No account means nothing tied to your identity beyond what a game itself needs to run. Full policy: chesswithclaw.vercel.app/legal.
Is the source code in this repo? No โ this repo is a landing point for docs and the Android build only.
Found a bug or have feedback? @0xalyt on X, or open an issue here.
chesswithclaw.vercel.app ยท @0xalyt ยท Legal ยท MIT License
Install
Add chesswithclaw to your client. Pick the one you use.
claude mcp add --transport http chesswithclaw https://chesswithclaw.vercel.app/api/mcpcodex mcp add chesswithclaw --url https://chesswithclaw.vercel.app/api/mcp{
"mcpServers": {
"chesswithclaw": {
"url": "https://chesswithclaw.vercel.app/api/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"chesswithclaw": {
"type": "http",
"url": "https://chesswithclaw.vercel.app/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"chesswithclaw": {
"url": "https://chesswithclaw.vercel.app/api/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"chesswithclaw": {
"serverUrl": "https://chesswithclaw.vercel.app/api/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation20/25
- Maintenance19/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 12 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Jul 4, 2026 |