Chess.com MCP Server
@pab1it0
About Chess.com MCP Server
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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"chess-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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).
Frequently asked questions
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).
Basic information
More Other MCP servers
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Awesome Mlops
visengerA curated list of references for MLOps
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
Comments