chessvox-mcp
Use this MCP server to query ChessVox's public, read-only chess data from AI clients without an account or API key.
Fetch today's daily puzzle, or a past UTC day's puzzle, with FEN, UCI solution, rating, and play-online link.
Get a shuffled batch of 20 mate-in-1 Brain Arcade puzzles rated 600–1800, each with FEN and winning UCI move.
List free ChessVox starter opening repertoires, including color, description, style tags, line count, and UCI preview moves.
Use read-only GET calls only; account-only features like Stockfish analysis and saved games are not included.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@chessvox-mcp show me today's chessvox daily puzzle and its solution"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
chessvox-mcp
An MCP (Model Context Protocol) server that exposes chessvox.com's public, read-only chess data to AI clients like Claude Code, Claude Desktop, and Cursor — no account, no API key.
One line about the site: chessvox.com is a free suite of chess tools — a daily puzzle, tactic trainers, mate-rush drills, blindfold and vision trainers, opening repertoires, and engine-powered game review (its deeper features live in the ChessVox apps).
Tools
Tool | What it does | chessvox.com endpoint |
| Today's puzzle (or any past day): FEN, UCI solution, rating |
|
| Batch of 20 mate-in-1 training puzzles (rating 600–1800) |
|
| The free ChessVox starter opening repertoires with preview lines |
|
Every call is a read-only GET against the public chessvox.com API. The server sends no secrets, collects no telemetry, and writes nothing. Only endpoints that work without a login are exposed — ChessVox's server-side Stockfish analysis and saved-game tools require an account and are intentionally not included.
chessvox_daily_puzzle
Get the ChessVox daily puzzle for today, or for a past UTC day.
Input
{ "day": "2026-10-20" }day is optional and must be a real YYYY-MM-DD UTC date not in the future. Omit it for today's puzzle.
Output
{
"dayUtc": "2026-10-28",
"fen": "r1b2rk1/1p3ppn/p1p1pq1p/4p3/2PP1n2/P4N2/1PQ2PPP/1BR1RNK1 w - - 0 17",
"solutionUci": ["c2h7"],
"rating": 666,
"playOnline": "https://chessvox.com/daily-puzzle"
}The side to move is whatever the FEN says (w here). solutionUci is the full solution, UCI-encoded — c2h7 is Qxh7#.
chessvox_mate_rush_puzzles
A shuffled batch of 20 mate-in-1 puzzles from the Brain Arcade pool. No input.
Output (truncated to 2 of 20)
{
"count": 20,
"puzzles": [
{ "fen": "6k1/1pq4p/pr3QpB/4p3/4bp2/P1P4P/6P1/6RK w - - 2 40", "solutionUci": ["f6f8"] },
{ "fen": "1R6/5k2/3K2pB/p2p1b1p/3P4/1P4P1/4r3/8 w - - 10 41", "solutionUci": ["b8f8"] }
]
}chessvox_starter_repertoires
The ChessVox-authored starter repertoires from the openings hub. No input.
Output (truncated to 1 of 20)
{
"count": 20,
"starters": [
{
"slug": "italian-game",
"name": "Italian Game",
"color": "white",
"description": "Quick development, a calm c3 + d3 centre and a long kingside squeeze. The friendliest way to start with 1.e4 e5.",
"styles": ["Positional", "Easy"],
"lineCount": 8,
"previewMoves": ["e2e4", "e7e5", "g1f3", "b8c6", "f1c4", "f8c5", "c2c3", "g8f6"]
}
]
}previewMoves is the main line in UCI — handy for stepping through an opening move by move.
Related MCP server: MCP Chess.com Server
Install
Requires Node 18+ and git.
npx -y github:MohamedCHAMI/chessvox-mcpOnce the package is published to npm this will shorten to npx -y chessvox-mcp. The -y flag matters: without it, npx prompts for confirmation on stdin and hangs a non-interactive MCP host.
Claude Code
claude mcp add chessvox -- npx -y github:MohamedCHAMI/chessvox-mcpor in .mcp.json:
{
"mcpServers": {
"chessvox": { "command": "npx", "args": ["-y", "github:MohamedCHAMI/chessvox-mcp"] }
}
}Claude Desktop
Add to claude_desktop_config.json (via Settings → Developer → Edit Config):
{
"mcpServers": {
"chessvox": { "command": "npx", "args": ["-y", "github:MohamedCHAMI/chessvox-mcp"] }
}
}Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json per project):
{
"mcpServers": {
"chessvox": { "command": "npx", "args": ["-y", "github:MohamedCHAMI/chessvox-mcp"] }
}
}Behavior & limits
Timeout: every request to chessvox.com aborts after 10 s and returns a clear error.
Caching: modest in-memory cache (daily puzzle 5 min, mate rush 2 min, starters 1 h) with true LRU eviction, in-flight dedupe (parallel identical calls share one request), and TTLs that never leak today's puzzle into the next UTC day.
Rate limits: chessvox.com allows roughly 20–60 anonymous requests/minute per endpoint. On HTTP 429 or a 5xx the server cools down for a minute and serves the last cached data if it has any; the cache keeps a normal session far below the limits anyway.
Failure mode: network errors, timeouts, and upstream failures return MCP tool errors (
isError: true) with a human-readable explanation — the server never crashes or hangs.Privacy: no telemetry, no logging of your prompts, no API keys, no account needed.
Development
npm install
npm run build # type-check + emit to dist/
npm test # node:test suite, fetch is mocked — no network neededLicense
MIT © ChessVox
Available Tools
3 toolschessvox_daily_puzzleChessVox daily puzzleA
Get the ChessVox daily puzzle (https://chessvox.com/daily-puzzle) for today, or for a past UTC day via the optional day argument. Returns the puzzle FEN, the full solution as UCI moves (e.g. ["c2h7"] for Qxh7#), and its player rating. The side to move is given by the FEN. Useful for showing a puzzle, hinting the first solution move, or verifying a user's answer.
Inputs: day.
chessvox_mate_rush_puzzlesChessVox mate-in-1 puzzlesA
Get a batch of 20 mate-in-1 training puzzles from the ChessVox Brain Arcade pool (https://chessvox.com/arcade), player ratings 600–1800. Each puzzle has a FEN and its winning move in UCI. Ideal for quick tactic drills or generating practice positions.
Inputs: no named parameters.
chessvox_starter_repertoiresChessVox starter repertoiresA
List the free ChessVox-authored starter opening repertoires (https://chessvox.com/openings), e.g. the Italian Game or the Caro-Kann. Each entry has the color, a plain-language description, style tags, the number of lines, and the UCI preview moves of the main line. Use it to recommend a first repertoire or to show what a specific opening looks like move by move.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
All three tools target distinct resources: a single daily puzzle, a batch of mate-in-1 drills, and a list of starter repertoires. The two puzzle tools share the same output shape (FEN + UCI solution), so an agent skimming could momentarily confuse them, but the descriptions make the daily-vs-batch distinction explicit.
All names follow a uniform pattern: consistent `chessvox_` server prefix plus snake_case descriptive noun phrases. No mixed conventions or vague verbs anywhere in the set.
Three tools is lean but each covers a genuinely different content type (daily content, drill batches, opening repertoires), so nothing feels redundant. It is on the thin side for a puzzle/opening domain, but not inappropriately so for a narrow read-only content API.
The surface covers puzzles and a repertoire listing, but there is no way to fetch a repertoire's full line tree (only preview moves), no puzzle lookup by rating or theme, and no answer-checking tool despite that being a stated use case. Agents can work around these limits but will hit visible dead ends.
Related MCP Connectors
Tools for AI agents, pay per call in USDC (x402): privacy scan, site/email/VIN checks, chess, more
Three server-checked puzzles a day for AI agents: one to read, one to compute, one black box.
Free public web freshness and response-metadata checks for AI agents.
Real SEO data for AI assistants: page audits, Keyword Planner volumes, Search Console history.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to explore player profiles, ratings, game archives, leaderboards, clubs, and puzzles via the Chess.com API.2MIT
- -licenseNot gradedqualityNot gradedmaintenanceProvides access to Chess.com's public API, allowing AI assistants to fetch player information and statistics.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to retrieve Chess.com player profiles, statistics, and daily puzzles through the Model Context Protocol.12 npmMIT
- AlicenseBqualityBmaintenanceEnables natural-language access to Chess.com's public API, exposing player, club, tournament, puzzle, and leaderboard data through tools and resources without authentication.30MIT