1
Add it to Claude Code
claude mcp add chess-mcp -- uvx --from git+https://github.com/Gelberm/chess-mcp.git chess2
Make your agent remember this setup
chess-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Fetch real-time Chess.com player profile information
- Retrieve detailed game statistics including ratings and win/loss records
- Access player metadata like country, URL, and online status
- Seamless integration with MCP-compatible clients like Claude Desktop
Tools 2
get_chess_player_profileFetches the profile information of a Chess.com player including ID, URL, name, followers, country, and last online status.get_chess_player_statsFetches the detailed statistics of a player including current ratings for rapid, blitz, bullet, and win/loss records.Try it
→What is the current rapid rating for the Chess.com user 'Hikaru'?
→Can you look up the profile details for 'MagnusCarlsen' and tell me their country and follower count?
→Compare the blitz and bullet ratings for the player 'GothamChess'.
→Is the player 'DanielNaroditsky' currently online?
Original README from Gelberm/chess-mcp
Chess.com MCP Server
A Model Context Protocol (MCP) server that provides tools to interact with the Chess.com Public API. This server enables LLMs (like Claude) to fetch real-time player profiles and statistics.
Features
This server exposes the following tools:
get_chess_player_profile(username: str): Fetches the profile information of a Chess.com player (e.g., ID, URL, name, followers, country, last online status).get_chess_player_stats(username: str): Fetches the detailed statistics of a player (e.g., current ratings for rapid, blitz, bullet, win/loss records).
Installation & Usage
You can use this server with any MCP-compatible client, such as the Claude Desktop App.
Method 1: Run directly from GitHub (Recommended)
You can run this server directly from the GitHub repository using uv (a fast Python package manager) without manually cloning the code.
Add the following configuration to your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"chess": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Gelberm/chess-mcp.git",
"chess"
]
}
}
}