mcp-lichess

Lichess MCP — public read-only API for users, games, explorer, tablebase.

Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.

Tools

Tool	Description
`user`	Player profile with ratings across all variants.
`users`	Bulk lookup of up to 300 users by username.
`user_status`	Online / playing status for the given usernames (up to 100).
`user_performance`	Single-variant performance + best rated game for a user.
`top_players`	Top-rated players for one variant.
`leaderboards`	Top-10 across all variants in one call.
`tv_channels`	Currently-featured TV games per variant.
`cloud_eval`	Stockfish cloud evaluation for a FEN position.
`tablebase`	Syzygy tablebase lookup (≤7 pieces). Variant: standard (default), atomic, antichess.
`opening_explorer`	Opening explorer. scope: "lichess" (community), "masters" (top 2200+ humans), "player" (single user).

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "lichess": {
      "url": "https://gateway.pipeworx.io/lichess/mcp"
    }
  }
}

Or connect to the full Pipeworx gateway for access to all 673+ data sources:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Instead of calling tools directly, you can ask questions in plain English:

ask_pipeworx({ question: "your question about Lichess data" })

The gateway picks the right tool and fills the arguments automatically.

MIT