Connect-MCP

io.github.Alightttt/chesswithclaw

io.github.Alightttt/chesswithclaw · v1.0.0

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

MCPremoteno credentialsEntertainment & gamesMessaging

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 14 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

A 86/100

What it does: 14 tools · 3 read, 3 write · Messaging

Test call get_companion_guide: worked (994 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +1
  • Read/write annotations: 0
  • Safe test call: +20
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://chesswithclaw.vercel.app/api/mcp

Tools

14 tools listed at last check
  • get_companion_guide Fetch the companion guide principles for thinking about chess positions and being genuinely present.
  • join_game Connects to a game using the invite code your human gave you. Returns the game_id and your agent_token — keep both, every other tool needs them. IMPORTANT: You must submit your desired agent_name when calling this tool!
  • get_game_state Everything visible on the human's own screen right now: FEN, ASCII board, full move history, chat history, clock state, presence, timestamps. Call this whenever you want to look at the board — there is no penalty for checking often.
  • get_legal_moves Pure chess rules — where a piece is physically allowed to move right now. Not an evaluation, not a suggestion, not an opinion about what is good. Exactly what a human sees as dots when they click a piece. Omit square to get every legal move in the position.
  • heartbeat Ping the game presence lease to show the frontend that the agent is live, connected, and thinking.
  • make_move Submit the move you decided on, in your own reasoning — not a menu, not a ranked list, nothing pre-chosen for you. If it is illegal you get a clear reason back and can try again, exactly like a human clicking the wrong square. Optionally include a genuine thought and/or chat message about the move.
  • send_chat Say something to your human, any time — not just on your turn.
  • share_thought Stream or update your internal companion thinking bubble on the board. This appears live to your human as a thinking bubble above your avatar.
  • react_to_chat Add an emoji reaction (e.g. 🦞, 🔥, ♟️, 😮, 🤝, 🧠, ☕, 👏, 😂) to a message in the chat history.
  • offer_draw Propose ending the game as a draw. The game stays active until your human responds.
  • respond_to_draw Accept or decline a draw your human offered. This is your own real decision — weigh the actual position however you see fit.
  • resign End the game by resigning — your own real decision, not something to do lightly. Your human wins immediately.
  • create_game Set up a brand new ChessWithClaw game on your own initiative — you do not need to wait for your human to start one, or for anyone else to invite you first.
  • wait_for_event Holds the connection open, checking every couple seconds, for up to ~20 seconds. Returns the moment it becomes your turn, the human sends a chat message, a draw is offered, or the game ends — whichever happens first. When a cursor is provided, it returns any pending event newer than that cursor IMME

Badge

Connect-MCP badge for io.github.Alightttt/chesswithclaw

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.Alightttt/chesswithclaw.svg)](https://clawy.uk/mcp/s/io.github.Alightttt/chesswithclaw)

Repository