README.md
Interact with the Chess.com Public API for player profiles and statistics.
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"
]
}
}
}
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.Configuration
claude_desktop_config.json
{"mcpServers": {"chess": {"command": "uvx", "args": ["--from", "git+https://github.com/Gelberm/chess-mcp.git", "chess"]}}}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?