# 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"
]
}
}
}
```
