Chess.com MCP Server
@pab1it0
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.
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).
