Chess.com MCP Server

A Model Context Protocol (MCP) 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.

https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757

Features

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
Provide interactive tools for AI assistants

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client.

Usage

Docker (Recommended)

The easiest way to run chess-mcp with Claude Desktop is using Docker. If you don't have Docker installed, you can get it from Docker's official website.

Edit your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Then add the following configuration:

{
  "mcpServers": {
    "chess": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "pab1it0/chess-mcp"
      ]
    }
  }
}

Running with UV

Alternatively, you can run the server directly using UV. Edit your Claude Desktop config file (locations listed above) and add the server configuration:

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

Note: if you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path to uv or set the environment variable NO_UV=1 in the configuration.

Development

Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

curl -LsSf https://astral.sh/uv/install.sh | sh

You can then create a virtual environment and install the dependencies with:

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

Testing

The project includes a test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

# Run with coverage report
pytest --cov=src --cov-report=term-missing

Available Tools

Player Information

get_player_profile - Get a player's profile from Chess.com
get_player_stats - Get a player's stats from Chess.com
is_player_online - Check if a player is currently online on Chess.com
get_titled_players - Get a list of titled players from Chess.com

Games

get_player_current_games - Get a player's ongoing games on Chess.com
get_player_games_by_month - Get a player's games for a specific month from Chess.com
get_player_game_archives - Get a list of available monthly game archives for a player on Chess.com
download_player_games_pgn - Download PGN files for all games in a specific month from Chess.com

Clubs

get_club_profile - Get information about a club on Chess.com
get_club_members - Get members of a club on Chess.com

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides access to Chess.com player data, game records, and public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.

Related MCP Servers

Lichess MCP
karayaman
A
security
A
license
A
quality
An MCP server that enables natural language interaction with the Lichess chess platform, allowing users to play games, analyze positions, manage their account, and participate in tournaments through Claude.
Last updated -
90
2
JavaScript
MIT License
Reddit MCP
GridfireAI
A
security
A
license
A
quality
A plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.
Last updated -
6
6
Python
MIT License
BoardGameGeek MCP Server
attilad
-
security
F
license
-
quality
An MCP server that integrates with the BoardGameGeek XML API, allowing Claude to search for board games, retrieve game details, and access user collections.
Last updated -
TypeScript
Dev.to MCP Server
Arindam200
A
security
A
license
A
quality
An MCP server implementation that allows AI assistants to access, search, and interact with Dev.to content, including fetching articles, retrieving user information, and publishing new content.
Last updated -
10
53
Python
MIT License

View all related MCP servers

Chess.com MCP Server