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