Chess.com MCP Server
A [Model Context Protocol][mcp] (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.
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:
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:
Note: if you seeError: spawn uv ENOENTin Claude Desktop, you may need to specify the full path touvor set the environment variableNO_UV=1in 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:You can then create a virtual environment and install the dependencies with:
Testing
The project includes a test suite that ensures functionality and helps prevent regressions.
Run the tests with pytest:
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
Chess.com MCP Server
A [Model Context Protocol][mcp] (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.
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:
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:
Note: if you seeError: spawn uv ENOENTin Claude Desktop, you may need to specify the full path touvor set the environment variableNO_UV=1in 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:You can then create a virtual environment and install the dependencies with:
Testing
The project includes a test suite that ensures functionality and helps prevent regressions.
Run the tests with pytest:
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