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

npm run build && node dist/index.js

Example:

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.

Quick start

npm install
npm run build
node dist/index.js

The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.

Tools at a glance

• get_daily_puzzle: Get today
• get_puzzle: Get a specific Lichess puzzle by id.
• get_player: Get a Lichess player
• get_top_players: Top players by performance (blitz, bullet, classical, puzzle, etc.).

Limits and privacy

This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required unless the project explicitly says otherwise.

Try it

After building, connect the server through your MCP client. The repository root also contains smoke-test.mjs for projects covered by the shared harness. A typical tool call starts with get_daily_puzzle.

Premium tools

These tools need a license key:

• live_tournaments
• team_info

Buy a key at https://mcp-marketplace.io/server/io-github-mrfentmen-lichess-mcp and set it in your MCP client config:

"env": { "MCP_LICENSE_KEY": "mcp_live_..." }

The key is checked against MCP Marketplace, cached for 24 hours, and keeps working offline once one check has succeeded. Every other tool on this server stays free.