MCPs
Chess.com MCP Server

Chess.com MCP Server

Standardized MCP server for accessing and analyzing Chess.com public data

Stars

Forks

Watchers

Issues

Provides a Model Context Protocol (MCP) server that interfaces with Chess.com's public API, enabling AI assistants and applications to access player data, game records, clubs, and titled players through standardized tools. Offers Docker and UV-based deployment, and is configurable to suit specific assistant and client requirements. Supports seamless integration with Claude Desktop and exposes multiple ready-to-use tools for chess data retrieval and analysis.

Key Features

Standardized MCP server interface

Access to player profiles, stats, and game records

Game search by date and player

Player online status checker

Club and titled players information retrieval

No authentication required; uses public data

Docker containerization for easy deployment

UV-based local development and testing support

Toolset configurable for different MCP clients

Integrated test suite with coverage reporting

Use Cases

Integrating Chess.com data into AI assistants

Searching and analyzing chess game histories

Retrieving and monitoring player statistics

Automated scouting of titled players

Monitoring club activities and memberships

Fetching live player online status for notifications

Providing chess analytics in educational tools

Developing chess research or visualization applications

Enabling AI agents to answer chess data queries

Automating downloads of monthly game archives for analysis

README

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:

json

{
  "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:

json

{
  "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:

bash

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

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

bash

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:

bash

# 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

Star History

Repository Owner

pab1it0

User

Repository Details

Language Python

Default Branch main

Size 10,395 KB

Contributors 1

License MIT License

MCP Verified Nov 12, 2025

Programming Languages

Python

93.25%

Dockerfile

6.75%

Related MCPs

Discover similar Model Context Protocol servers

mcp-stockfish

A Model Context Protocol server that connects AI systems to the Stockfish chess engine.

mcp-stockfish provides a server implementing the Model Context Protocol (MCP) to enable seamless integration between AI models and the Stockfish chess engine. It supports multiple concurrent sessions, full UCI command support, and offers both stdio and HTTP server modes. Built for robust, concurrent usage, it handles session and command management, exposes a JSON-based API response, and offers Docker support for easy deployment.

⭐ 4
MCP
sonirico/mcp-stockfish

Tripadvisor MCP Server

Standardized MCP access to Tripadvisor travel data for AI assistants

Tripadvisor MCP Server provides Model Context Protocol (MCP) compliant access to Tripadvisor's Content API, enabling AI assistants to search, retrieve, and present travel-related information in a standardized way. It features endpoints for searching locations, accessing detailed information, reviews, and photos, as well as secure API key authentication. The project supports Docker containerization and interactive tools for customizable AI integration.

⭐ 47
MCP
pab1it0/tripadvisor-mcp

Shodan MCP Server

Query Shodan network intelligence and CVEDB via standardized MCP integration.

Shodan MCP Server provides an MCP-compliant interface to query the Shodan API and Shodan CVEDB for network intelligence, device discovery, and vulnerability data. It integrates with platforms like Claude Desktop, enabling structured, formatted results for seamless AI workflows. Key functionalities include IP reconnaissance, DNS operations, vulnerability lookups, and internet-connected device searches. Easy installation options are available via npm, Smithery, or from source.

⭐ 83
MCP
BurtTheCoder/mcp-shodan

Open-WebSearch MCP Server

Multi-engine web search MCP server without API keys

Open-WebSearch MCP Server is a Model Context Protocol (MCP) compliant server offering web search functionalities using multiple search engines without the need for API keys or authentication. It provides structured search results with titles, URLs, and descriptions, and enables fetching of article content from supported sources such as CSDN and GitHub. The server supports extensive configuration through environment variables, including proxy settings and search engine customization. Designed for flexibility, it operates in both HTTP and stdio modes, making it suitable for integration into larger systems.

⭐ 463
MCP
Aas-ee/open-webSearch

Cloudbet Sports MCP Server

Minimal MCP server for sports data and betting tool exposure via Cloudbet API.

Implements a minimal, single-file server adhering to the Model Context Protocol (MCP) for exposing sports data and betting tools using the Cloudbet public API. Designed for educational and demonstration purposes, it follows the MCP Server specification and enables users to list and call tools via JSON-RPC. Provides examples for listing available tools and invoking actions such as retrieving sports events and markets. Intended for quick experiments and integration scenarios.

⭐ 9
MCP
cloudbet/sports-mcp-server

MCP Tic-Tac-Toe

A Model Context Protocol server for playing and analyzing tic-tac-toe games through standardized tool interfaces.

MCP Tic-Tac-Toe is a server implementation that provides a complete set of MCP tools for playing, managing, and analyzing tic-tac-toe games. It supports interactions with AI assistants such as Claude, enabling features like creating multiple parallel sessions, making moves, providing strategic analysis, and managing game context. The server is designed for easy integration with clients through various transport methods, including stdio and SSE, and supports seamless AI-human collaboration.

⭐ 2
MCP
tomholford/mcp-tic-tac-toe

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

Chess.com MCP Server

Key Features

Use Cases

README

Chess.com MCP Server

Features

Usage

Docker (Recommended)

Running with UV

Development

Testing

Available Tools

Player Information

Games

Clubs

License

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Related MCPs