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