Chess.com MCP. Analyze any game, profile, or puzzle 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 MCP gives your AI agent instant access to the entire public chess ecosystem. Pull player stats, game history, leaderboards, and even daily tactical puzzles—all without needing API keys or logging in.
It lets you analyze any opponent’s play or track your own progress right inside your chat client.
What your AI agents can do
Get club info
Retrieves metadata about a specific chess club, including its description, creation date, and member count.
Get club members
Lists the usernames of active members within a particular chess club community.
Get country players
Returns an array of player usernames who have registered with a specific country code, like 'US' or 'IN'.
Determine if a specific player is currently connected to the Chess.com servers.
Get information about any official chess community (club) or list all active players within that group.
Pull a roster of all registered chess players from a specific nation using its ISO code.
Fetch the official daily puzzle or pull unlimited random tactical puzzles for practice.
View the current leaderboards showing the highest-rated players across all time controls (Blitz, Bullet, Rapid).
Retrieve a player's complete game history for any given month, including opening names and accuracy.
Get basic identity information about a player, like their join date, follower count, and country.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Chess.com MCP: 15 Tools for Data Analysis
Use these tools to pull specific data points about players, clubs, games, and puzzles directly from the Chess.com platform.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Chess.com on Vinkius019d8424get club info
Retrieves metadata about a specific chess club, including its description, creation date, and member count.
019d8424get club members
Lists the usernames of active members within a particular chess club community.
019d8424get country players
Returns an array of player usernames who have registered with a specific country code, like 'US' or 'IN'.
019d8424get daily puzzle
Provides the current day's tactical puzzle position, solution moves, and associated game details.
019d8424get leaderboards
Fetches top players across various time controls (blitz, bullet, rapid) with their ratings and profile URLs.
019d8424get player clubs
Lists all the chess clubs that a specific player is currently a member of.
019d8424get player current games
Shows details for any ongoing, non-live daily correspondence games a player has in progress.
019d8424get player game archives
Generates URLs pointing to months where available game data exists for a specific player's history.
019d8424get player monthly games
Retrieves detailed PGN data, results, and opponent names for all finished games of a player in one month.
019d8424get player profile
Gathers basic identity information on a player, including their display name, country, and join date.
019d8424get player stats
Provides current and best ratings across all game types (Blitz, Bullet, Rapid) plus win/loss records.
019d8424get random puzzle
Pulls a fresh tactical puzzle position from the database that is not the daily puzzle.
019d8424get streamers
Lists verified chess content creators and their streaming platform details, like Twitch or YouTube links.
019d8424get titled players
Returns a list of all players who hold specific official titles, such as Grandmaster (GM) or International Master (IM).
019d8424is player online
Checks the real-time status to confirm if a player is currently logged into Chess.com.
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, then connect any of our 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ 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
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 15 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually compiling player profiles is a nightmare.
Right now, getting a full picture of a competitor means opening the website. You click on their profile to get basic info; then you have to navigate to 'Stats' for ratings, and another tab for 'Games' to see history. It takes three different pages, copy-pasting usernames and dates just to build one cohesive report.
With this MCP, your agent handles it all in the background. You ask for a player's full stats and game records; you get structured data back—the ratings, the best scores, and months of finished games—all without leaving your chat window.
Getting Player Data with get_player_stats
Before this MCP, checking a player's skill level meant comparing their rating on one page to another. You had to remember if the number was 'current best' or 'all-time peak.' It was messy and required cross-referencing multiple dashboard widgets.
Now, calling get_player_stats gives you all those numbers—current ratings alongside historical peaks for Blitz, Bullet, Rapid, etc.—in one single output. You know exactly what you’re looking at.
What you can do with this MCP connector
Need deep chess data but hate switching tabs? This MCP connects to the public Chess.com platform, letting your AI agent pull everything from player profiles and ratings to full game archives. You can ask for a specific player's stats—like their best Blitz or Bullet rating—and get it immediately. Want to study an opponent’s opening moves? Just ask for their game history.
It’s all about getting the concrete numbers you need, right where you are. Because Vinkius hosts this MCP, you connect your preferred AI client once and instantly gain access to this massive library of chess data, letting you analyze everything from titled players like GMs down to random training puzzles.
019d8424-785e-7092-9364-9ea6f7ecec6c 
How Chess.com MCP Works
- 1 First, subscribe to this MCP on Vinkius and connect it to your AI client.
- 2 Next, just tell your agent what you need—for instance, 'What were the stats for player X last month?'
- 3 The tool executes the request against Chess.com's data and returns a structured report directly into your chat.
The bottom line is, you never have to leave your AI chat to pull complex chess metrics or game data again.
Who Is Chess.com MCP For?
Anyone who takes their chess seriously. This is for coaches compiling opponent reports before a tournament, content creators prepping streaming stats, and serious players doing deep post-game analysis.
Needs to quickly pull player statistics, game records, and leaderboard data to analyze a student's weaknesses or prepare opponents for their upcoming match.
Requires bulk data on titled players, top streamers, or country-specific talent to feed content ideas or research market trends for streaming.
Spends time reviewing detailed PGN game history, checking their own peak ratings across different time controls, and finding random puzzles for daily training.
What Changes When You Connect
- Stop manually tracking stats. Use get_player_stats to pull a player's current and historical ratings across all controls in one query.
- Study opponent weaknesses by using get_player_monthly_games. You can analyze specific months of play, checking for opening patterns or weak spots against certain opponents.
- Find talent globally. Use get_country_players to build a roster of players from any nation, which is perfect for organizing local tournaments or content series.
- Never miss a live opponent. Check player availability in real-time using is_player_online before challenging someone or planning an online study session.
- Boost your training routine. Don't just rely on the daily puzzle; use get_random_puzzle to generate unlimited, fresh tactical challenges instantly.
Real-World Use Cases
A coach needs a full profile report.
A coach wants to prep for an opponent. Instead of clicking through multiple tabs, the agent first runs get_player_profile to confirm identity, then uses get_player_stats to pull peak ratings and records, and finally calls get_player_game_archives to see what months of data are available for a deep dive.
Analyzing community activity.
A club organizer needs to know who's active. They use get_club_info to check the club details, then get_club_members to pull a list of usernames, and finally get_player_clubs for any member to see their other affiliations.
Finding high-level talent.
A content creator is prepping a video on the best players. They run get_titled_players first to find all GMs, then use get_leaderboards to narrow down the top 5 active streamers by checking their current ratings.
Reviewing specific game data.
A player lost a tough match. They ask the agent for the monthly games using get_player_monthly_games (specifying month and year), which pulls the full PGN data, allowing them to review every move's accuracy.
The Tradeoffs
Asking for 'all stats'
The user asks, 'Tell me everything about this player.' The agent struggles because the request is too vague and requires multiple data endpoints.
→ Don't ask generally. Be specific: 'Give me the current ratings and best ever ratings for this player,' which triggers get_player_stats.
Trying to find a random puzzle by searching general database
The user searches for puzzles but doesn't specify if they want today's official one or something else.
→ Use the precise tool: Use get_daily_puzzle for the official challenge, or use get_random_puzzle when you need unlimited practice material.
Checking a player that might not exist
The user enters a misspelled username and asks for their game history.
→ Always run get_player_profile first. This confirms the account exists before attempting to pull detailed stats or game records.
When It Fits, When It Doesn't
Use this MCP if you need verifiable, structured data about chess players, games, or clubs. If your goal is simply 'I want to know who's good,' start with get_leaderboards and get_titled_players. If you only care about a player's current status for an immediate match, use is_player_online. Do NOT use this if you are trying to guess stats or analyze subjective performance; the data must come from structured tools like get_player_stats or get_player_monthly_games. If your need involves real-time visual board setup outside of a chat context, you might prefer a dedicated chess app over an MCP agent.
Common Questions About Chess.com MCP
How do I check a player's stats using get_player_stats? +
You simply ask the agent to retrieve the player's statistics and ratings. The tool returns their current and best scores across all major time controls, giving you a complete performance snapshot.
Can I find GMs using get_titled_players? +
Yes. The get_titled_players tool lists players who hold specific titles like GM (Grandmaster) or IM (International Master), letting you quickly build a roster of high-level talent.
What is the difference between getting archives and monthly games? +
get_player_game_archives tells you which months have recorded data for a player. You then use get_player_monthly_games, specifying month/year, to pull the actual PGN game records.
Does get_club_members list active players? +
Yes, it lists usernames and profile URLs for members within a club. This helps you identify potential opponents or community leaders inside that group.
What happens if I use an incorrect code with the `get_country_players` tool? +
The function will return an error or empty list. You must provide a valid ISO 3166-1 country code (like 'US' or 'IN'). The API requires these standardized two-letter codes to accurately pull player usernames from that nation.
Does the `is_player_online` tool check for live, real-time activity? +
Yes, this MCP checks the current connection status of a user. It tells you if the account is currently logged into Chess.com servers. This differs from looking at recent game history or daily correspondence games.
Why do I need to run `get_player_game_archives` before getting monthly data? +
The tool lists all available year/month combinations for a player's stored games. You must parse these URLs first to know which months of data exist. Running it ensures you don't try to request a month that the API hasn't recorded.
What is the difference between puzzles from `get_daily_puzzle` and those from `get_random_puzzle`? +
The daily puzzle provides one specific, high-quality challenge designed for the current day. The random puzzle gives you unlimited practice by pulling a unique tactical problem at any time. Both are great for training.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.