AI assistants
Use Chess Analytics in your AI assistant.
Connect ChatGPT, Claude or another assistant that supports the Model Context Protocol (MCP) and ask about your games in plain language. Your dashboard, game reviews and trend reports show up right in the chat.
ChatGPT
- 1
In ChatGPT, open Apps (also called connectors) and search for “Chess Analytics”. If it is not listed for you yet, the directory listing is still in review: turn on developer mode in Settings → Apps → Advanced settings, create an app and enter the server URL below instead.
- 2
Choose Connect. ChatGPT sends you to our sign-in page, where you log in with your Chess Analytics account, including two-factor authentication or a passkey if you use one.
- 3
Check the permissions shown on our consent page and approve. Then start a chat and ask about your games.
Server URL for developer mode, with OAuth as the authentication:
https://app.chess-analytics.app/mcpClaude (claude.ai and Desktop)
- 1
In claude.ai or Claude Desktop, open Customize → Connectors and look for “Chess Analytics” in the directory. If it is not listed yet, choose Add custom connector instead.
- 2
For a custom connector, enter the URL below and leave any advanced OAuth fields empty.
- 3
Choose Connect, sign in with your Chess Analytics account on our page and approve. Enable the connector in your chat and ask away.
https://app.chess-analytics.app/mcpCursor, VS Code, Claude Code and other clients
Add a remote MCP server with the URL below, transport Streamable HTTP. If your client supports OAuth, it opens our sign-in page the first time you use a tool. If it does not, create a personal access token in Settings → Connected apps & tokens and send it as Authorization: Bearer …. Treat the token like a password.
Generic configuration
{
"mcpServers": {
"chess-analytics": {
"url": "https://app.chess-analytics.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Claude Code
claude mcp add --transport http chess-analytics https://app.chess-analytics.app/mcpThen run /mcp in Claude Code to sign in.
What your assistant can do
It works with your own games only. The assistant picks the right tool for your question, and in supported apps shows an interactive view.
Included with a Free account
Your dashboard
Results, ratings, openings and endings for your latest games, filtered by site and time control.
Game reviews
An interactive board with eval graph, move classification and comments for games that have been analysed.
Trend reports
Reports for a week, month or other period, compared with the one before, with focus areas.
Stored AI reviews
The written review of your latest games, if you have created one in the app.
Premium
Analyse a game
Queue a Stockfish analysis of a game from your linked account, or of a pasted PGN, and check its progress.
Analyse recent games
Queue the newest games that have no analysis yet, in one request.
Create an AI review
Have the AI coach write a review of your latest games, with strengths, weaknesses and a training plan.
Things to ask
- “Show my chess dashboard for the last 50 games”
- “Open the review of my most recent analysed game”
- “Show my latest trend report and what to work on”
- “Analyse this game and tell me where I went wrong: 1. e4 e5 2. Nf3 …”
- “How do I do against the Sicilian as Black in my blitz games?”
Security and privacy
- You sign in on our own page, never inside the assistant, with your normal account, including two-factor authentication and passkeys. Your password is never shared with the assistant.
- The consent page shows which assistant is asking and which permissions it wants: reading your games and reports, and optionally starting analyses. It cannot change your account settings, plan or credentials.
- Disconnect any assistant at any time in Settings → Connected apps & tokens. Access is revoked immediately, and changing your password revokes all connected apps and tokens.
- Personal access tokens are shown once, stored only as a hash on our side, and can expire after 30, 90 or 365 days.
What is shared and how it is processed is described in section 9 of the privacy policy.
Questions
Does it cost extra?
No. Connecting an assistant is included in your plan. Reading your dashboard, reviews and reports works with a Free account; starting engine analyses and AI reviews from the chat needs Premium, the same as in the app.
Which of my data does the assistant see?
Only what its tools return when you ask: your username and plan, linked chess.com and Lichess usernames, your game statistics, analyses, trend reports and AI reviews. Never your password, email address, two-factor secrets or Lichess token. From then on your chat provider processes it under your own agreement with them. Section 9 of the privacy policy has the details.
Which assistants work?
ChatGPT and Claude have a guided setup, and the interactive views appear in hosts that support MCP Apps. Any other client that speaks MCP over Streamable HTTP, such as Cursor, VS Code or Claude Code, works too, with text answers.