How to Use the Chess.com MCP in Windsurf

Q: How do I check a Chess.com player's current rating inside Windsurf?

Ask Cascade to look up the username. It triggers getplayerstats to return their rapid, blitz, and bullet ratings instantly.

Q: Can Windsurf fetch my entire Chess.com game history automatically?

Yes. Windsurf uses getplayergamearchives to find every month you played, then pulls the PGNs using getplayermonthlygames.

Q: How do I find active titled players from a specific country?

Use gettitledplayers to get usernames of grandmasters, then filter them by country using getcountryplayers in a quick chain.

Get instant Chess.com stats, game archives, and puzzles inside Windsurf without writing API boilerplate.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chess.com MCP to Windsurf

Create your Vinkius account to connect Chess.com to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Chess.com with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull live Chess.com match data with Windsurf

The `get_player_current_games` tool retrieves active correspondence matches directly into your workspace. Cascade chains this with `get_player_stats` to analyze your opponent's historical strengths and weaknesses. It compiles the rating gaps and openings so you know exactly who you are up against before making your next move. Windsurf tracks these details automatically during your coding session. You get a clean breakdown of active boards without opening a browser tab.

Build automated training sets using this MCP Server

The `get_player_monthly_games` and `get_player_game_archives` tools let you download historical PGNs for any player. Cascade grabs the list of available months, fetches the requested game archives, and organizes them into local files. You get clean raw data for analysis without manual searching. This setup works perfectly when you want to build custom databases of specific openings. The agent handles the pagination and file saving while you focus on studying the lines.

Grab daily tactics and puzzles on demand

The `get_daily_puzzle` and `get_random_puzzle` tools fetch active tactical positions directly into your editor. Cascade reads the FEN string, formats the solution moves, and displays the board layout. It is a quick way to warm up before a coding session or test your chess engine parser. You do not need to hunt down puzzle coordinates. The MCP server delivers the raw data payload directly to your workspace, allowing immediate integration with your active projects.

Setup guide

Set up Chess.com MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Chess.com MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Chess.com payment history." If connected, Cascade will call the Chess.com tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "chesscom-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Chess.com now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Chess.com MCP in Windsurf

Ask Cascade to look up the username. It triggers `get_player_stats` to return their rapid, blitz, and bullet ratings instantly.

Yes. Windsurf uses `get_player_game_archives` to find every month you played, then pulls the PGNs using `get_player_monthly_games`.

No. This MCP server only accesses public API data and correspondence games. It cannot make moves in real-time matches.

Use `get_titled_players` to get usernames of grandmasters, then filter them by country using `get_country_players` in a quick chain.

Yes, it is completely secure. This server only reads public profile data, stats, and published game histories. No private credentials or personal account settings are ever touched or stored by Vinkius.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript