# Chess.com Global Intelligence MCP for AI Agents AI Agent Connect

> Chess.com Global Intelligence MCP. Track player ratings, historical games, and daily puzzles via AI. This tool gives your agent direct access to official Chess.com data for scouting, research, and training.

## Overview
- **Category:** education
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cZTPw1mKa5BrSyooB9GIvgd6KEtMNjOjb3JDQS6W/ai-agent-connect
- **Tags:** chess-api, grandmaster-stats, chess-puzzles, elo-rankings, match-archives

## Description

You can now have your agent act as a professional chess analyst. Instead of digging through multiple websites to find a player's win rate or searching for a specific tournament's details, you just ask. You can pull live ratings across different formats, audit months of historical games, or grab the daily featured tactic without leaving your workspace. It's designed to turn raw platform data into actionable research for coaches, content creators, and competitive players alike. Whether you're looking for a specific club's metadata or a list of active streamers, the data is ready when you need it. You'll find this tool in the Vinkius catalog as a way to cut out the manual research steps that usually slow down your analysis.

## Tools

### get_global_leaderboards
Get current top player rankings. Use this to see who is leading in different formats.

### get_chess_club_details
Get metadata for a specific chess club. This shows you how clubs are structured.

### get_country_details_chess
Get details for a country using its 2-letter ISO code. This helps with regional scouting.

### get_player_monthly_games
Get games played by a specific user in a given month. This is great for analyzing recent form.

### get_player_profile
Get basic information about a Chess.com player. Use this to quickly check account details.

### get_daily_chess_puzzle
Get the official daily chess puzzle. Use this to grab the current featured tactic.

### get_random_chess_puzzle
Get a random chess tactic or puzzle. This is perfect for generating training content.

### get_player_stats
Get ratings and statistics for a specific player. This provides the core data for scouting reports.

### list_active_streamers
List active Chess.com streamers. Use this to find people currently live on the platform.

### get_tournament_metadata
Get details for a specific tournament. This helps you research competition structures.

### get_player_game_archives
List available monthly game archives for a player. Use this to see which months of data are accessible.

### list_titled_players
List players who hold specific titles like GM or IM. This is useful for identifying top talent.

## Prompt Examples

**Prompt:** 
```
Who are the top 5 Blitz players right now?
```

**Response:** 
```
Running leaderboard query... The top 5 Blitz players are currently:

| Rank | Player | Title |
| :--- | :--- | :--- |
| 1 | MagnusCarlsen | GM |
| 2 | Hikaru | GM |
| 3 | Firouzja2003 | GM |
| 4 | NihalSarin | GM |
| 5 | DanielNaroditsky | GM |

Would you like to see the Rapid or Bullet rankings?
```

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

**Response:** 
```
Retrieving the daily tactic... 

**Today's Puzzle:** Deflection in the Endgame

You can find the official puzzle here: [Chess.com Puzzle Link]

I can also grab a random training puzzle for you if you want to practice a specific tactic.
```

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

**Response:** 
```
Inspecting Grandmaster stats... 

**Magnus Carlsen Stats:**
* **Blitz Rating:** 2890
* **Rapid Rating:** 2810
* **Winrate:** Dominant across all formats.

Would you like to see his best historical rating or his last 5 match results?
```

## Capabilities

### Scout player ratings
Get live ELO and win/loss stats for any account.

### Audit match history
Pull monthly archives of games for deep technical analysis.

### Grab daily puzzles
Fetch the official daily tactic or random training puzzles.

### Identify titled players
List every GM or IM in a specific region.

### Track global rankings
Query leaderboards for Blitz, Bullet, and Rapid formats.

### Check club data
Retrieve metadata for specific chess clubs and countries.

## Use Cases

### Scouting an opponent for a tournament
A coach asks their agent to pull the last three months of games for a specific player using get_player_monthly_games to find weaknesses.

### Creating a daily chess news post
A content creator asks their agent to find the current daily puzzle and a list of active streamers using get_daily_chess_puzzle and list_active_streamers.

### Researching grandmaster trends
A researcher asks their agent to list all players with the GM title and get their current stats using list_titled_players and get_player_stats.

### Analyzing regional club growth
A club organizer asks their agent to pull metadata for several clubs and country details using get_chess_club_details and get_country_details_chess.

## Benefits

- Speed up scouting by using get_player_stats to pull live ratings and win rates instantly without manual searching.
- Conduct deep technical audits by using get_player_monthly_games to analyze a specific player's performance over time.
- Keep your content fresh by using get_daily_chess_puzzle to grab the current featured tactic for your audience.
- Identify elite talent quickly by using list_titled_players to filter for GMs and IMs in any region.
- Track the meta by using get_global_leaderboards to see who is leading in Blitz, Bullet, and Rapid formats.
- Research competition structures easily by using get_tournament_metadata to see how different events are organized.

## How It Works

The bottom line is you get instant access to official Chess.com data through a natural conversation with your agent.

1. Subscribe to the Chess.com Global Intelligence MCP via Vinkius.
2. Connect the Connector to your preferred client like Claude, Cursor, or Windsurf.
3. Ask your agent to perform tasks like scouting a player's history or fetching the daily puzzle.

## Frequently Asked Questions

**Can Chess.com Global Intelligence find my friends?**
No, this Connector is designed for general research and data retrieval. It can pull public profiles and ratings but does not access your personal friend list or private messages.

**How do I get grandmaster stats with Chess.com Global Intelligence?**
You can simply ask your agent to look up a specific player's stats. It will pull their current ratings and win rates across various formats like Blitz and Rapid.

**Can I use Chess.com Global Intelligence for my chess blog?**
Yes, it's perfect for content creators. You can use it to grab the daily puzzle, find active streamers, or pull match archives to share with your audience.

**Does Chess.com Global Intelligence show live games?**
It provides access to historical game archives and monthly data. It does not show real-time live moves as they happen.

**Can I find specific puzzles using Chess.com Global Intelligence?**
Yes, you can ask for the official daily puzzle or request a random tactic for training. Your agent will fetch the title and details for you.

**Does Chess.com Global Intelligence require an API key?**
No, you do not need a separate API key for public discovery access when using this Connector through Vinkius.

**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.