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.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Lichess

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/lichess
Every site

One MCP server for Lichess and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

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

Read 4
  • exportGameExports one Lichess game by id or URL: players, ratings, result, opening, SAN moves and PGN.

    Arguments

    NameTypeRequired
    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/exportGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/getUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lichess.getUser({ username: "DrNykterstein" });
  • searchPlayersFinds Lichess players whose username starts with a typed name, the way in to getUser.

    Arguments

    NameTypeRequired
    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/searchPlayers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lichess.searchPlayers({ query: "magnus" });
  • topPlayersReads the Lichess leaderboard for one time control or variant, highest rated first.

    Arguments

    NameTypeRequired
    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/topPlayers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.lichess.topPlayers({ perf: "blitz", limit: 3 });

Use it from code