# Chess.com Global Intelligence MCP MCP > Chess.com Global Intelligence gives your AI client deep access to the world's largest chess database. Instantly pull real-time player ratings (Blitz, Rapid), audit full match histories for technical analysis, and track global rankings across all titled ranks like GM or IM. ## Overview - **Category:** education - **Price:** Free - **Tags:** chess-api, grandmaster-stats, chess-puzzles, elo-rankings, match-archives ## Description Need to analyze a grandmaster's recent performance or research an opening line? This MCP hooks your agent directly into the official Chess.com database. Instead of manually tracking stats or sifting through endless game files, you just ask your AI client for it. Your agent acts like a professional chess analyst, pulling precise data points—like ELO ratings across multiple formats and full match records in PGN format. You can also get today’s featured puzzle or query who the top players are right now. Connecting this intelligence through Vinkius means you connect your preferred AI client once, but suddenly gain access to professional-grade chess analytics on demand. It's built for anyone who needs high-integrity game data—from coaches running technical reports to content creators needing daily puzzles. ## Tools ### get_chess_club_details Retrieves basic metadata for a specified chess club. ### get_country_details_chess Fetches details for a specific country using its two-letter ISO code. ### get_daily_chess_puzzle Retrieves the official daily chess puzzle featured on Chess.com. ### get_global_leaderboards Lists and queries current top player rankings for major formats. ### get_player_game_archives Finds available monthly archives of games played by a particular user. ### get_player_monthly_games Retrieves the specific games played by a user during an entire calendar month. ### get_player_profile Gets basic public information about any Chess.com player account. ### get_player_stats Provides detailed ratings and performance statistics for a chosen player, across various formats. ### get_random_chess_puzzle Pulls a random chess tactic or puzzle from the database for practice. ### get_tournament_metadata Retrieves specific details and information about a named tournament. ### list_active_streamers Provides a list of streamers who are currently active on the platform. ### list_titled_players Generates a list of players holding specific titles, such as Grandmaster or International Master. ## 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 ### Analyze Player Performance Retrieve current ratings, win/loss records, and basic profile details for any specific player. ### Research Game History Access complete monthly archives of a user's games to analyze openings or spot performance patterns over time. ### Determine Global Rankings List and query current top player leaderboards for all major chess formats, filtering by title or region. ### Solve Puzzles and Tactics Fetch the official daily puzzle or generate random tactics to use for training and skill improvement. ### View Community Details Get metadata about specific chess clubs, tournaments, or active streamers on the platform. ## Use Cases ### Preparing for a coaching session A coach needs to assess three students. Instead of manually checking their profiles, the agent runs `get_player_stats` on all three, quickly showing current ratings and recent win/loss streaks so the coach can focus lessons immediately. ### Creating content about chess history A content creator wants a 'Top 10 GMs' list. They use `list_titled_players` to get candidates, then run `get_player_game_archives` for each one to find impressive historical matches and write the article. ### Quickly solving a tough puzzle A player is training. They ask the agent to pull `get_daily_chess_puzzle`, then follow up by requesting a random tactic using `get_random_chess_puzzle` to keep the session varied and focused. ### Tracking a rival's recent performance A competitive player tracks an opponent. They first use `get_player_profile` for basic info, then request `get_global_leaderboards` to see if the opponent has climbed ranks since their last major tournament. ## Benefits - Get instant performance snapshots: Instead of navigating deep into a profile, use `get_player_stats` to pull current ratings and win/loss records for immediate analysis. - Deep dive into openings: Use the combination of `get_player_game_archives` and `get_player_monthly_games` to analyze specific opening trends over time. You can't do that by hand. - Keep your audience engaged: With `get_daily_chess_puzzle`, you always have access to today’s official puzzle, saving the manual step of visiting the site each morning. - Track talent globally: Need to know who the top GMs are in Blitz right now? Use `get_global_leaderboards` and `list_titled_players` together for a full scouting report. - Saves time on research: Instead of copying and pasting stats from multiple pages, your agent gathers all necessary data points—like tournament details via `get_tournament_metadata`—in one go. ## How It Works The bottom line is that your AI client handles all the database querying; you just ask a natural language question. 1. Subscribe to this MCP through Vinkius and connect your agent from any compatible client. 2. Prompt your agent with a query, like 'What is Magnus Carlsen's rating in Blitz?' 3. The agent calls the necessary tool and returns structured data: ratings, archives, or puzzle details—all ready for immediate use. ## Frequently Asked Questions **How do I check a player's current ratings using get_player_stats?** You ask the agent directly. Just tell it which player and which rating format (Blitz, Rapid) you want to see. It pulls the most recent official data point for you. **Can I use get_player_game_archives for opening research?** Absolutely. You can tell your agent to pull monthly game archives for a specific user, letting you analyze their historical play against known openings over time. **Is the daily puzzle always available using get_daily_chess_puzzle?** Yes. The tool retrieves the official daily featured tactic from Chess.com, so you don't have to worry about finding it manually every day for your content. **What if I want a random puzzle? Do I use get_random_chess_puzzle?** Yes, `get_random_chess_puzzle` pulls a fresh tactic from the database. This is useful when you're running training sessions and need variety. **How do I filter the results when using get_global_leaderboards?** You specify parameters like format or time range. The tool requires you to pass specific filters, such as 'Blitz' or 'Rapid', to narrow down the leaderboard scope accurately. **What information does the get_player_profile return?** It provides basic, public metadata about a player’s account. This includes their username, join date, and general activity status, but it won't give you detailed ratings or game history. **What criteria must I use for list_titled_players?** You need to provide the specific title abbreviation (like GM or IM). The tool searches the database and returns a comprehensive list of all players globally who hold that exact rank. **What happens if I run get_chess_club_details with an invalid club ID?** The MCP handles this by returning a standardized error message. This allows your agent to detect the failure and manage the incorrect input gracefully without crashing.