io.github.mrfentmen/lichess-mcp

Official

by mrfentmen · TypeScript

Use this MCP server to Lichess, chess puzzles by rating, player stats, and top players. Tools...

This MCP server provides access to Lichess data, including chess puzzles by rating, player stats, and top players. The server exposes tools (tooling) intended to support these Lichess-oriented queries within the Model Context Protocol.

🛠️ Key Features

Lichess integration
Chess puzzles filtered by rating
Player statistics
Top players
Tool-based interface

🚀 Use Cases

Retrieve Lichess puzzles for a specific rating range
Fetch player stats for analysis or display
View top players from Lichess

⚡ Developer Benefits

Structured tool access for Lichess-related data
Supports developer workflows needing puzzles, stats, and rankings

⚠️ Limitations

Available details are limited to the server description; specific tool names, parameters, and behaviors are not provided.

README.md1 KBView on GitHub

lichess mcp

MCP server for Lichess, free chess, puzzles, and the best public chess API.

Tools

Tool	What it does
`get_daily_puzzle`	Today's puzzle (FEN + solution)
`get_puzzle`	Puzzle by id
`get_player`	Player stats, best rating, games played, account age
`get_top_players`	Top players by performance (blitz, bullet, rapid, puzzle…)

Usage

bash

npm run build && node dist/index.js

Example:

code

get_daily_puzzle {}
get_player { username: "DrNykterstein" }   # Magnus, blitz 3153, 10,450 games
get_top_players { perf: "blitz", limit: 10 }

Keyless. Throttled to ~1 req/s to stay polite to the server. Closed/disabled accounts (e.g. hikaru) degrade gracefully.

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "lichess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/lichess-mcp@1.0.0"
      ]
    }
  }
}