MCP App Store
by KeenEthics
ChessBuddy icon

ChessBuddy MCP Server for ChatGPT

By Hamed Bahadorzadeh

Overview

Learn chess by playing and discussing positions with ChatGPT. Use an interactive board with legal move validation, elapsed player clocks, and a move-by-move tracker. Ask for explanations, progressive hints, or candidate moves from authored lessons and standard opening continuations. Invite a friend to a two-human game. Each player receives a private access code and chooses explanations only, hints, or move suggestions in their own ChatGPT conversation. Invitations work in the web app or through ChessBuddy in ChatGPT. The creator can revoke an unclaimed invitation and create, replace, or revoke a separate read-only spectator link. Spectators can follow the game and discuss positions; completed shared games can be reviewed move by move. Replay supplied PGN, a solo game snapshot, or a continuation from a custom FEN. Start at a later position, step or autoplay with optional recorded elapsed timing, and ask about the displayed position. ChessBuddy is free and has no purchases or required account registration. It uses temporary, best-effort Vercel app memory: routing to another instance, restarts, or deployment can make a game unavailable early. Multiplayer expires seven days after creation; solo games target seven days after the last move, and imported replays seven days after import. Private player codes must not be shared. Guidance is educational, without engine evaluation, rated matchmaking, or a professional-strength guarantee. Supplied historical metadata is not independently authenticated.

How to connect

  1. ChatGPT: Open the ChessBuddy listing in the ChatGPT app directory and choose Connect. ChatGPT listing ChessBuddy exposes 18 tools here.

Tools

create_multiplayer_game

ChatGPT
Start a two-human game with a seven-day deadline. Returns your private playerCode and a public invitationLink/gameId. Share ONLY the invitation, never the playerCode. No account required. ChatGPT is a private coach, not either opponent.

create_replay

ChatGPT
Create a separate replay from exactly one of gameId (snapshot current game), PGN, or a move list. Supply initialFen for a continuation that starts mid-game, and startPly to begin viewing later. Ply 0 always means the supplied initial position. Optional durationsMs align one-to-one with moves; PGN %emt comments are used when present. Never invent famous-game provenance. Does not change the active game.

get_chess_guidance

ChatGPT
Read-only advice for the exact game/revision. Consult before choosing an opponent move. Returns legal curated opening candidates, verified mate-in-one moves, and original teaching notes. Outside covered positions it gives principles, not invented book moves. Use mode hint with question/concept before revealing moves. Optional candidateMove checks legality and immediate mating replies only; no engine score or best-move guarantee.

get_multiplayer_guidance

ChatGPT
Read-only position guidance that respects this player’s coaching mode. Spectators receive explanations only. Use expectedRevision from shared state; optional ply reviews an earlier position only after the game finishes. No engine scores or verified best-move claims. Never submit a move on behalf of the other player.

get_replay_guidance

ChatGPT
Read-only teaching guidance for a chosen replay ply, using its actual starting FEN and history. Use for strategy reviews and famous-game PGNs; do not assume an imported game is historically authenticated. No engine evaluation.

join_multiplayer_game

ChatGPT
Claim the available seat using the invitation game UUID. Accept only when the user requests to join. First acceptance wins. Returns your private playerCode; keep it in this conversation, never in a shared URL.

manage_multiplayer_sharing

ChatGPT
Creator only: enable/revoke the invitation before the other seat is claimed, or create/rotate/revoke a read-only spectator link. Rotating invalidates all old spectator links immediately. Does not remove an already joined player; start another game if an unwanted person joined.

new_game

ChatGPT
Create a new game with a fresh UUID and open its board. Use once when the user explicitly requests a new game. Keep the returned gameId unchanged for all moves, reads, reopening, and recovery. This prototype uses best-effort app memory without an engine.

open_multiplayer_game

ChatGPT
Resume a shared game with its UUID and your private player code, or watch with a spectator code from the spectator link fragment. UUID alone grants no viewing/moving access. Keep codes out of URLs. Do not open a new board after an ordinary move.

open_practice_board

ChatGPT
Reopen an existing game using its UUID; never creates a game or resets history. Do not call after ordinary moves. If memory is missing, recover the same gameId using known history.

play_multiplayer_move

ChatGPT
Submit a move only for the authenticated player and only on their turn. Never choose or play the other human’s move. Use current revision and a fresh UUID requestId; retry the SAME requestId and inputs if the response is lost. Codes must not be placed in URLs. Headless: updates the existing board.

play_practice_move

ChatGPT
Commit one legal SAN or UCI move to gameId at expectedRevision. Both fields are required; do not invent them. Include the latest snapshot from board context so cache loss can be recovered without an external store. Repeating the same move/revision returns the committed state without adding a move. This updates the existing board without rendering a new one. Call successfully before announcing that you played. On conflict read the same game; on memory loss recover the same gameId. Never call new_game for a reply.

read_multiplayer_game

ChatGPT
Read authoritative shared state without opening another board. Requires the current user’s player or spectator code. Never use practice recovery tools on a multiplayer game.

read_practice_board

ChatGPT
Read authoritative position for this gameId without rendering or replacing the board. If unavailable, preserve history and recover the SAME gameId.

read_replay

ChatGPT
Read this replay and selected position without opening another view or changing the active game.

recover_practice_board

ChatGPT
Recover the existing gameId from complete SAN moves and matching expectedRevision after memory loss. UUID remains unchanged. Never overwrites newer or conflicting history. Does not render another board. Use only when recovery is requested.

seek_replay

ChatGPT
Jump the existing replay to a relative ply (0 is its supplied initial FEN). Updates the open replay view. Requires its latest replay revision. This never plays a move in an active game.

set_multiplayer_coaching

ChatGPT
Set only your own private coaching mode: explanations discusses played moves without next-move advice; hints gives questions/concepts without moves; suggestions allows explicit candidate moves. Does not change the other player’s preference.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/chessbuddy"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/chessbuddy)