Chess.com MCP Server

What does “Chess.com” MCP Server do?

The Chess.com MCP Server is a Model Context Protocol (MCP) server designed to interface with Chess.com’s Published Data API. It enables AI assistants and developer tools to access public Chess.com player profiles, statistics, and game records via standardized MCP interfaces. By bridging Chess.com’s public API with the MCP ecosystem, this server allows AI clients to search, analyze, and interact with chess data programmatically. Typical use cases include querying player information, searching historical games, checking player statuses, and retrieving club or titled player details. The server is designed for easy integration, requires no authentication (leveraging Chess.com’s public endpoints), and supports containerized deployment for fast setup in development workflows.

List of Prompts

No prompt templates are mentioned in the available documentation or repository files.

List of Resources

No explicit MCP resources are listed in the documentation or visible files.

List of Tools

• get_player_profile
  Get a player’s profile from Chess.com. This tool fetches detailed information about an individual user’s public profile, including ratings, account details, and more.

Use Cases of this MCP Server

• Player Profile Lookup:
  Instantly fetch up-to-date player profiles (ratings, country, status) for any Chess.com username, aiding tools and assistants in providing accurate chess player data.
• Game Record Retrieval:
  Search and retrieve historical games played by specific users, enabling in-depth analysis, statistics, or replay for coaching and training purposes.
• Player Status Checking:
  Determine if a player is currently online or offline, useful for real-time applications or creating live chess-related features.
• Club and Titled Player Information:
  Access club rosters or lists of titled players, assisting in organizing events, generating reports, or discovering notable chess personalities.
• Integrating Chess Data in AI Workflows:
  Use as a backend for AI-powered agents that offer chess coaching, game review, or player comparison.

How to set it up

Windsurf

No setup instructions or configuration examples for Windsurf are provided in the documentation or repository.

Claude

1. Install Docker (if not already installed):
   Download from Docker’s official website.
2. 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
3. Add the following configuration:

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

4. Save and restart Claude Desktop.
5. Verify the MCP server is available in Claude’s tool interface.

Cursor

No setup instructions or configuration examples for Cursor are provided in the documentation or repository.

Cline

No setup instructions or configuration examples for Cline are provided in the documentation or repository.

Securing API Keys

• Note: The Chess.com MCP Server does not require authentication or API keys, as it exclusively uses Chess.com’s public API.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "chess": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “chess” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the tables above, the Chess.com MCP Server provides a solid single-purpose integration with clear documentation for Claude setup and at least one available tool, but lacks prompt templates, explicit resources, and broader MCP features like Roots or Sampling.

Our opinion

The Chess.com MCP Server is straightforward and valuable for chess-related AI integrations, but limited in breadth and MCP extensibility. It would benefit from more tools, prompt templates, and explicit resource definitions. Given the information provided and its current scope, it is a functional but basic MCP server.

MCP Score