The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Chess.com MCP Server listing page.
A Model Context Protocol server written in TypeScript for Chess.com's public API. It exposes the complete documented Chess.com PubAPI through 30 tools and seven resources without authentication.
Requirements: Node.js 20.9 or newer.
Run the latest published package directly:
The default transport is stdio. The package is distributed through npm and can also be installed from the VS Code MCP gallery after its registry metadata is published.
For VS Code, create or open .vscode/mcp.json in your workspace:
After publication, search for @mcp chess in VS Code and select Install to add the server from the MCP gallery.
For Claude Desktop, add the server to its MCP configuration:
Requirements: Node.js 20.9 or newer.
The default source-run transport is stdio. To run the optional SSE transport:
The SSE server listens on port 8000 by default and provides /sse, /messages, and /health. Set PORT and HOST to override those defaults.
Set CHESS_API_BASE_URL to override the Chess.com API base URL for development or testing.
Run the test suite and type checker:
Create a coverage report with:
get_player_profileget_titled_playersget_player_statsis_player_onlineget_player_current_gamesget_player_games_to_moveget_player_game_archivesget_player_games_by_monthget_player_live_gamesdownload_player_games_pgnget_player_clubsget_player_matchesget_player_tournamentsget_club_profileget_club_membersget_club_matchesget_tournamentget_tournament_roundget_tournament_round_groupget_team_matchget_team_match_boardget_live_team_matchget_live_team_match_boardget_country_profileget_country_playersget_country_clubsget_daily_puzzleget_random_puzzleget_streamersget_leaderboardschess://player/{username}chess://player/{username}/statschess://player/{username}/games/currentchess://player/{username}/games/{year}/{month}chess://player/{username}/games/{year}/{month}/pgnchess://titled/{title}chess://club/{url_id}MIT