# Chess.com Global Intelligence MCP MCP

> Chess.com Global Intelligence gives your AI agent deep access to official chess data. It lets you track player ratings across Blitz, Bullet, and Rapid formats, audit full match histories (PGN), and identify top players globally. Need to run a tournament analysis or study opening theory? Your agent handles the research instantly.

## Overview
- **Category:** education
- **Price:** Free
- **Tags:** chess-api, grandmaster-stats, chess-puzzles, elo-rankings, match-archives

## Description

This MCP provides direct intelligence from Chess.com's database, letting your agent act like a professional chess analyst. You can pull current player ratings for any account, access full match records for deep technical review, and fetch today's official daily puzzle. Instead of navigating dozens of web pages or running manual API calls, you just ask your client to analyze the data.

If you’re building a complex coaching tool, this intelligence is key. You can even combine this MCP with others—say, chaining it with an accounting system MCP and a messaging MCP through Vinkius. The agent analyzes player ratings using one service, then formats a report using another, and sends the result via message—all while Vinkius handles all the security rules and passes credentials through a zero-trust proxy so your keys never sit on disk. You get deep data analysis without touching infrastructure code.

## Tools

### get_chess_club_details
Retrieves metadata about a specific chess club by its identifier.

### get_country_details_chess
Fetches details for a specific country using its two-letter ISO code.

### get_daily_chess_puzzle
Retrieves the current official, featured daily chess puzzle.

### get_global_leaderboards
Gets a list of top player rankings across all major formats and regions.

### get_player_game_archives
Lists the available monthly archives containing historical games for any specified user.

### get_player_monthly_games
Pulls all specific chess games played by a user within a defined month.

### get_player_profile
Retrieves basic identifying and biographical information about a Chess.com player account.

### get_player_stats
Gets detailed current ratings, win/loss statistics, and performance metrics for an individual player.

### get_random_chess_puzzle
Provides a random chess tactic puzzle from the general training database.

### get_tournament_metadata
Retrieves specific organizational details for any listed tournament event.

### list_active_streamers
Lists currently active Chess.com streamers and their profiles.

### list_titled_players
Finds all players who hold a specific professional title, like Grandmaster (GM) or International Master (IM).

## Prompt Examples

**Prompt:** 
```
Analyze the current ratings and winrate for 'MagnusCarlsen'.
```

**Response:** 
```
Inspecting Grandmaster stats... Magnus Carlsen is currently rated 2890 in Blitz and 2810 in Rapid. He has a dominant winrate across all formats. Would you like to see his best historical rating or his last 5 match results?
```

**Prompt:** 
```
Show me today's daily chess puzzle and its title.
```

**Response:** 
```
Retrieving the daily tactic... Today's puzzle is titled 'Deflection in the Endgame'. I have the official URL and the board image preview for you. Shall I check for a random training puzzle as well?
```

**Prompt:** 
```
List the top 5 players in the global Blitz leaderboard.
```

**Response:** 
```
Running leaderboard query... The top 5 Blitz players are currently MagnusCarlsen, Hikaru, Firouzja2003, NihalSarin, and DanielNaroditsky. All hold the GM title. Would you like to see the Rapid or Bullet rankings?
```

## Capabilities

### Audit Player Performance
Get basic profile information, current ratings (ELO), win/loss records, and detailed stats for any chess account.

### Research Game History
Access complete monthly archives of past games to analyze specific opening patterns or opponent tendencies.

### Identify Top Players
Query global leaderboards for all major chess formats and list players holding professional titles like GM or IM.

### Train on Tactics
Fetch the current official daily puzzle, or request random tactics for training your agent's educational modules.

## Use Cases

### Auditing a Grandmaster's recent form
A coach needs to know if Magnus Carlsen's current performance matches his historical peak. The agent calls get_player_stats and then uses get_player_game_archives to pull the last five months of PGN data for comparison.

### Verifying tournament eligibility
An organizer needs a list of all participants who hold a GM title before setting up a new bracket. The agent executes list_titled_players, filtering only for 'GM', and then uses get_tournament_metadata to verify the event dates.

### Generating educational content
A content creator wants a puzzle for a blog post. They ask for get_daily_chess_puzzle, grab the board image, and then use get_player_profile on a famous player to add background context.

### Cross-platform reporting
A coach needs to analyze three different students' records. They ask the agent to combine calls to get_player_stats for all three, then use an external messaging MCP (via Vinkius chaining) to send a single, summarized report to the client.

## Benefits

- Pinpoint weaknesses: Use get_player_stats to immediately see a player's win/loss record across formats, allowing for highly targeted coaching sessions.
- Track progress over time: Call get_player_monthly_games to pull specific historical data, letting you show students exactly how they improved month-over-month.
- Stay current with the scene: Use list_active_streamers to gather intel on who's playing right now, perfect for live content creation or reporting.
- Understand rankings instantly: get_global_leaderboards provides real-time top player lists, eliminating the need to refresh multiple league pages manually.
- Create focused training: Instead of browsing random puzzles, use get_daily_chess_puzzle for official tactics, or get_random_chess_puzzle for quick drills.

## How It Works

The bottom line is that you talk to your agent like a human analyst; it handles all the database connections and retrieval complexity behind the scenes.

1. Connect this MCP to your preferred AI client (Claude, Cursor, etc.).
2. Tell your agent exactly what you need—for example, 'What is the Rapid rating for Player X?'
3. The agent calls the appropriate tool and returns the precise chess data directly into your chat or code environment.

## Frequently Asked Questions

**Can my AI automatically find the current ratings for a specific Grandmaster like Magnus Carlsen?**
Yes! Use the `get_player_stats` tool with the username. Your agent will respond with the current and best ratings for Blitz, Bullet, and Rapid formats, along with their recent win/loss record.

**Is it possible to retrieve all games played by a user in a specific month for technical analysis?**
Absolutely. First use `get_player_game_archives` to see available periods, then run `get_player_monthly_games` for the target year and month. It will return the complete PGN data for all matches in that window.

**Does the integration permit listing all active Grandmasters (GMs) on the platform?**
Yes. The `list_titled_players` action allows your agent to fetch the complete list of usernames for any official title, including GM, WGM, IM, and FM, directly from the platform.

**What metadata can I grab about a group using the `get_chess_club_details` tool?**
This function pulls specific details for a given club ID. You'll get information like the club's name, description, and whether it’s public or private. It lets you research the structure of chess communities.

**How do I compare puzzle sources using `get_daily_chess_puzzle` versus `get_random_chess_puzzle`?**
The daily function pulls the official, featured tactic for that specific day. By contrast, calling `get_random_chess_puzzle` grabs any available tactical problem from the general database. You use them differently depending on if you need a structured challenge or just broad training material.

**Does `get_tournament_metadata` provide historical data about past competitions?**
Yes, this tool retrieves detailed information about a specific tournament ID. You can find the event's dates, its playing format (like Blitz or Rapid), and who was involved, making it useful for deep research.

**If I need to filter player data by region, how does `get_country_details_chess` help?**
It validates country information using a standard two-letter ISO code. The tool returns the necessary ID and metadata for that location. You then use this resulting identifier to scope your subsequent searches or analyses.

**What kind of real-time information does `list_active_streamers` provide?**
It generates a list of users who are currently streaming on the platform. This is helpful for coaches, analysts, and content creators needing to find specific players available for live analysis or reporting.