Chess.com

Chess.com

MCP server exposing Chess.com public data via standardized interfaces for AI search and analysis.

57
Stars
15
Forks
1
Releases

Overview

Built as a Model Context Protocol (MCP) server for Chess.com's Published Data API, this project exposes Chess.com public data through standardized MCP interfaces. It provides access to player data such as profiles and stats, as well as game records, and other publicly available information. It supports searching games by date and by player, checking whether a player is online, and retrieving information about clubs and titled players. No authentication is required, since the data comes from Chess.com's public API. The MCP server ships with docker containerization support and can also be run via UV, enabling flexible deployment for local development or integration into larger AI-assisted workflows. The tool set is configurable; developers can enable or disable individual tools to tailor the MCP client’s capabilities. Available tools include Player Information (get_player_profile, get_player_stats, is_player_online, get_titled_players), Games (get_player_current_games, get_player_games_by_month, get_player_game_archives, download_player_games_pgn), and Clubs (get_club_profile, get_club_members). The project includes a test suite and development instructions, and is MIT licensed.

Details

Owner
pab1it0
Language
Python
License
MIT License
Updated
2025-12-07

Features

Access player profiles, stats, and game records

Retrieve player profiles, statistics, and game records from Chess.com via MCP.

Search games by date and player

Query Chess.com game records by specific dates and by player.

Check player online status

Determine whether a given Chess.com player is currently online.

Get information about clubs and titled players

Fetch club information and lists of titled players.

No authentication required

Uses Chess.com's public API with no additional authentication.

Docker containerization support

Provides a Docker-based deployment option for easy setup.

Provide interactive tools for AI assistants

Offers configurable MCP tools tailored for AI assistant workflows.

Audience

AI assistantsLeverage Chess.com MCP data to search, analyze, and reason about players and games.
DevelopersIntegrate Chess.com MCP data into apps and tooling for clients.

Tags

Chess.compublic APIMCPModel Context ProtocolAI assistantsDockerUVgame dataplayer dataclubstitled players