Chess.com Connector for AI agents.
15 live capabilities
Analyze player stats and game history on the world's largest chess platform.
Waiting for input…
Why people use Chess.com
Chess.com : End the Manual Grind of Copy-Pasting Chess Stats
With this Connector, your agent does the heavy lifting. Just ask for a player's monthly archive or their best ratings, and the data appears instantly. You get a clean view of the facts without the clicks.
What Vinkius changes
You get instant access to Chess.com data without needing to manage API keys or manual searches.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Analyzing an Opponent
A player wants to know why they keep losing to a specific user.
- Real-world use case 02
Content Planning
A YouTuber wants to find the top 10 blitz players.
- Real-world use case 03
Daily Training
A student wants a daily workout.
Complete set · 15capabilities
The complete Chess.com capability set.
These are the exact actions your AI can choose when you ask it to work with Chess.com.
01—04
4 capabilities in this set.
Part of 15 available through Chess.com.
- 01 Capability
Get club members
Lists the usernames of weekly active members in a specific club. Use it to see who is active.
- 02 Capability
Get country players
Finds usernames of players registered under a specific ISO country code. Use it to scout regional scenes.
- 03 Capability
Get leaderboards
Shows top-rated players for blitz, bullet, rapid, and daily categories. Use it to see the best in the world.
- 04 Capability
Get player clubs
Lists the clubs a specific player belongs to with their URLs. Use it to see community affiliations.
05—08
4 capabilities in this set.
Part of 15 available through Chess.com.
- 05 Capability
Get player current games
Shows ongoing daily correspondence games for a specific player. Use it to see what they are playing now.
- 06 Capability
Get player game archives
Lists the months and years where a player has recorded games. Use it to find available historical data.
- 07 Capability
Get player monthly games
Fetches all finished games for a player in a specific month with PGN data. Use it for deep analysis.
- 08 Capability
Get player stats
Retrieves current and best ratings across all game types and records. Use it to evaluate player skill.
09—12
4 capabilities in this set.
Part of 15 available through Chess.com.
- 09 Capability
Get random puzzle
Fetches a random puzzle from the database for tactical practice. Use it for unlimited training sessions.
- 10 Capability
Get streamers
Finds verified streamers with their platform links and follower counts. Use it to find content creators.
- 11 Capability
Is player online
Checks if a specific player is currently connected to the platform. Use it to see if an opponent is active.
- 12 Capability
Get daily puzzle
Gets the current daily puzzle including the FEN and solution moves. Use it to solve the daily challenge.
13—15
3 capabilities in this set.
Part of 15 available through Chess.com.
- 13 Capability
Get titled players
Lists usernames of players holding specific titles like GM or IM. Use it to find elite players for study.
- 14 Capability
Get club info
Retrieves the name, description, and member count for a specific club. Use it to research communities.
- 15 Capability
Get player profile
Pulls a player's display name, avatar, join date, and titles. Use it to verify identity and basic info.
Set up in minutes
One URL. Then ask Chess.com to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Chess.com from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Chess.com, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Chess.com for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Chess.com URL.
- Step 03
Save and start
Save the connection and enable Chess.com in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"chesscom": {
"url": "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Chess.com
Open Agent mode in chat and ask: "Using Chess.com, help me...". 15 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"chesscom": {
"url": "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Chess.com
Ask Copilot: "Using Chess.com, help me...". 15 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"chesscom": {
"url": "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Chess.com
Open Cascade and ask: "Using Chess.com, help me...". 15 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"chesscom": {
"url": "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Chess.com
Ask Cline: "Using Chess.com, help me...". 15 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add chesscom --transport http "https://edge.vinkius.com/vk_preview_Tnz8kzuwQnoWHJqHmBdaRYfwy2ZGuFM9YPxKNDIf/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Chess.com
Ask Claude: "Using Chess.com, show me...". 15 tools are ready
Where the request belongs
Work Chess.com can move forward.
This is for chess enthusiasts who spend hours analyzing games, coaches who need to prep for students, and content creators who need to track platform trends.
Chess Coach
Pulls monthly game archives for students to analyze specific opening mistakes and tactical patterns.
Content Creator
Finds verified streamers and leaderboard trends to plan upcoming videos and community highlights.
Serious Player
Scouts top-rated players and fetches daily puzzles for daily tactical training and study.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsChess.com Global Intelligence
The definitive server for Chess.com. track player ratings, historical games, and daily puzzles via AI.
Combat Balance Checker
Quantify combat outcomes and attribute influence through large-scale simulations.
Skill Tree Optimization Engine
Optimize skill point allocation for maximum DPS, survivability, or balanced utility.
Poker Odds Calculator
Calculate exact probabilities, equities, and outs for Texas Hold'em and Omaha.
Lichess.org Open Chess Intelligence
The definitive server for Lichess.org. monitor live broadcasts, analyze player stats, and solve puzzles via AI.
B5 Arena
Automate Counter-Strike intelligence via B5 Arena. scan matchmaking leaderboards, track player ELO, and fetch competitive match logs natively from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Chess.com connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Chess.com.
The practical details behind the request, access and result.
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 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.
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.
One connection away
Give your agent a direct line to Chess.com.
Connect Chess.com once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available