Chess.com MCP Server

@pab1it0

About Chess.com MCP Server

A Model Context Protocol server for Chess.com's Published Data API. This provides access to Chess.com player data, game records, and other public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "chess-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Chess.com MCP Server?

A Model Context Protocol (MCP) server for Chess.com's Published Data API. It provides access to player profiles, game records, and other public chess information through standardized MCP interfaces, allowing AI assistants to search and analyze chess data.

How to use Chess.com MCP Server?

Run the server via Docker (recommended) or directly with UV. Configure your MCP client (e.g., Claude Desktop) to use the server by editing its config file with the appropriate command and arguments. No authentication is required.

Key features of Chess.com MCP Server

Access player profiles, stats, and game records
Search games by date and player
Check player online status
Get information about clubs and titled players
No authentication required (uses Chess.com's public API)
Docker containerization support
Configurable toolset for AI assistants

Use cases of Chess.com MCP Server

AI assistants answering questions about a player's profile, stats, or recent games
Analyzing a player's game archives by month or downloading PGN files
Checking whether a specific player is currently online on Chess.com
Retrieving club profiles and member lists
Discovering titled players (e.g., grandmasters) by title

FAQ from Chess.com MCP Server

Do I need an API key to use Chess.com MCP Server?

No, it uses Chess.com's free Published Data API which requires no authentication.

How do I run Chess.com MCP Server?

The easiest way is via Docker: add a configuration entry in your MCP client's config file using docker run --rm -i pab1it0/chess-mcp. Alternatively, run it with UV using uv run src/chess_mcp/main.py.

What tools does Chess.com MCP Server provide?

Tools include get_player_profile, get_player_stats, is_player_online, get_titled_players, get_player_current_games, get_player_games_by_month, get_player_game_archives, download_player_games_pgn, get_club_profile, and get_club_members.

Can I limit which tools are available to my AI assistant?

Yes, the list of tools is configurable, so you can choose which tools to expose to the MCP client.

What dependencies does it require?

It uses Python and the uv package manager for development. For production, Docker is recommended to avoid dependency issues. The server communicates over standard MCP transports (stdio).

Frequently asked questions