An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Chess.com to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Pull real-time chess data and player stats directly into your chat.

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

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 15 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 01

    Get club info

    Fetch metadata for a specific Chess.com club using its URL. It returns the club name, description, member count, and admin details.

  2. 02

    Get country players

    List usernames of players registered in a specific country using ISO codes. Use this to find players from a particular nation.

  3. 03

    Get daily puzzle

    Retrieve the official Chess.com daily puzzle. This includes the FEN position, the solution moves, and the puzzle rating.

  4. 04

    Get player clubs

    Identify which clubs a specific player belongs to. It provides club names, URLs, and membership counts.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 05

    Get player current games

    Check a player's active correspondence games. It returns the current FEN position, opponent info, and time controls.

  2. 06

    Get player monthly games

    Access a player's finished game history for a specific month. This capability provides full PGN data, accuracy ratings, and opening names.

  3. 07

    Get player profile

    Get basic identity info for a username. It returns the display name, avatar, join date, and official titles.

  4. 08

    Get player stats

    Pull detailed rating data for a player. It covers blitz, bullet, rapid, daily, and puzzle rush performance.

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through Chess.com.

  1. 09

    Get titled players

    Filter for players holding specific official titles like GM, IM, or FM. Use this to find grandmasters on the platform.

  2. 10

    Get club members

    List the weekly active members of a specific club. It provides usernames and profile links for community members.

  3. 11

    Get leaderboards

    View the top-rated players on Chess.com. It covers various categories including blitz, bullet, rapid, and puzzle rush.

  4. 12

    Get player game archives

    List the available monthly game archives for a player. This helps you identify which months have recorded game data.

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through Chess.com.

  1. 13

    Get random puzzle

    Grab a random tactical puzzle from the database. It includes the FEN, the solution, and the source game info.

  2. 14

    Get streamers

    Find verified Chess.com content creators. It returns their platform, stream URL, language, and follower counts.

  3. 15

    Is player online

    Check if a specific player is currently connected to Chess.com. It returns a simple online status.

Real work

What teams actually run

01

Opponent Scouting

Check a potential opponent's ratings and recent game history before a match.

02

Opening Study

Retrieve specific game archives to study how certain openings were played in high-rated matches.

03

Daily Training

Ask your agent for a puzzle every morning to keep your tactical skills sharp.

04

Community Research

Find the strongest players in a specific country or within a particular club.

Automate a task

Put Chess.com to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Chess.com works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Chess.com to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1016ms average. Fast in production.

Chess.com is checked daily against the live service.

Daily averagePeak 1106ms
Oct 3Today
Fastest day
794ms
Slowest day
1106ms
14-day trend
Stable-1%

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

Guided setup for Claude? Set up Chess.com in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Chess.com owners hand off.

This MCP is built for anyone who uses AI to supplement their chess study or research.

  • 01

    Chess Players

    Analyze your own game history and check opponent stats without leaving your chat.

  • 02

    Coaches

    Pull player statistics and game records to prepare for student analysis.

  • 03

    Content Creators

    Quickly grab leaderboard data or streamer info for video prep.

FAQ

Questions Chess.com owners ask.

  • 01

    Do I need a Chess.com account to use this?

    No. This MCP uses the public Chess.com API, so you can query data without any authentication or account requirements.

  • 02

    Which AI clients can I use with this MCP?

    You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I get the actual moves from a game?

    Yes. You can use the monthly games capability to retrieve full PGN data for finished games.

  • 04

    Does this work for live games?

    The capability can check if a player is online or see their active correspondence games, but it does not provide real-time data for live games currently in progress.

  • 05

    How do I find grandmasters on the platform?

    You can use the titled players capability to filter for specific titles like GM or IM.

  • 06

    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.

  • 07

    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.

  • 08

    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

Connect Chess.com to Claude, Cursor, ChatGPT & more