Lichess MCP server for AI agents
Let Claude, ChatGPT or your own agent read Lichess: 4 typed functions through one MCP server. No Lichess API key needed.
- Site
- lichess.org
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Lichess alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/lichessOne MCP server for Lichess and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
exportGameExports one Lichess game by id or URL: players, ratings, result, opening, SAN moves and PGN.Arguments
Name Type Required idstringYes Returns
{ game: LichessGame | null }interface LichessGamePlayer { username: string | null; title: string | null; rating: number | null; ratingDiff: number | null; aiLevel: number | null } interface LichessGame { id: string; url: string; rated: boolean; variant: string; speed: string; status: string; winner: "white" | "black" | null; createdAt: string | null; lastMoveAt: string | null; white: LichessGamePlayer; black: LichessGamePlayer; opening: { eco: string; name: string } | null; moves: string; pgn: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/lichess/exportGameCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.lichess.exportGame({ id: "q7ZvsdUF" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.lichess.exportGame({"id": "q7ZvsdUF"}))curl -X POST https://api.bowmark.ai/v1/sites/lichess/exportGame \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"q7ZvsdUF"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.lichess.exportGame({ id: "q7ZvsdUF" });getUserReads a Lichess player's public profile: title, ratings per time control, win/loss/draw counts, join and last-seen dates.Arguments
Name Type Required usernamestringYes Returns
{ user: LichessUser | null }interface LichessRating { perf: string; rating: number; games: number; provisional: boolean } interface LichessUser { id: string; username: string; title: string | null; url: string; createdAt: string | null; seenAt: string | null; disabled: boolean; bio: string | null; country: string | null; ratings: LichessRating[]; games: { all: number; rated: number; win: number; loss: number; draw: number } | null; playTimeSeconds: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/lichess/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.lichess.getUser({ username: "DrNykterstein" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.lichess.getUser({"username": "DrNykterstein"}))curl -X POST https://api.bowmark.ai/v1/sites/lichess/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"DrNykterstein"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.lichess.getUser({ username: "DrNykterstein" });searchPlayersFinds Lichess players whose username starts with a typed name, the way in to getUser.Arguments
Name Type Required querystringYes Returns
{ players: LichessPlayerMatch[] }interface LichessPlayerMatch { id: string; username: string; title: string | null; online: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/lichess/searchPlayersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.lichess.searchPlayers({ query: "magnus" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.lichess.searchPlayers({"query": "magnus"}))curl -X POST https://api.bowmark.ai/v1/sites/lichess/searchPlayers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"magnus"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.lichess.searchPlayers({ query: "magnus" });topPlayersReads the Lichess leaderboard for one time control or variant, highest rated first.Arguments
Name Type Required perf"ultraBullet" | "bullet" | "blitz" | "rapid" | "classical" | "chess960" | "crazyhouse" | "antichess" | "atomic" | "horde" | "kingOfTheHill" | "racingKings" | "threeCheck"No limitnumberNo Returns
{ perf: string; players: LichessTopPlayer[] }interface LichessTopPlayer { id: string; username: string; title: string | null; rating: number; progress: number | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/lichess/topPlayersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.lichess.topPlayers({ perf: "blitz", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.lichess.topPlayers({"perf": "blitz", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/lichess/topPlayers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"perf":"blitz","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.lichess.topPlayers({ perf: "blitz", limit: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/lichess/<function> - OpenAPI
/v1/sites/lichess/openapi.json