# Lumichess

> Lumichess is a free MCP server for games and play. Chess tools for assistants: game review links, FIDE ratings, openings and puzzles. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://lumichess.com/developers/mcp
- **MCP Registry name:** com.lumichess/chess
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lumichess.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chess": {
      "url": "https://lumichess.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/lumichess
