Lumichess in your AI assistant
Lumichess has an MCP server, so Claude, ChatGPT and other AI assistants can use it as a chess tool. Ask about a game, a player, an opening or a position, and the assistant answers from our data and gives you a link to see it on the board. It is free, and there is no account or key to set up.
Server address
https://lumichess.com/api/mcpTransport: Streamable HTTP. Authentication: none.
Add it to your assistant
Claude (web, desktop and mobile): add a custom connector in Claude's connector settings and paste the server address. Claude Code: run this once.
claude mcp add --transport http lumichess https://lumichess.com/api/mcpChatGPT: add a custom connector (developer mode) with the server address and no authentication.
Cursor: add this to mcp.json.
{ "mcpServers": { "lumichess": { "url": "https://lumichess.com/api/mcp" } } }VS Code: add this to .vscode/mcp.json.
{ "servers": { "lumichess": { "type": "http", "url": "https://lumichess.com/api/mcp" } } }Any other MCP client: add a remote server with the address above, Streamable HTTP, and no authentication.
What it can do
review_game
A Chess.com or Lichess game link, or a PGN. Returns the link to that game's review on Lumichess: accuracy for both players, every move classified, the evaluation graph. For a PGN it also gives the players, result and opening.
chess_profile
A Chess.com or Lichess username. Returns their current ratings and win, loss and draw record, with links to Insights and the Profile Report for that player.
fide_rating
A name or FIDE ID. Returns standard, rapid and blitz ratings, title, federation and birth year from the published FIDE list.
opening_guide
An opening name. Returns the first moves, ECO codes, how often it is played and how it scores in our database, and the main lines with the ideas behind them, from our opening pages.
identify_opening
A list of moves or a PGN. Returns the opening and variation with its ECO code, and the move where the game left named theory.
analyze_position
A FEN. Returns the side to move, check, checkmate or stalemate, material for both sides, every legal move, and links to the analysis board and the best move finder for that position.
daily_puzzle
Nothing. Returns today's daily puzzle: the position, rating, themes and solution, and a link to solve it on the board.
elo_change
Two ratings and an optional K-factor. Returns the expected score and what a win, draw or loss does to the rating.
Things to ask
"Review my last game: chess.com/game/live/..." · "What is Magnus Carlsen's FIDE rapid rating?" · "What opening is 1.e4 c6 2.d4 d5 3.e5 Bf5?" · "Explain the London System." · "Is this position checkmate?" with a FEN · "Give me today's puzzle, but not the answer." · "How much do I gain beating a player 200 points higher?"
Why the engine stays on the website
Every analysis on Lumichess runs Stockfish in your own browser, which is why reviews are free and unlimited. The server does not run an engine, so it never makes up an evaluation. It answers what can be answered without one and hands you the game review, analysis board or best move finder link for the rest.
Frequently asked questions
Do I need an account or an API key?
No. The server is public and free. Add the URL to your assistant and it works.
Does the server run Stockfish?
No. Engine analysis runs in your browser on lumichess.com, as it does for every visitor. The tools answer what can be answered without an engine (names, ratings, rules, material) and give you a link to the page where the engine runs.
Where do the ratings come from?
FIDE ratings come from the published FIDE rating list, through the Lichess FIDE directory. Chess.com and Lichess ratings come from their public APIs.
Is there a limit?
30 requests a minute from each address. An assistant uses one request per tool call, so normal use never reaches it.
What do you keep from my requests?
Nothing. The server answers and forgets: it does not store the games, names or positions you send.