# Chess.com MCP for AI Agents AI Agent Connect > Chess.com gives you a direct line to the world's largest chess platform. You can pull player stats, dive into game archives, find daily puzzles, and scout leaderboards instantly. This Connector lets your AI agent handle the heavy lifting of data gathering, whether you are analyzing a grandmaster's opening or looking for a new club to join. No keys or complex setups are required to start querying the platform's public data. ## Overview - **Category:** education - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/ai-agent-connect - **Tags:** chess, chess-com, puzzles, player-stats, game-analysis, leaderboards, titled-players ## Description Imagine you are deep in a study session, trying to figure out why your opponent keeps winning with a specific opening. Instead of opening a dozen tabs to hunt down their past games, you just ask your agent to pull their monthly archives. You get the PGNs, the opening names, and the results immediately. This Connector turns your AI into a specialized chess researcher. You can scout the top players in the world, find specific titles like Grandmasters, or see who is currently active in the community. It is about moving from searching to knowing. If you are a content creator, you can find verified streamers and their platform links in seconds. For coaches, it means having a player's entire history ready for analysis without the manual copy-pasting. Because Vinkius hosts this Connector, it fits right into your existing workflow with Claude or Cursor, making the massive Chess.com ecosystem feel like a local database. You do not need to worry about authentication because the data is public. You can also pull puzzle rush scores, follower counts, and club rosters to get a full picture of a player's standing. Whether you are looking for tactical practice or deep historical data, you get it in one conversation. ## Tools ### get_club_members Lists the usernames of weekly active members in a specific club. Use it to see who is active. ### get_country_players Finds usernames of players registered under a specific ISO country code. Use it to scout regional scenes. ### get_leaderboards Shows top-rated players for blitz, bullet, rapid, and daily categories. Use it to see the best in the world. ### get_player_clubs Lists the clubs a specific player belongs to with their URLs. Use it to see community affiliations. ### get_player_current_games Shows ongoing daily correspondence games for a specific player. Use it to see what they are playing now. ### get_player_game_archives Lists the months and years where a player has recorded games. Use it to find available historical data. ### get_player_monthly_games Fetches all finished games for a player in a specific month with PGN data. Use it for deep analysis. ### get_player_stats Retrieves current and best ratings across all game types and records. Use it to evaluate player skill. ### get_random_puzzle Fetches a random puzzle from the database for tactical practice. Use it for unlimited training sessions. ### get_streamers Finds verified streamers with their platform links and follower counts. Use it to find content creators. ### is_player_online Checks if a specific player is currently connected to the platform. Use it to see if an opponent is active. ### get_daily_puzzle Gets the current daily puzzle including the FEN and solution moves. Use it to solve the daily challenge. ### get_titled_players Lists usernames of players holding specific titles like GM or IM. Use it to find elite players for study. ### get_club_info Retrieves the name, description, and member count for a specific club. Use it to research communities. ### get_player_profile Pulls a player's display name, avatar, join date, and titles. Use it to verify identity and basic info. ## Prompt Examples **Prompt:** ``` Who are the top 5 blitz players right now? ``` **Response:** ``` Here are the top 5 blitz players on Chess.com: 1. **Hikaru** (3254) 2. **DrNykterstein** (3215) 3. **ArjunErigaisi** (3198) 4. **DanielNaroditsky** (3176) 5. **CrazyBishop** (3145) These are some of the strongest blitz players in the world. Would you like me to pull the detailed stats for any of them? ``` **Prompt:** ``` Can you get me today's puzzle? ``` **Response:** ``` Today's Chess.com daily puzzle is rated at 1650. The position is from a real game where White is to move. The FEN is provided so you can set up the position on a board. **FEN:** `rnbqkbnr/pppppppp/8/4p3/4P3/8/PPPP1PPP/RNB1K1NR w KQkq - 0 1` Would you like me to walk through the solution step by step? ``` **Prompt:** ``` What are Hikaru's stats? ``` **Response:** ``` I've pulled the stats for Hikaru. Here is his current performance: | Game Type | Current Rating | Best Rating | | :--- | :--- | :--- | | Blitz | 3254 | 3393 | | Bullet | 3421 | 3527 | | Rapid | 2890 | 2978 | | Daily | 2650 | | He also has a Puzzle Rush best score of 78. ``` ## Capabilities ### Pull detailed player ratings Get current and best ratings across blitz, bullet, rapid, and daily game types. ### Retrieve full PGN data Fetch complete game records for specific months including opening names and accuracy. ### Get daily puzzles Grab the official daily puzzle or random tactical challenges for practice. ### Scout club members Identify active players and rosters within specific community clubs. ### Find verified streamers Locate official content creators and their links across Twitch and YouTube. ### Filter titled players List usernames for specific titles like Grandmaster, International Master, and more. ### Check online status Verify if a specific player is currently connected to the platform in real time. ## Use Cases ### Analyzing an Opponent A player wants to know why they keep losing to a specific user. They ask the agent to pull that user's monthly archives to find common opening patterns using get_player_monthly_games. ### Content Planning A YouTuber wants to find the top 10 blitz players. They ask the agent to pull the blitz leaderboard and then get the profile for each using get_leaderboards and get_player_profile. ### Daily Training A student wants a daily workout. They ask the agent to get the daily puzzle and then a random puzzle for extra practice using get_daily_puzzle and get_random_puzzle. ### Club Scouting A user wants to find a community. They ask the agent to find clubs a specific grandmaster belongs to and then get the member list using get_player_clubs and get_club_members. ## Benefits - Stop manual searching by pulling player profiles and stats instantly with get_player_profile and get_player_stats. - Study high-level play by fetching full PGN data from monthly archives using get_player_monthly_games. - Keep your training fresh by grabbing the daily puzzle or random tactics with get_daily_puzzle and get_random_puzzle. - Research community trends by viewing club rosters and member counts with get_club_info and get_club_members. - Scout competition by identifying titled players and top leaderboard rankings via get_titled_players and get_leaderboards. - Monitor content creators by pulling verified streamer lists and platform links with get_streamers. ## How It Works The bottom line is you get instant access to Chess.com data without needing to manage API keys or manual searches. 1. Subscribe to the Chess.com MCP on Vinkius. 2. Connect your AI client to the hosted instance. 3. Ask your agent to pull stats, games, or puzzles. ## Frequently Asked Questions **Can the Chess.com MCP pull my own game history?** Yes, it can retrieve finished games for any month you specify as long as they are recorded on the platform. This allows you to analyze your own patterns without manual exporting. **Do I need a Chess.com account to use this?** No, this Connector uses the public API, so you don't need to provide any login credentials or API keys. It works out of the box. **Can the agent play games for me?** No, this Connector is for data retrieval only. It lets you see ratings, stats, and PGNs, but it cannot move pieces or play matches. **Can I find out if a specific player is currently online?** Yes, the Connector can check a player's real-time connection status. This is helpful for seeing if a streamer or opponent is currently active. **How do I get PGN data for a specific month?** You can ask your agent to pull the archives for a player first, then request the specific month you're interested in to get the full PGN. **Can it find puzzles for me?** It can fetch the official daily puzzle or provide a random puzzle from the database for tactical training. **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.