Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Chess.com with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access Chess.com player profiles, stats, games, puzzles, and leaderboards directly from any AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 15 capabilities

The complete Chess.com capability set.

These are the exact actions your AI can choose when you ask it to work with Chess.com.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 01

    Get club info

    Com club by its URL identifier. Returns the club name, description, creation date, last activity date, visibility status, admin information, and total member count. Use this capability to learn about a club before joining, verify club existence, or gather metadata about chess communities. Get information about a Chess.com club

  2. 02

    Get country players

    Com players who have registered with a specific country. Takes an ISO 3166-1 country code (e.g., "US" for United States, "BR" for Brazil, "IN" for India, "RU" for Russia, "NO" for Norway). Returns an array of player usernames affiliated with that country. Use this capability to discover players from a specific nation, find local opponents, or research the chess scene in different countries. Get Chess.com players from a specific country

  3. 03

    Get daily puzzle

    Com daily puzzle including the puzzle position (FEN), the sequence of moves for the solution, the puzzle rating, and the associated game metadata (players, result, opening). Use this capability to get a tactical puzzle to solve, practice chess tactics, or study interesting positions from real games. The puzzle changes once per day. Get the Chess.com daily puzzle

  4. 04

    Get player clubs

    Com clubs that a specific player belongs to. Returns club names, URLs, creation dates, and membership counts. Use this capability to discover a player community affiliations, find clubs with similar interests, or identify potential clubs to join based on where strong players are members. Get clubs that a Chess.com player is a member of

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 05

    Get player current games

    Com player. Returns game details including opponent username, current position (FEN), time control, last activity date, and game URL. Use this capability to check what ongoing games a player has, see who they are playing against in daily chess, or monitor active correspondence matches. Does not include live (real-time) games that are currently being played. Get a player's currently active daily (correspondence) games

  2. 06

    Get player monthly games

    Com player during a specific year and month. Returns detailed PGN data, game results, opponent usernames, opening names, time controls, accuracy ratings (if available), and game end reasons. Use this capability to analyze a player game history, study their openings, review losses against specific opponents, or collect training data. Month is 1-indexed (January = 1, December = 12). Get all finished games for a player in a specific month

  3. 07

    Get player profile

    Com player by username. Returns the player display name, avatar URL, join date, last online timestamp, follower count, country, and title if applicable (GM, IM, FM, etc.). Use this capability to verify a username exists and gather basic identity information about a Chess.com player before querying their stats or games. Get Chess.com player profile information

  4. 08

    Get player stats

    Com player. Returns current and best ratings across all game types (chess_rapid, chess_blitz, chess_bullet, chess_daily, puzzle_rush, lessons), plus win/loss/draw records for each time control. Use this capability to evaluate a player skill level, check their peak ratings, or compare performance across different time controls. Get Chess.com player statistics including ratings and records

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 09

    Get titled players

    Com players who hold a specific chess title. Supported titles include: GM (Grandmaster), IM (International Master), FM (FIDE Master), CM (Candidate Master), WGM (Woman Grandmaster), WIM (Woman International Master), WFM (Woman FIDE Master), WCM (Woman Candidate Master), NM (National Master), and LM (Legends Master). Returns an array of usernames. Use this capability to find all grandmasters on Chess.com, locate titled players for study, or verify if a player holds an official title. Get list of titled players by title type

  2. 10

    Get club members

    Com club. Each entry includes the member username and their profile URL. Use this capability to discover active players within a specific club community, find potential opponents who share your chess interests, or identify titled players within a club roster. Get weekly active members of a Chess.com club

  3. 11

    Get leaderboards

    Com leaderboards showing the highest-rated players across different game categories. Returns top players for daily chess (correspondence), blitz, bullet, and rapid time controls, plus puzzle rush leaders. Each entry includes username, current rating, and profile URL. Use this capability to identify the strongest active players on Chess.com, track rating leaders, or find grandmaster accounts to study. Get Chess.com leaderboards for top players

  4. 12

    Get player game archives

    Com player. Each URL corresponds to a specific year/month combination where the player has recorded games. Use this capability to discover which months have available game data before fetching actual games with get_player_monthly_games. The returned URLs can be parsed to extract year and month parameters. Get list of available game archive URLs for a player

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through Chess.com.

  1. 13

    Get random puzzle

    Com puzzle database. Returns the puzzle position (FEN), the complete solution moves, puzzle rating, and the source game information (white player, black player, result, opening name). Use this capability for unlimited tactical practice sessions, training sessions, or when you want a fresh puzzle that is not the daily puzzle. Get a random chess puzzle from Chess.com

  2. 14

    Get streamers

    Com verified streamers. Each entry includes the streamer username, streaming platform (Twitch, YouTube, etc.), stream URL, language, and follower count. Use this capability to find chess content creators to watch, discover educational streams in your preferred language, or locate titled players who regularly broadcast their games. Get the list of official Chess.com streamers

  3. 15

    Is player online

    Com player. Returns a simple status object indicating whether the player is currently connected to Chess.com servers. Useful for determining if a daily chess opponent or streamer is actively playing right now before attempting to challenge them. Check if a Chess.com player is currently online

Observed, not estimated

950ms average. Fast in production.

Chess.com is checked daily against the live service.

Daily averagePeak 1152ms
Aug 20Today
Fastest day
742ms
Slowest day
1152ms
14-day trend
Slowing+39%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 15 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Chess.com, so you can see the experience inside your AI.

It does not authenticate your account with Chess.com. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Chess.com Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Chess.com capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "chesscom-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Chess.com owners ask.

  • 01

    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.

  • 02

    Can I retrieve my complete game history with PGN data for a specific month?

    Yes! Use the get_player_monthly_games capability 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.

  • 03

    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.

Explore

More in Education

Suggestions