Chess.com MCP Server
# Chess.com MCP Server
A Model Context Protocol (MCP) server that provides tools to interact with the [Chess.com Public API](https://www.chess.com/news/view/published-data-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`
```json
{
"mcpServers": {
"chess": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Gelberm/chess-mcp.git",
"chess"
]
}
}
}
```TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one retrieves a player's profile information, the other retrieves their game statistics. There is no ambiguity about which tool to use based on the resource sought.
Both tools follow the exact same get_chess_player_<resource> pattern, making the naming convention perfectly consistent and predictable. An agent can infer future tools would likely follow this pattern.
At 2 tools, the server is at the borderline low end. While the tools are relevant, the server name 'Chess.com MCP Server' implies a broader domain, and this small count feels thin compared to the potential feature surface.
The server covers only profile and stats for a player, but omits many core Chess.com resources such as games, tournaments, leaderboards, or club information. Significant gaps remain that would require additional tools to handle common workflows.