Integrations
Provides access to Chess.com player data, profiles, statistics, game records, online status checks, club information, and titled player lists through Chess.com's Published Data API.
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:
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 see
Error: spawn uv ENOENT
in Claude Desktop, you may need to specify the full path touv
or set the environment variableNO_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:
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.comget_player_stats
- Get a player's stats from Chess.comis_player_online
- Check if a player is currently online on Chess.comget_titled_players
- Get a list of titled players from Chess.com
Games
get_player_current_games
- Get a player's ongoing games on Chess.comget_player_games_by_month
- Get a player's games for a specific month from Chess.comget_player_game_archives
- Get a list of available monthly game archives for a player on Chess.comdownload_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.comget_club_members
- Get members of a club on Chess.com
License
MIT
You must be authenticated.
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
- AsecurityAlicenseAqualityAn 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 -902JavaScriptMIT License
- -securityAlicense-qualityMCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.Last updated -216PythonMIT License
- AsecurityAlicenseAqualityA plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.Last updated -66PythonMIT License
- -securityFlicense-qualityAn 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