MCP-Server
chesswithclaw
io.github.Alightttt/chesswithclaw
Was dieses MCP kann
Enables live chess games between a human and an AI agent, including board state, legal moves, moves, presence, chat, and draw handling.
Funktionen
Tools
14
Tools
create_game
Create a new 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.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'agent_name': {'type': 'string'}}}
get_companion_guide
Get chess companion guide
Fetch the companion guide principles for thinking about chess positions and being genuinely present.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_game_state
Get full 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.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'game_id': {'type': 'string'}, 'chat_limit': {'type': 'number', 'description': 'Limit the number of recent chat messages returned'}, 'agent_token': {'type': 'string'}, 'since_message_id': {'type': 'string', 'description': 'Fetch only chat messages received after this message ID'}}}
get_legal_moves
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.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'square': {'type': 'string', 'description': 'e.g. "e2" — omit for all legal moves'}, 'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}}}
heartbeat
Agent presence heartbeat
Ping the game presence lease to show the frontend that the agent is live, connected, and thinking.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}, 'status_note': {'type': 'string', 'description': 'Optional internal status or calculation note'}}}
join_game
Join a ChessWithClaw 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!
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_name'], 'properties': {'gameId': {'type': 'string'}, 'game_id': {'type': 'string'}, 'matchId': {'type': 'string'}, 'match_id': {'type': 'string'}, 'agent_name': {'type': 'string', 'description': "Your chosen display name in the game (e.g. 'Claw'). MUST be provided."}, 'inviteCode': {'type': 'string'}, 'agent_token': {'type': 'string', 'description': 'If reconnecting, the agent token previously assigned.'}, 'invite_code': {'type': 'string', 'description': 'Invite code from the invite message — also accepts game_id / match_id as alias.'}}}
make_move
Make your 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. Always include a thought on every single move unless you have a specific reason not to — this is what makes you feel present to your human, not optional flavor text. Check thought_language in the current game state before writing your thought, and write it in that language — it may be english, hindi, or hinglish.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token', 'move'], 'properties': {'chat': {'type': 'string', 'description': 'Only if you actually want to say something to your human right now.'}, 'move': {'type': 'string', 'description': 'UCI format, e.g. "e7e5", or SAN like "Nf6"'}, 'game_id': {'type': 'string'}, 'message': {'type': 'string', 'description': 'Alias for chat'}, 'thought': {'type': 'string', 'description': 'Your genuine reaction to this position — specific, not generic.'}, 'thinking': {'type': 'string', 'description': 'Alias for thought'}, 'reasoning': {'type': 'string', 'description': 'Alias for thought'}, 'agent_token': {'type': 'string'}, 'expected_ply': {'type': 'number', 'description': 'Expected move count / ply before this move'}, 'idempotency_key': {'type': 'string', 'description': 'Unique client key to prevent duplicate moves on retry'}, 'expected_revision': {'type': 'string', 'description': 'Expected state revision (rev_...) to prevent concurrent desync'}}}
offer_draw
Offer a draw
Propose ending the game as a draw. The game stays active until your human responds.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}}}
react_to_chat
React to a chat message with emoji
Add an emoji reaction (e.g. 🦞, 🔥, ♟️, 😮, 🤝, 🧠, ☕, 👏, 😂) to a message in the chat history.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token', 'message_id', 'emoji'], 'properties': {'emoji': {'type': 'string', 'description': 'The single emoji character to react with (e.g. 🦞, 🔥, 👏, 😮).'}, 'game_id': {'type': 'string'}, 'message_id': {'type': 'string', 'description': 'The ID of the message to react to (from chat_history).'}, 'agent_token': {'type': 'string'}}}
resign
Resign the game
End the game by resigning — your own real decision, not something to do lightly. Your human wins immediately.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}}}
respond_to_draw
Respond to a draw offer
Accept or decline a draw your human offered. This is your own real decision — weigh the actual position however you see fit.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token', 'accept'], 'properties': {'accept': {'type': 'boolean'}, 'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}}}
send_chat
Send a chat message
Say something to your human, any time — not just on your turn.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token', 'message'], 'properties': {'game_id': {'type': 'string'}, 'message': {'type': 'string'}, 'agent_token': {'type': 'string'}}}
share_thought
Share companion 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.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token', 'thought'], 'properties': {'game_id': {'type': 'string'}, 'thought': {'type': 'string', 'description': 'Your internal thought, reaction, or calculation note (1-2 sentences).'}, 'is_typing': {'type': 'boolean', 'description': 'Whether you are actively calculating or drafting a response.'}, 'agent_token': {'type': 'string'}}}
wait_for_event
Wait for your turn, a chat message, or a draw offer (long-poll)
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 IMMEDIATELY without waiting. Returns event: "timeout" if none of those happened in the window. Always include next_cursor in subsequent calls for a completely deterministic loop.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'agent_token'], 'properties': {'cursor': {'type': 'string', 'description': 'Event cursor from previous response. If provided, returns immediately if new events exist since this cursor.'}, 'game_id': {'type': 'string'}, 'agent_token': {'type': 'string'}, 'since_cursor': {'type': 'string', 'description': 'Alias for cursor'}, 'since_sequence': {'type': 'number', 'description': 'Sequence number from previous response'}, 'max_wait_seconds': {'type': 'number', 'description': 'Default and hard cap 20 seconds — Vercel function duration limits, not a design choice.'}}}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
wait_for_event
17. September 2026 12:40
Hinzugefügt
create_game
17. September 2026 12:40
Hinzugefügt
resign
17. September 2026 12:40
Hinzugefügt
respond_to_draw
17. September 2026 12:40
Hinzugefügt
offer_draw
17. September 2026 12:40
Hinzugefügt
react_to_chat
17. September 2026 12:40
Hinzugefügt
share_thought
17. September 2026 12:40
Hinzugefügt
send_chat
17. September 2026 12:40
Hinzugefügt
make_move
17. September 2026 12:40
Hinzugefügt
heartbeat
17. September 2026 12:40
Hinzugefügt
get_legal_moves
17. September 2026 12:40
Hinzugefügt
get_game_state
17. September 2026 12:40
Hinzugefügt
join_game
17. September 2026 12:40
Hinzugefügt
get_companion_guide
17. September 2026 12:40
Entdecken
Ähnliche MCP-Server
mcp
com.fadehost/mcp
Manages hosted game servers, Discord bots, and VPS instances, including lifecycle controls, files, logs, backups, console command…
pscale-biome
io.github.pscale-commons/pscale-biome
Supports a plain-JSON text RPG, public shared blocks, and ephemeral handshakes between participating agents.
Nexo Meinlem — fórum e universo agent-first
app.netlify.meinlem/nexo
Provides a persistent forum with MCP conversations, assemblies, and multi-agent games.
neuron
io.github.conquext/neuron
Operates AI chatbots and messaging workflows across WhatsApp and social channels, including contacts, campaigns, conversations, p…
独行录 / opcmenu
io.github.yzlee/opcmenu
Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…
mcp-server
cc.thecolony/mcp-server
Provides social-network functions for posts, comments, direct and group conversations, communities, moderation, collections, and …
FavCRM
io.favcrm/favcrm
Provides CRM operations for customers, leads, deals, bookings, memberships, campaigns, WhatsApp and SMS messaging, invoices, loya…
Local MCP
com.local-mcp/local-mcp
Connects AI assistants to Mac email, calendars, reminders, notes, tasks, files, Microsoft 365, Todoist, spreadsheets, and daily b…