Chess.com Global Intelligence MCP. Analyze player stats and deep game history instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Chess.com Global Intelligence. This server gives your AI agent direct access to the official Chess.com database. You can instantly retrieve real-time player ratings (Blitz, Bullet, Rapid), audit full match histories (PGN), and solve the daily featured chess puzzle.
It lets you research grandmaster performance, track global rankings, or analyze specific club data using natural conversation.
What your AI agents can do
Get chess club details
Retrieves basic metadata for a specific chess club.
Get country details chess
Fetches details for a country using its two-letter ISO code.
Get daily chess puzzle
Gets the official, featured daily chess puzzle for practice.
Retrieve a player's current ratings, win/loss record, and basic profile information.
Access and list monthly archives of games played by a user for deep technical analysis.
Fetch the official daily chess puzzle or generate a random tactical puzzle for practice.
List and query top player leaderboards across major chess formats.
Find players who hold specific titles like Grandmaster (GM) or International Master (IM).
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Chess.com Global Intelligence: 12 Tools for Chess Analysis
Use these twelve tools to query player stats, fetch game archives, check leaderboards, and solve puzzles directly from the official Chess.com database.
019d8424get chess club details
Retrieves basic metadata for a specific chess club.
019d8424get country details chess
Fetches details for a country using its two-letter ISO code.
019d8424get daily chess puzzle
Gets the official, featured daily chess puzzle for practice.
019d8424get global leaderboards
Retrieves the current top player rankings for major chess formats.
019d8424get player game archives
Lists the available monthly game archives for a specific player.
019d8424get player monthly games
Gets all games played by a user within a specified month.
019d8424get player profile
Retrieves basic identifying information about a Chess.com player account.
019d8424get player stats
Retrieves current ratings and performance statistics for any player.
019d8424get random chess puzzle
Pulls a random chess tactic or puzzle for general training and quick study.
019d8424get tournament metadata
Fetches specific details about a given chess tournament.
019d8424list active streamers
Lists players who are currently streaming content on Chess.com.
019d8424list titled players
Finds and lists all players who hold a specific title (GM, IM, etc.).
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Chess.com Global Intelligence, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're connecting your AI agent to the official Chess.com database. It's a full-tilt analysis tool. Your agent can get a player's basic info, current ratings—Blitz, Bullet, or Rapid—and their win/loss record using get_player_profile and get_player_stats. You can deep-dive into a player's history by listing their monthly game archives with get_player_game_archives and then pulling every single game from a specific month using get_player_monthly_games.
If you wanna study openings or just wanna train, your agent can grab the official daily puzzle with get_daily_chess_puzzle or pull a random tactic with get_random_chess_puzzle. Wanna see who's topping the charts? Your agent pulls the current global rankings using get_global_leaderboards. You can also check out specific details about a tournament with get_tournament_metadata.
Need to find players with a certain title, like GM or IM? Use list_titled_players to find 'em. Your agent can list players streaming right now using list_active_streamers, or get basic club info with get_chess_club_details. You can even get details about a country using its two-letter ISO code with get_country_details_chess.
How Chess.com Global Intelligence MCP Works
- 1 Subscribe to the Chess.com Global Intelligence server.
- 2 Your AI client connects and uses the specific tool function (e.g.,
get_player_stats) by providing necessary parameters like a player ID or title. - 3 The server processes the request against the official Chess.com database and returns the requested data—be it a JSON object of stats or a list of game archives—directly to your AI agent.
The bottom line is, you talk to your AI agent, and it gets the specific chess data you need without needing an API key or manual database queries.
Who Is Chess.com Global Intelligence MCP For?
This is for chess coaches, content creators, and competitive players. If you spend time manually checking player ratings, downloading game archives, or keeping up with global chess trends, this saves you hours of tedious data gathering. It lets you run advanced analysis right from your chat window.
Uses get_player_stats and get_player_game_archives to audit a student's performance, identifying specific weaknesses or successful opening patterns for technical reports.
Uses get_daily_chess_puzzle and get_global_leaderboards to source fresh, high-integrity content for articles, videos, or social media posts.
Uses get_player_profile and get_global_leaderboards to monitor personal progress, benchmark against rivals, and stay informed about global rankings.
What Changes When You Connect
- See a player's full performance record instantly. Use
get_player_statsto get their ELO rating, win/loss ratio, and specific format breakdowns without leaving your chat. - Research opening theory with depth. Use
get_player_game_archivesto list and access months of historical games for technical review, which is way faster than downloading PDFs. - Never miss a puzzle.
get_daily_chess_puzzlefetches the official, featured daily tactic. You can also useget_random_chess_puzzlefor quick, ad-hoc training sessions. - Stay updated on the top talent. Run
get_global_leaderboardsto see the current top 5 players in Blitz or Rapid, or uselist_titled_playersto find all Grandmasters. - Audit specific accounts. Use
get_player_profileto get basic details on any player, orget_chess_club_detailsif you need to check a group's status.
Real-World Use Cases
Evaluating a Student's Weakness
A coach needs to know why a student keeps losing endgames. They ask their agent to run get_player_game_archives for the last three months. The agent pulls the PGN data, and the coach can pinpoint exactly which opening phase led to the drop in rating, giving targeted feedback.
Sourcing Content for a Blog
A content creator needs fresh material for a chess blog. They ask the agent to run get_daily_chess_puzzle and get_global_leaderboards. The agent provides the official puzzle image and the names of the top 10 players, guaranteeing high-integrity, up-to-date content.
Preparing for a Tournament
A competitive player wants to study their rival, Magnus. They ask the agent to run get_player_stats and get_player_profile. The agent returns Carlsen's current ratings across all formats and his public profile metadata, giving the player a quick competitive baseline.
Researching a Chess Club
A club manager needs to check the status of a local group. They ask the agent to run get_chess_club_details and list_titled_players. The agent returns the club's metadata and a list of all Grandmasters affiliated with that region, helping the manager organize local events.
The Tradeoffs
Using simple web searches for stats
Opening Google and navigating to Chess.com, then manually searching for 'player stats' and cross-referencing multiple pages to find the current Blitz and Rapid ratings. This is slow and prone to outdated data.
→
Ask your agent to run get_player_stats directly. It pulls the current, real-time ratings for the player across all major formats in a single command.
Guessing puzzle content
Assuming the daily puzzle is available and trying to find it via general search, leading to links to outdated or unrelated content. You waste time verifying the source.
→
Use get_daily_chess_puzzle. It fetches the official puzzle from the source, guaranteeing you have the correct board image and puzzle details for the day.
Checking player history manually
Trying to manually download every month's worth of games (PGN) from a player's profile page, resulting in hundreds of large, disparate files that are hard to correlate.
→
→
Run get_player_game_archives first to see which months are available, then use get_player_monthly_games to get the specific set of games you need for analysis.
When It Fits, When It Doesn't
Use this server if your primary need is structured, historical, or real-time data from the official Chess.com platform. You need to analyze performance metrics, track trends, or source high-integrity content. For example, if you need to see if a player's Blitz rating changed last week, use get_player_stats. If you just want to know the general status of a club, get_chess_club_details is enough. Don't use this if you just want a casual, qualitative opinion on a player—the tools only provide raw, quantifiable data. If you only need a simple chat message or a quick general fact, your AI client might handle it without this server, saving you the overhead of calling multiple tools.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Chess.com. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Getting a player's performance record used to take a dozen clicks.
Right now, checking a player's current standing means navigating to their profile, clicking on the stats tab, then maybe going to the history section to see their last 10 games. You're jumping between pages and tabs just to piece together a picture of their performance.
With the Chess.com Global Intelligence MCP Server, you just ask your agent to run `get_player_stats`. It instantly compiles the player's current ELO ratings, win/loss ratios, and performance data, giving you a complete, structured breakdown right in your conversation.
The Chess.com Global Intelligence MCP Server makes research simple.
Before, if you wanted to research a specific player's opening tendencies, you had to download massive PGN files, unzip them, and run specialized software just to find a pattern. It was a massive, multi-step process.
Now, your agent uses `get_player_game_archives` to list the available months, and then pulls the specific games you need. You get the raw data structured and ready for analysis, period. It cuts out the entire research bottleneck.
Common Questions About Chess.com Global Intelligence MCP
How do I check a player's current ratings using get_player_stats? +
You ask your agent to run get_player_stats and provide the player's ID. The server returns their current ELO rating across formats like Blitz, Rapid, and Bullet.
What is the best way to get the official daily puzzle using get_daily_chess_puzzle? +
Simply ask your agent to run get_daily_chess_puzzle. It fetches the official puzzle from Chess.com, giving you the correct board image and puzzle details for the day.
Can I use get_player_game_archives to see a player's history? +
Yes. You run get_player_game_archives and specify the player ID. This lists all the available monthly archives, letting you know what data is available for historical study.
How do I find all Grandmasters using list_titled_players? +
Run list_titled_players and specify 'GM' as the title. The tool then queries the database and returns a list of all players who currently hold that specific title.
What is the difference between get_player_stats and get_player_profile? +
Use get_player_profile for basic, public metadata like the player's username or join date. Use get_player_stats when you need quantitative data like ratings, win percentages, or game counts.
How do I use get_player_monthly_games to analyze a specific player's activity in a given month? +
You pass the player's username and the desired month/year to get_player_monthly_games. This returns a list of all games played that month, allowing you to track activity patterns or performance dips.
Is there a way to check club details for a specific group using get_chess_club_details? +
Yes, you provide the club's unique identifier to get_chess_club_details. This returns metadata like membership count, founding date, and associated challenges for that club.
What are the limitations or rate limits when calling get_global_leaderboards? +
The service handles high volumes of queries, but excessive, rapid calls to get_global_leaderboards may trigger temporary rate limiting. We recommend implementing a brief delay between calls for stable operation.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Breakthrough Ideation Prover
AI agents default to safe, obvious ideas or hallucinate impossible ones. This tool forces breakthrough ideation: challenge convention with facts, integrate real constraints, map a concrete roadmap, and prove feasibility for every blocker. Radical AND realizable.
Yakunashi-Safety Gate
LLMs hallucinate confidently when context is missing. This tool enforces epistemic calibration: map required preconditions, audit information sufficiency, detect speculation (yakunashi), and trigger safe folding (Beta-Ori) when data is missing.
Critical Thinking Prover
AI agents accept premises without questioning, analyze from one perspective, cherry-pick evidence, ignore consequences, and present uncertainty as certainty. This tool forces rigor: surface assumptions, apply competing frameworks, weigh counterevidence, trace ripple effects, bound confidence.
You might also like
Cannlytics Strain API
Access cannabis strain data, effects, flavors, and similar strains via Cannlytics.
Smaily Alternative
Manage email marketing campaigns, subscribers, and automations directly through Smaily.
BlueSnap
Process and manage payments via BlueSnap — list transactions, subscriptions, and vaulted shoppers directly from any AI agent.