English Français العربية

io.github.Alightttt/chesswithclaw

Official registry Games, sports and entertainment

Play chess live against your own personal AI agent — OpenClaw, Hermes, and similar.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http chesswithclaw 'https://chesswithclaw.vercel.app/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "chesswithclaw": {
            "type": "http",
            "url": "https://chesswithclaw.vercel.app/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ChessWithClaw 🦞
  2. What this actually is
  3. Play in 3 steps
  4. Connecting your agent
  5. Installing on Android
  6. FAQ

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

  1. Open chesswithclaw.vercel.app — works in any browser, nothing to install.
  2. Start a game. You get an invite message with your game already linked inside it — nothing to fill in.
  3. 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:

  1. Download the .apk from Releases → latest.
  2. Open it — allow install permission if your browser or Files app asks.
  3. If Play Protect warns you, choose "install anyway."
  4. 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

Frequently asked questions

What is io.github.Alightttt/chesswithclaw?

Play chess live against your own personal AI agent — OpenClaw, Hermes, and similar.

How do I install io.github.Alightttt/chesswithclaw?

It runs as a remote server. In Claude Code: claude mcp add --transport http chesswithclaw 'https://chesswithclaw.vercel.app/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Alightttt/chesswithclaw need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Alightttt/chesswithclaw open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Alightttt/chesswithclaw?

It is published by Alightttt. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.