Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • TMDB MCP Server
  • Fantasy Premier League MCP Server
  • YOKATLAS API MCP Server
  • Entscheidsuche MCP Server
  • Claude MCP Server
Back to MCP Servers
Chesscom MCP Server

Chesscom MCP Server

Public
pab1it0/chess-mcp

Provides standardized Model Context Protocol access to Chess.com’s public player profiles, game records, club information, and online status, enabling AI assistants to search, analyze, and interact with chess data without authentication.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with Chesscom MCP Server

MCP Server

Unlock the full potential of Chesscom MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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:

{ "mcpServers": { "chess": { "command": "docker", "args": [ "run", "--rm", "-i", "pab1it0/chess-mcp" ] } } }

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:

{ "mcpServers": { "chess": { "command": "uv", "args": [ "--directory", "", "run", "src/chess_mcp/main.py" ] } } }

Note: if you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path to uv or set the environment variable NO_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:

curl -LsSf https://astral.sh/uv/install.sh | sh

You can then create a virtual environment and install the dependencies with:

uv venv source .venv/bin/activate # On Unix/macOS .venv\Scripts\activate # On Windows uv pip install -e .

Testing

The project includes a test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

# Install development dependencies uv pip install -e ".[dev]" # Run the tests pytest # Run with coverage report pytest --cov=src --cov-report=term-missing

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


Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • TMDB MCP Server
    TMDB MCP Server

    Provides AI assistants with seamless access to The Movie Database API via Model Context Protocol, en...

    Added May 30, 2025
  • Fantasy Premier League MCP Server
    Fantasy Premier League MCP Server

    Provides comprehensive access to Fantasy Premier League data and tools via Model Context Protocol, e...

    Added May 30, 2025
  • YOKATLAS API MCP Server
    YOKATLAS API MCP Server

    Provides standardized Model Context Protocol (MCP) access to YÖKATLAS data, enabling programmatic se...

    Added May 30, 2025
  • Entscheidsuche MCP Server
    Entscheidsuche MCP Server

    Provides standardized access to Swiss legal decisions via the Model Context Protocol, enabling searc...

    Added May 30, 2025
  • Claude MCP Server
    Claude MCP Server

    Lightweight Model Context Protocol server enabling real-time web search integration with Claude AI u...

    Added May 30, 2025