Chess.com MCP. Analyze stats, game history, and player profiles.
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 connects your AI agent directly to player data, game history, and global leaderboards. You can pull detailed stats, check a player's current online status, or get daily puzzles—all without needing API keys or logging into the site.
What your AI agents can do
Get club info
Gets basic details (members, creation date) about a specific Chess.com club using its URL identifier.
Get club members
Lists usernames and profile URLs for active members inside a specified Chess.com club community.
Get country players
Retrieves an array of player usernames affiliated with a given country code (e.g., 'US' or 'IN').
Get a user's core profile details, such as their display name, join date, country, and official titles.
Fetch current and peak ratings across multiple chess formats (Blitz, Rapid, Daily) alongside detailed win/loss records.
Access full PGN data for finished games spanning specific months, allowing deep analysis of openings and opponent performance.
Determine if a player is connected to the Chess.com servers right now, useful before challenging them or coordinating with them.
Find clubs a player belongs to, list members of a specific club, or locate players from any country using ISO codes.
Get the official daily puzzle or pull random puzzles for immediate tactical practice sessions.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Chess.com MCP Server: 15 Tools for Data Retrieval
Use these specific tools to pull player profiles, track game records, list members of clubs, and analyze stats from the public Chess.com API.
019d8424get club info
Gets basic details (members, creation date) about a specific Chess.com club using its URL identifier.
019d8424get club members
Lists usernames and profile URLs for active members inside a specified Chess.com club community.
019d8424get country players
Retrieves an array of player usernames affiliated with a given country code (e.g., 'US' or 'IN').
019d8424get daily puzzle
Pulls today's official Chess.com daily puzzle, including the FEN and solution moves.
019d8424get leaderboards
Shows top-rated players across all major game categories (Blitz, Rapid, etc.) on Chess.com.
019d8424get player clubs
Lists all clubs a given player is a member of, along with club details and membership counts.
019d8424get player current games
Checks the opponent username and current position for ongoing daily (correspondence) games a player has started.
019d8424get player game archives
Provides URLs pointing to available game data months for a specific player, helping you plan your history retrieval.
019d8424get player monthly games
Returns detailed PGN data and results for all finished games played by a user in one specific month/year combination.
019d8424get player profile
Gathers basic identity details about any Chess.com player, like their display name, join date, and country.
019d8424get player stats
Calculates a player's current and peak ratings across all game types (rapid, blitz, puzzle_rush) and win/loss records.
019d8424get random puzzle
Pulls any random puzzle from the database for unlimited tactical training sessions.
019d8424get streamers
Lists verified Chess.com content creators, including their streaming platform and follower count.
019d8424get titled players
Retrieves lists of players who hold specific official chess titles (GM, IM, FM, etc.).
019d8424is player online
Checks the real-time status to confirm if a player is currently connected and active on 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,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'll connect your AI agent straight into Chess.com's player data, game history, and global leaderboards. This server gives you direct access to the platform's core functions—you don't need API keys or to log in yourself. You can pull deep stats, check who's online right now, or grab today's puzzles using tools like get_player_stats.
Player Identity and Status
Need to know about a player? Use get_player_profile to get their basic info—it includes their display name, when they joined, where they're from, and any official titles they hold. If you just wanna know if someone's active right now, run is_player_online. You can also check out who the top players are across all major games using get_leaderboards, or grab a list of verified content creators with get_streamers.
Performance and History Tracking
Tracking performance is straightforward. Run get_player_stats to calculate a player's current and peak ratings across every major game type, like rapid, blitz, and puzzle_rush; it also gives you their win/loss records. For deeper dives into how they play, use get_player_monthly_games to pull detailed PGN data for all the finished games a user played in a specific month and year.
If you need to plan your history retrieval first, run get_player_game_archives, which gives you URLs pointing to available game data months for any player.
Community and Discovery Tools
Want to know who's playing with whom? You can use get_player_clubs to list every club a given player belongs to, including details about the clubs and how many members are in them. To check out a specific community, run get_club_info using the club's URL identifier to get basic facts like its creation date and total membership numbers.
You can list all active names and profile URLs inside any specified club using get_club_members. If you need to find players based on location, use get_country_players with a country code (like 'US' or 'IN') to retrieve an array of usernames from that region. You can even see the full list of players holding official chess titles—like GM or IM—by running get_titled_players.
Training and Game Content
For quick practice, you have two options: run get_daily_puzzle to pull today's official puzzle, which includes the FEN and solution moves; or use get_random_puzzle for unlimited tactical training sessions with any random puzzle from the database. If you’re checking on a player who is in a daily (correspondence) game, get_player_current_games checks their opponent's username and where they currently stand in the match.
How Chess.com MCP Works
- 1 Connect your AI client (Claude, Cursor, etc.) to the Chess.com MCP Server.
- 2 Prompt your agent with a request that requires specific data—for example: 'What are the stats for player X?'
- 3 Your agent runs the appropriate tool (like
get_player_stats), and you receive structured JSON containing ratings, records, and profile details.
The bottom line is, your AI client handles all the API calls; you just ask questions in plain English.
Who Is Chess.com MCP For?
Anyone who needs structured data about competitive gaming or online communities. Specifically, chess coaches need to track student progress across multiple time controls without leaving their workflow. Content creators use it for real-time leaderboard updates and statistical deep dives. Data analysts use it to build large datasets of player performance trends.
Tracks a student's peak ratings using get_player_stats, compares their daily game history via get_player_monthly_games to identify weak openings, and checks if opponents are online with is_player_online.
Pulls the top 5 players on the Blitz leaderboard using get_leaderboards, gathers stats for featured streamers via get_streamers, and builds content around titled player lists using get_titled_players.
Aggregates data from multiple sources, such as finding all players in a specific country (get_country_players) and then pulling their combined stats for comparative research.
What Changes When You Connect
- Stop manually checking multiple profile pages. Use
get_player_profileto get a user's core identity data—like their join date or country—in one API call. - Deep dive into performance with
get_player_stats. You instantly compare a player’s current Blitz rating against their historical Rapid best, all structured and ready for analysis. - Never miss game context again. Use
get_player_monthly_gamesto pull full PGN data for an entire month, letting you study opening sequences or review specific losses without leaving your chat window. - Discover talent globally by running
get_country_players. You can build a roster of potential opponents or students from any nation using its ISO code. - Stay current with the community. Check activity levels using
is_player_onlinebefore challenging an opponent, saving time compared to guessing their status. - Keep your team sharp with endless practice. Use
get_random_puzzlefor unlimited training puzzles, or get the daily challenge viaget_daily_puzzle.
Real-World Use Cases
A coach needs to benchmark a student's progress.
The student loses a game. The coach asks their agent: 'Pull my stats and last month’s games for the player ID.' The agent uses get_player_stats and then get_player_monthly_games. This provides both the current peak rating and the specific PGN data needed to identify which opening failed, allowing targeted training.
A content creator needs a fresh leaderboard for a stream.
Instead of checking the website widget, the agent runs get_leaderboards and filters by 'Blitz'. It then uses this data to create an announcement list. The final step is pulling stats for the top 3 using get_player_stats to give deep context before starting the stream.
A researcher wants to map a nation's chess activity.
The researcher first uses get_country_players with 'RU'. This returns hundreds of usernames. They then loop through these names, using get_player_profile on each one to confirm their title status and collect metadata for a massive comparative study.
A user wants to know which club strong players belong to.
The user knows Player X is good but doesn't know where they play. They ask the agent to run get_player_clubs on Player X. This immediately reveals all their affiliations, pointing them toward potential new coaching communities or opponents.
The Tradeoffs
Asking for general 'game data'.
Prompting: 'Give me the player's history.' The agent might fail or return irrelevant links, because 'history' is too vague.
→
Be specific. To get all games from June 2024, use get_player_monthly_games. If you only need to know their rating range, run get_player_stats.
Assuming a tool covers everything.
Asking: 'Tell me everything about this player.' This forces the agent to guess and may miss crucial data points like current online status or club memberships.
→
Break it down. First, run get_player_profile for basics. Second, check their live status with is_player_online. Third, get their historical context via get_player_stats.
Using the wrong tool for time.
Checking if a player used to play in 2018 by asking about current status. This will only confirm today's connection, not past activity.
→
To check old games, use get_player_game_archives first—this tells you what data is available for years/months before you run get_player_monthly_games.
When It Fits, When It Doesn't
Use this MCP Server if your goal is structured, quantitative analysis of chess player activity. You need to compare specific metrics (like comparing peak Blitz rating vs. current Rapid rating) or pull historical data points across months and years.
Don't use it if you simply want to play a game or look up an opponent casually; the main Chess.com site is faster for that. Also, don't expect real-time chat features—it only confirms status with is_player_online.
Use this server when your workflow requires: 1) Cross-referencing data (e.g., finding a player in a club, then getting their stats); 2) Handling large datasets of records or games; 3) Automating the collection of community metadata like get_country_players lists.
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.
Available Capabilities
Manually tracking an opponent's performance is a nightmare.
Right now, if you want to study an opponent, you have to open their profile page. You copy the Blitz rating into one spreadsheet tab, then switch to another tab to check their Rapid record. If they played a game in March, you manually navigate back to that month's games and try to scrape PGN data. It takes twenty minutes of clicking, copying, and pasting.
With this MCP server, your agent handles it all. You simply ask: 'Show me player X's stats for the last three months.' The system uses `get_player_stats` combined with calls to `get_player_monthly_games`, giving you a unified data set that is ready for immediate analysis.
Get reliable performance numbers using `get_player_stats`.
Before this, getting a comprehensive view meant checking multiple sections on the website—one for Blitz, one for Rapid, and another for Puzzle Rush. If you missed a tab or if the site was slow, your data was incomplete or outdated.
Now, `get_player_stats` pulls all those ratings into one structured response. You don't guess; you get the precise current rating *and* the historical best rating across every format, instantly.
Common Questions About Chess.com MCP
How do I check a player's stats using `get_player_stats`? +
You run get_player_stats and provide the username. The server returns their current rating, best rating ever, and win/loss breakdown across Blitz, Rapid, Bullet, Daily, etc.
Can I find out which clubs a player belongs to using `get_player_clubs`? +
Yes. Running get_player_clubs on a username gives you a list of all their affiliated chess communities along with membership counts for each club.
What is the difference between `get_player_profile` and `get_player_stats`? +
Profile data (get_player_profile) gives identity info (join date, avatar). Stats (get_player_stats) gives performance metrics (ratings, win/loss records).
How can I get random puzzles for practice? Do I need `get_daily_puzzle`? +
You don't. Use get_random_puzzle. While you can use get_daily_puzzle for the official challenge, get_random_puzzle pulls from a general database and gives unlimited training material.
Does `get_player_monthly_games` work for all players? +
It requires the player's username, along with the specific month (1-12) and year you want to analyze. You must first check get_player_game_archives to see if data exists for that timeframe.
When using `get_country_players`, what format must the country code be in? +
The tool requires an ISO 3166-1 alpha-2 standard. You must use two uppercase letters, like "US" for the United States or "FR" for France. This specific format ensures you get accurate player lists regardless of how long the country's name is.
After running `get_player_game_archives`, what do I need to actually retrieve game data? +
The archive tool only provides a list of available date URLs. You must take those year and month parameters and pass them directly into the get_player_monthly_games tool. This two-step process pulls the full PGN dataset you need.
If I use `is_player_online` and it returns false, what should I do next? +
A 'false' result means the player is not connected to Chess.com servers at this exact moment. Don't interpret this as a permanent status. The best approach is simply to wait and run the tool again later for updated information.
Do I need a Chess.com API key or authentication to use this server? +
No! The Chess.com public API is completely open and requires no authentication. All endpoints are read-only, so you can start querying player profiles, stats, games, and puzzles immediately after installation without any API keys or tokens.
Can I retrieve my complete game history with PGN data for a specific month? +
Yes! Use the get_player_monthly_games tool with your username, year, and month (1-12). It returns all finished games with full PGN strings, opponent usernames, opening names, time controls, accuracy ratings, and game end reasons. First use get_player_game_archives to discover which months have available data for any player.
How can I find chess puzzles for practice or training? +
Use get_daily_puzzle for the official Chess.com daily puzzle that changes once per day, or use get_random_puzzle for unlimited random puzzles from the Chess.com database. Both return the puzzle position (FEN), the complete solution moves, puzzle rating, and the source game information — perfect for tactical training sessions.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Chess.com Global Intelligence
The definitive server for Chess.com — track player ratings, historical games, and daily puzzles via AI.
Readwise
Connect your AI agents to Readwise to manage books, highlights, tags, and spaced repetition reviews directly through natural language.
Counterfactual-Variant Prover
AI models recite memorized answers to classic puzzles, failing when variables or rules are changed. This tool forces cognitive decontamination: isolate variables, compare prompt rules against standard puzzle templates, execute first-principles logic step-by-step, and prove decontaminated output.
You might also like
EasySendy
Send high-volume email campaigns through multiple delivery servers with list hygiene tools that protect your sender score.
Fortnite Player Stats & News Intelligence
The definitive server for Fortnite player scouting — track wins, K/D ratios, and official game news via AI.
Japan e-Stat
Query official Japanese government statistics — population, GDP, industry, trade, employment, and more — from the e-Stat national database.