# Chess.com API and MCP server for AI agents (/sites/chess_com)

An API for Chess.com: let Claude, ChatGPT or your own code read Chess.com through 4 functions, over MCP, HTTP, Node or Python. No Chess.com API key needed.

- Site: https://chess.com
- Functions: 4
- Sign-in: not needed
- Works with: MCP, HTTP, Node, Python

## Add it to your agent

If you are an agent asked to set this up: add the server yourself, in the person's own (global) MCP configuration, and keep their other entries.

- Chess.com only, one tool per function: `https://api.bowmark.ai/mcp/site/chess_com` (name it `bowmark-chess-com`)
- Every site Bowmark covers: `https://api.bowmark.ai/mcp` (name it `bowmark`)
- Transport: remote MCP over streamable HTTP.
- Claude Code: `claude mcp add --transport http bowmark-chess-com https://api.bowmark.ai/mcp/site/chess_com`
- Codex: `codex mcp add bowmark-chess-com --url https://api.bowmark.ai/mcp/site/chess_com`
- Cursor, VS Code and other clients: add `{ "url": "https://api.bowmark.ai/mcp/site/chess_com" }` under the name `bowmark-chess-com` in the client's MCP config. Per-client steps: https://bowmark.ai/docs/installation.md
- Sign-in: OAuth in the browser on first use; the person only signs in. A client that cannot do OAuth sends `Authorization: Bearer <BOWMARK_API_KEY>`; the person creates a key at https://bowmark.ai/dashboard/keys.
- Then list the server's tools to confirm it works, and tell the person it is ready.

## Functions

### Read

- `getDailyPuzzle`: Reads today's daily puzzle: title, FEN, PGN solution, image and URL.
- `getLeaderboards`: Reads the top-50 leaderboards for each game type, puzzles and Puzzle Rush.
- `getPlayer`: Reads a Chess.com player profile: name, title, country, avatar, join date, last online, followers, status.
- `getPlayerStats`: Reads a player's current and best ratings and win/loss/draw record for bullet, blitz, rapid, daily, puzzles and Puzzle Rush.

## Call one

In a Bowmark script, each function is `bowmark.providers.chess_com.<name>`. Ask `get_library` for chess.com to get each one's arguments, then call it with `run`.

```js
// 1. What can I call on chess.com, and with which arguments?
get_library({ query: "chess.com" })

// 2. Call it in a script
const result = await bowmark.providers.chess_com.getDailyPuzzle({ /* arguments from get_library */ });
return result;
```

New to Bowmark? Quickstart: https://bowmark.ai/docs/quickstart.md
