Skip to content
MCP server

Lumichess

Chess tools for assistants: game review links, FIDE ratings, openings and puzzles

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Lumichess

Lumichess is a free MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.

Lumichess keeps engine work off the server on purpose. Every analysis on the site runs Stockfish in the visitor's own browser, so the MCP server answers only what needs no engine, such as names, ratings, rules and material, and returns a link to the page where the engine runs. It therefore never invents an evaluation.

Eight tools are listed. review_game takes a Chess.com or Lichess link or a PGN and returns a link to the review with accuracy, move classification and an evaluation graph. chess_profile returns a player's ratings and win-loss-draw record, fide_rating reads the published FIDE list, and opening_guide and identify_opening cover names, ECO codes and the move where a game leaves theory. analyze_position takes a FEN and reports check, mate, stalemate, material and every legal move, daily_puzzle returns the day's puzzle with its solution, and elo_change computes expected score for a K-factor.

The server is public with no key and limits each address to 30 requests a minute. It states that it stores none of the games, names or positions sent to it.

Install

Run in a terminal

claude mcp add --transport http chess https://lumichess.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://lumichess.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chess": {
      "url": "https://lumichess.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "chess": {
      "type": "http",
      "url": "https://lumichess.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "chess": {
      "serverUrl": "https://lumichess.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "chess": {
      "type": "http",
      "url": "https://lumichess.com/api/mcp"
    }
  }
}

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

review_game
Returns a link to a game review from a Chess.com or Lichess link or a PGN.
chess_profile
Returns ratings and record for a Chess.com or Lichess username.
fide_rating
Returns FIDE ratings, title and federation for a name or ID.
opening_guide
Returns first moves, ECO codes and main lines for an opening.
identify_opening
Names the opening and variation in a move list or PGN.
analyze_position
Returns facts about a FEN position, including legal moves.
daily_puzzle
Returns today's puzzle and solution.
elo_change
Returns expected score and rating change for given ratings.

What it does

Game review links
review_game points to a Lumichess review with accuracy for both players and every move classified.
Player profiles
chess_profile shows ratings and record for Chess.com and Lichess usernames.
FIDE lookup
fide_rating returns standard, rapid and blitz ratings, title and federation.
Opening tools
opening_guide and identify_opening return names, ECO codes and main lines.
Position facts
analyze_position lists legal moves, material and check or mate status from a FEN.
Daily puzzle
Returns today's puzzle with its themes and solution.
Elo calculator
elo_change gives the expected score and rating change for a win, draw or loss.

Good for

  • Ask for a review link after pasting a Chess.com game URL
  • Look up a grandmaster's FIDE rapid rating
  • Name the opening in a PGN and see where it left theory
  • Check whether a FEN is checkmate or stalemate
  • Work out how many points a win against a higher-rated player gains

Pricing

Free

Free, no account or key

Prices change. Check lumichess.com before you buy.

Lumichess FAQ

Do I need an account or key?

No. The server is public and free.

Does it run Stockfish?

No. Engine analysis runs in your browser on lumichess.com, and the tools link to it.

Where do ratings come from?

FIDE data comes from the published FIDE list through the Lichess FIDE directory; Chess.com and Lichess ratings come from their public APIs.

Is there a rate limit?

30 requests a minute per address.

Does it keep my games?

No. It answers and forgets, storing no games, names or positions.

Is Lumichess free?

Yes. Lumichess is free to use.

How do I add Lumichess to Claude Code?

Run this command in your terminal: claude mcp add --transport http chess https://lumichess.com/api/mcp

What are the best alternatives to Lumichess?

The closest alternatives to Lumichess are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

Alternatives to Lumichess

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory