Chess.com API and MCP server for AI agents
Let Claude, ChatGPT or your own agent read Chess.com. No Chess.com API key needed.
Add to your agent
Paste this into Claude Code, Cursor, Codex or any agent. It adds the server itself.
Read https://bowmark.ai/sites/chess_com.md and add Bowmark's Chess.com MCP server to my agent.Run this in a terminal, then sign in when the browser opens.
claude mcp add --transport http bowmark-chess-com https://api.bowmark.ai/mcp/site/chess_comPress the button, or add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"bowmark-chess-com": {
"url": "https://api.bowmark.ai/mcp/site/chess_com"
}
}
}Press the button, or run this in a terminal.
code --add-mcp '{"name":"bowmark-chess-com","type":"http","url":"https://api.bowmark.ai/mcp/site/chess_com"}'Run this in a terminal.
codex mcp add bowmark-chess-com --url https://api.bowmark.ai/mcp/site/chess_comIn Claude, open Plugins → Add → Add custom connector, paste this URL, and pick Sign in now.
https://api.bowmark.ai/mcp/site/chess_comIn ChatGPT, open Plugins, press +, choose Add custom MCP server and paste this URL.
https://api.bowmark.ai/mcp/site/chess_comAny MCP client that takes a remote (streamable HTTP) server: give it this URL.
https://api.bowmark.ai/mcp/site/chess_comFunctions
Open a function to see its parameters and run it with your own API key.
getDailyPuzzleReads today's daily puzzle: title, FEN, PGN solution, image and URL.POST /v1/sites/chess_com/getDailyPuzzle
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getDailyPuzzle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.chess_com.getDailyPuzzle();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.chess_com.getDailyPuzzle())Responsereturns chess_comPuzzleinterface chess_comPuzzle { title: string; url: string | null; fen: string; pgn: string | null; // the solution imageUrl: string | null; publishedAt: string | null; }getLeaderboardsReads the top-50 leaderboards for each game type, puzzles and Puzzle Rush.POST /v1/sites/chess_com/getLeaderboards
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getLeaderboards \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.chess_com.getLeaderboards({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.chess_com.getLeaderboards({}))Responsereturns chess_comLeaderboard[]interface chess_comLeaderRow { rank: number | null; username: string; score: number | null; title: string | null; country: string | null; url: string | null; } interface chess_comLeaderboard { category: string; // "live_blitz", "daily", "tactics", … players: chess_comLeaderRow[]; }getPlayerReads a Chess.com player profile: name, title, country, avatar, join date, last online, followers, status.POST /v1/sites/chess_com/getPlayer
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getPlayer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"hikaru"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.chess_com.getPlayer({ username: "hikaru" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.chess_com.getPlayer({"username": "hikaru"}))Responsereturns chess_comPlayerinterface chess_comPlayer { username: string; playerId: number | null; name: string | null; title: string | null; // "GM", "IM", … or null url: string | null; avatarUrl: string | null; country: string | null; // ISO code, e.g. "US" location: string | null; followers: number | null; status: string | null; // "basic", "premium", "closed", … league: string | null; isStreamer: boolean; twitchUrl: string | null; joined: string | null; // ISO instant lastOnline: string | null; }getPlayerStatsReads a player's current and best ratings and win/loss/draw record for bullet, blitz, rapid, daily, puzzles and Puzzle Rush.POST /v1/sites/chess_com/getPlayerStats
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getPlayerStats \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"hikaru"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.chess_com.getPlayerStats({ username: "hikaru" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.chess_com.getPlayerStats({"username": "hikaru"}))Responsereturns chess_comRating[]interface chess_comRating { mode: string; // "chess_rapid", "chess_blitz", "tactics", "puzzle_rush", … rating: number | null; ratingDeviation: number | null; lastPlayed: string | null; bestRating: number | null; bestGameUrl: string | null; wins: number | null; losses: number | null; draws: number | null; }