Give your AI assistant a chess brain.
The Eloist MCP is the most comprehensive chess Model Context Protocol server available: 16 tools that let Claude — or any MCP client — analyze any Chess.com player's real games, search a 3,803-line openings database, read original opening guides and chess history, and analyze positions or full PGNs without an engine.
Add it in 30 seconds
Claude (web / desktop)
Settings → Connectors → Add custom connector → paste:
https://eloist.com/api/mcpClaude Code
claude mcp add --transport http eloist https://eloist.com/api/mcpAny MCP client
Streamable HTTP transport, JSON-RPC 2.0, no auth:
https://eloist.com/api/mcpThen just ask
- “Analyze shaunr0b's chess — what's actually costing them rating?”
- “How bad a flagger is my rival? Run a flag report on their username.”
- “Show me my repertoire as White — where are the holes?”
- “Where do I keep leaving opening theory, and what does the book play instead?”
- “Here's a PGN of my last game — find every piece I missed.”
- “Compare me and my friend head to head.”
- “Tell me the history of the Ruy Lopez.”
- “Is anything hanging in this position? [FEN]”
Player analysis tools 10
Work on any public Chess.com username. Every number is counted from real games — never estimated.
chess_personalityA Chess.com player's Eloist chess style profile (1 of 16 descriptive styles), style axes, and headline stats from their real games.
game_commonalitiesWhat a Chess.com player's games have in common: recurring openings, how their games end, where they leave the named-openings map, style, tilt/edge/momentum headlines, and best time to play.
diagnosticsA Chess.com player's ranked action plan: what's actually costing them rating (opening leaks, time trouble, tilt, named-map departures, opponent-edge, slides), each with a concrete fix.
off_bookHow long a Chess.com player's games keep matching a named opening: average depth on the 3,803-line naming map, who steps off first, the by-move curve, and their most common departure. Measures naming coverage, NOT opening theory.
flag_reportA Chess.com player's clock profile, counted from per-move clocks: wins on time (and how many were DIRTY — opponent flagged while the player was lost), losses on time while WINNING, play-on behaviour when dead lost, the shuffle speed-up test, and a verdict (Clock Vampire / Dirty Flagger / Flag Victim / Never Say Die / Board Player / Honest Clock).
missed_tacticsA Chess.com player's recent missed free material — positions where a capture won a piece by static exchange and they played something else. Returns FENs, the shot, what they played instead, and how many turns it stayed available.
repertoireA Chess.com player's ACTUAL opening repertoire as a tree built from their games: overall score as that color, their systems (positions they answer the same way almost every time), their holes (positions where they keep switching replies), and the most-played branches.
opening_departuresWhere a Chess.com player habitually leaves the opening book, per opening: their record, how deep they stay on the naming map, and their most recurrent departure with the book's continuations — the 'correct yourself back to book' data.
session_rhythmA Chess.com player's playing rhythm: recent sittings (record, rating swing, verdict), median session length, and the fatigue curve — does their win rate decay as a session drags on?
compare_playersHead-to-head profile comparison of two Chess.com players: style, rating, win rate, favorite openings, and who the numbers favor.
Chess knowledge tools 6
search_openingsSearch the 3,803-line classified chess openings database by name, ECO code, or moves. Returns matching lines with links.
opening_detailLook up one opening by its key (from search_openings) or exact name. Returns its moves, ECO, and family.
opening_guideEloist's original club-level guide for an opening family: what it wants, 4-6 concrete plans/traps, and the main line. 54 hand-written guides.
opening_loreCurated, verifiable chess history for an opening family — who named it, the champions who trusted it, the famous games. Hand-curated, never generated.
analyze_positionAnalyze a chess position (FEN): legality, side to move, check/mate state, material balance, every capture graded by static exchange (SEE) so hanging pieces stand out, and legal-move count.
analyze_pgnAnalyze a full game PGN without an engine: missed free material (SEE-counted, with FENs), the material story (when a side went dead lost), game length, and whether per-move clocks are present. Set my_color to grade one side's misses.
Built by Eloist — the chess analytics app that finds the recurring mistakes costing you rating. The MCP uses the same analyzers as the product: the Flag Report, the repertoire tree, the openings map, and the missed-tactics scanner. Player tools are rate-limited per IP to keep the service fast for everyone. Data comes from the Chess.com public API; openings data aggregates the lichess-org/chess-openings dataset.