Chess.com
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 info
What is Chess.com?
Chess.com is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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, allowin...
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 info
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server for Chess.com's Published Da
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx chess-com-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Chess.com
The Chess.com MCP Server connects AI assistants to Chess.com's public Published Data API, providing structured access to player profiles, statistics, live game data, historical game archives in PGN format, and chess club information — all without authentication. It exposes these capabilities as typed MCP tools, making it straightforward to ask an AI assistant to look up a player's rating history, download all games from a specific month, or retrieve the list of active titled players. Chess enthusiasts, coaches, and developers use it to bring Chess.com data directly into AI-powered analysis workflows.
Prerequisites
- Docker (recommended) or Python 3.10+ with uv installed
- An MCP-compatible client such as Claude Desktop or Claude Code
- No Chess.com API key required — the server uses the public API
Choose your installation method
The fastest path is Docker, which requires no Python setup. Alternatively, use uv to run the server from source.
# Docker (no setup needed beyond installing Docker):
docker pull pab1it0/chess-mcp
# Or install uv for the Python path:
curl -LsSf https://astral.sh/uv/install.sh | shClone the repository (uv method only)
If using uv instead of Docker, clone the source and set up the virtual environment.
git clone https://github.com/pab1it0/chess-mcp.git
cd chess-mcp
uv venv && source .venv/bin/activate
uv pip install -e .Configure Claude Desktop with Docker
Add the Docker-based configuration to claude_desktop_config.json. This requires no environment variables and pulls the image automatically.
{
"mcpServers": {
"chess": {
"command": "docker",
"args": ["run", "--rm", "-i", "pab1it0/chess-mcp"]
}
}
}Configure Claude Desktop with uv (alternative)
If you prefer running from source with uv, use the uv-based configuration instead of Docker.
{
"mcpServers": {
"chess": {
"command": "uv",
"args": ["--directory", "/full/path/to/chess-mcp", "run", "src/chess_mcp/main.py"]
}
}
}Restart Claude Desktop and verify
Quit and relaunch Claude Desktop. Ask Claude to retrieve a player profile to confirm the Chess.com tools are available.
Chess.com Examples
Client configuration
Docker-based configuration for claude_desktop_config.json — recommended because it requires no Python setup.
{
"mcpServers": {
"chess": {
"command": "docker",
"args": ["run", "--rm", "-i", "pab1it0/chess-mcp"]
}
}
}Prompts to try
Use these prompts to explore Chess.com player data, game archives, and club information through the MCP tools.
- "Look up the Chess.com profile for the player 'hikaru' and show me their current ratings in all time controls"
- "Get all of Magnus Carlsen's games from January 2024 and tell me his win/loss/draw record for that month"
- "List the current top titled players on Chess.com and their ratings"
- "Retrieve the member list for the Chess.com club 'chess-com-staff' and show me the top-rated members"Troubleshooting Chess.com
Docker image fails to start or Claude Desktop shows 'spawn error'
Ensure Docker Desktop is running before launching Claude Desktop. If using uv and seeing spawn errors, set NO_UV=1 in the env block of your config or specify the full absolute path to the uv binary (run 'which uv' to find it).
Player not found errors for valid Chess.com usernames
Chess.com usernames are case-sensitive in some API endpoints. Use the exact capitalization shown on the player's Chess.com profile page. Also verify the player has not changed their username.
Game archive requests time out for players with many games
Request archives one month at a time rather than asking for a full year at once. Use the get available monthly archives tool first to see what months are available, then fetch specific months.
Frequently Asked Questions about Chess.com
What is Chess.com?
Chess.com is a Model Context Protocol (MCP) server that 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 info It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Chess.com?
Follow the installation instructions on the Chess.com GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Chess.com?
Chess.com works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Chess.com free to use?
Yes, Chess.com is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Chess.com Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Chess.com? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Chess.com in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Chess.com?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.