Exposes Chess.com player profiles, game archives, statistics, puzzles, and tournament data through the public API.
Also known as udarrr/chess-mcp-node, chess-mcp-node
- Stars
- 0
- Tools
- 30
- Downloads, 30 days
- —
- Latest version
- 0.8.8
- Last commit
- Sep 22, 2026
- License
- MIT
What is Chess.com MCP?
Chess.com exposes Chess.com player profiles, game archives, statistics, puzzles, and tournament data through the public API. It exposes 30 tools, such as get_player_profile, get_titled_players, get_player_stats.
Summary generated from the project's README
About Chess.com MCP server
Analyzing chess player performance and game history through an AI client is possible with the Chess.com MCP Server. This TypeScript-based server connects to the public Chess.com API to provide detailed access to player profiles, game archives, statistics, and tournament data. It functions without requiring any authentication or API keys, making it easy to integrate into your existing workflows.
Developers can set this up locally using stdio via npx or through an SSE transport on port 8000. It is compatible with Claude Desktop and VS Code by adding the server to your configuration files. The server provides 30 specific tools, such as get_player_stats and get_player_game_archives, alongside seven resources like chess://player/{username}/stats for direct data access. This allows an AI to retrieve everything from daily puzzles to specific tournament rounds and club memberships.
Written from the project's README. Every use case is checked against a quote from it.
How to install Chess.com MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Chess.com MCP in Claude Code
$ claude mcp add chess-mcp-node -- npx -y chess-mcp-nodeInstall Chess.com MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"chess-mcp-node": {
"command": "npx",
"args": [
"-y",
"chess-mcp-node"
]
}
}
}Install Chess.com MCP in VS Code
.vscode/mcp.json
{
"servers": {
"chess-mcp-node": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chess-mcp-node"
]
}
}
}Install Chess.com MCP in VS Code CLI
$ code --add-mcp '{"name":"chess-mcp-node","type":"stdio","command":"npx","args":["-y","chess-mcp-node"]}'Install Chess.com MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"chess-mcp-node": {
"command": "npx",
"args": [
"-y",
"chess-mcp-node"
]
}
}
}Install Chess.com MCP in Codex
$ codex mcp add chess-mcp-node -- npx -y chess-mcp-nodeInstall Chess.com MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.chess-mcp-node] command = "npx" args = ["-y", "chess-mcp-node"]
Install Chess.com MCP in Gemini CLI
$ gemini mcp add -s user chess-mcp-node npx -- -y chess-mcp-nodeInstall Chess.com MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"chess-mcp-node": {
"command": "npx",
"args": [
"-y",
"chess-mcp-node"
]
}
}
}Chess.com MCP tools 30
Detected from the READMEget_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_matches
Show all 30 toolsShow fewer tools
get_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_leaderboards
Configuration
MCP_TRANSPORT
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableudarrr/chess-mcp-node is public and reachablegithub.com/udarrr/chess-mcp-node ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-22github.com/udarrr/chess-mcp-node ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from chess-mcp-nodePass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model30 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubChess.com MCP Server
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.
Install from npm
Requirements: Node.js 20.9 or newer.
Run the latest published package directly:
npx -y chess-mcp-node@latest
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:
{
"servers": {
"chess": {
"command": "npx",
"args": ["-y", "chess-mcp-node@latest"]
}
}
}
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:
{
"mcpServers": {
"chess": {
"command": "npx",
"args": ["-y", "chess-mcp-node@latest"]
}
}
}
Run from source
Requirements: Node.js 20.9 or newer.
npm ci
npm run build
npm start
The default source-run transport is stdio. To run the optional SSE transport:
# macOS/Linux
MCP_TRANSPORT=sse npm start
# Windows PowerShell
$env:MCP_TRANSPORT = "sse"
npm start
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.
Development
Run the test suite and type checker:
npm test
npm run typecheck
Create a coverage report with:
npm run test:coverage
Available tools
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_leaderboards
Available resources
chess://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}
License
MIT
Chess.com MCP questions
How do I add Chess.com MCP to Claude Code?
Run claude mcp add chess-mcp-node -- npx -y chess-mcp-node in your terminal. Add --scope user to make it available in every project.
How do I add Chess.com MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Chess.com MCP provide?
It exposes 30 tools, including get_player_profile, get_titled_players, get_player_stats, is_player_online, get_player_current_games.
Does this server require authentication?
No, the server provides access to the Chess.com PubAPI without authentication.
What are the requirements to install this server?
You need Node.js version 20.9 or newer to run the package.