MCP App Store
by KeenEthics
Chess Analytics icon

Chess Analytics MCP Server for ChatGPT

By Henry Rausch

Overview

Chess Analytics reviews your chess.com and Lichess games inside ChatGPT. What it does - Dashboard: results, ratings over time, openings and endings across your most recent games, filterable by site and time control. - Game review: an interactive board with the evaluation graph, move list and move-by-move comments for a game that has been analyzed with the Stockfish engine. - Analysis: queue an engine analysis of a game from your linked chess.com or Lichess account, or of a pasted PGN, and check its progress. - Trend reports: multi-game reports (for example weekly or monthly) that compare a period with the previous one and list focus areas. - Coach review: a written review of your latest games, built from the engine analysis. Tools get_profile, whoami, ping, get_dashboard, list_analyses, get_analysis, list_aggregates, get_aggregate, get_coach_review, analyze_game, analyze_recent_games, create_coach_review. Account A Chess Analytics account is required, with a chess.com username and/or a Lichess account linked in the Chess Analytics app. You sign in with that account when you connect. The app only reads and analyzes your own games. Data The app reads the games of your linked chess.com and Lichess accounts from those services and the analyses stored in your Chess Analytics account. See the privacy policy for what is stored and for how long.

How to connect

  1. ChatGPT: Open the Chess Analytics listing in the ChatGPT app directory and choose Connect. ChatGPT listing Chess Analytics exposes 12 tools here.

Tools

analyze_game

ChatGPT
Queue an engine analysis (Stockfish plus move comments and a report) of one game: a chess.com or Lichess game of the linked account, given by the url or id from get_dashboard, or pasted PGN text. Returns { id, status } immediately; an analysis that already exists comes back done. Poll get_analysis with the id until its status is done. Premium plan; limited to 30 games per hour.

analyze_recent_games

ChatGPT
Queue engine analyses for the user's most recent games that have none yet (1 to 20, newest first), optionally filtered by source and time class. Returns per game the id and status; poll get_analysis with an id for progress. Games that were already analyzed are skipped. Premium plan; each game counts toward the limit of 30 per hour.

create_coach_review

ChatGPT
Write an AI coach review of the user's latest 10 games for this source and time class (patterns across games, strengths, what to work on). All 10 games need a finished analysis first: otherwise nothing is written and status missing lists the games to pass to analyze_game. Returns the stored review if the same games were already reviewed. Uses a language model. Premium plan; limited to 5 per hour.

get_aggregate

ChatGPT
One multi-game trend report: the period compared with the previous one, engine-derived stats (accuracy, phases, openings, error patterns), the written report with focus areas and the games it covers. Returns progress while the report is still being built.

get_analysis

ChatGPT
One engine analysis of one game. While queued or running it returns status, progress and the queue position and estimate; call again later. When done it returns the players, opening, accuracy and move-quality counts per side, accuracy per phase, the written report and the key moments (worst mistakes and best moves) with the engine's preferred move and any move comment. With detail = full the text also lists every move. The structured result carries the complete analysis (every position and move comment) for the interactive game review view. Analyses are created with analyze_game.

get_coach_review

ChatGPT
The most recent stored AI coach review of the user's latest 10 games for this source and time class: the report, which analyses it covers and whether newer games exist since. Status none means no review has been created yet (create_coach_review creates one). Reads what is stored; it doesn't call the language model.

get_dashboard

ChatGPT
Results and trends over the user's most recent chess.com and/or Lichess games: win/draw/loss, score by site, time class and colour, rating changes, openings, how games ended, and a newest-first game list. Each game row has its url and, when analyzed, an analysis_id for get_analysis. Free plans get these statistics from the sites' own data; with Premium, games that have an engine analysis add accuracy and engine-derived stats (engine_stats). Fetches the game lists from chess.com and Lichess.

get_profile

ChatGPT
The signed-in user's account: username, plan (free or premium) and the linked chess.com and Lichess usernames. Plan and linked accounts determine what the other tools return: Premium is required for engine analyses and AI reviews; without a linked account the game tools have no games to show.

list_aggregates

ChatGPT
The user's multi-game trend reports (weekly, monthly, ...): id, period label, time class, source, status, number of games and accuracy. Use an id with get_aggregate. Lists what exists; it doesn't create reports.

list_analyses

ChatGPT
The user's engine-analyzed games, newest first: id, status (queued, running, done, failed), players, result, date, perspective and accuracy. Use an id with get_analysis. Lists what exists; it doesn't start analyses.

ping

ChatGPT
Check that the server is reachable. Returns { ok, version }.

whoami

ChatGPT
Show which Chess Analytics account this connection is signed in as, and its plan.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/chess-analytics"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/chess-analytics)