Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Lichess Community (BYOK) — connector documentation

  • MCP endpoint: https://byok-lichess-community.connectorbay.com/mcp
  • REST API: POST https://byok-lichess-community.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-lichess-community.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Lichess Community personal API token (no scopes are needed for these read tools), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-lichess-community.connectorbay.com/health · Tool schemas: https://byok-lichess-community.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-lichess-community · agent@connectorbay.com

What Lichess Community (BYOK) is for

Lichess Community (BYOK) lets an AI assistant read your own Lichess Community data through the Lichess Community API with a key you supply (personal API token (no scopes are needed for these read tools)). Read-only: 12 tools (get_top_leaderboards, get_tv_channels, list_current_tournaments, get_arena_tournament, list_simuls, list_top_broadcasts, get_fide_player, search_fide_players, get_puzzle, list_live_streamers, autocomplete_usernames, get_crosstable). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to lichess.org. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Lichess Community. Lichess Community and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Who are the top 10 blitz players on Lichess?"
  • "What is the featured blitz game on Lichess TV right now?"
  • "Which arena tournaments are starting soon on Lichess?"
  • "Show details of Lichess arena tournament abcd1234"
  • "Which chess simuls are running on Lichess?"
  • "Which chess broadcasts are live on Lichess?"

What it does

  • get_top_leaderboards: Get the top 10 players for each speed and variant (bullet, blitz, rapid, classical, chess960 and others) with title, patron and online flags and ratings.
  • get_tv_channels: Get the best game being played right now for each speed and variant (including computer and bot games): player, rating, game id and the colour shown.
  • list_current_tournaments: List recently created, started and finished Lichess arena tournaments with variant, time control, player count and start and finish times (epoch milliseconds).
  • get_arena_tournament: Get one arena tournament by id: name, time control, rated flag, schedule, number of players, creator, state and entry conditions (player standings are left out).
  • list_simuls: List current simultaneous exhibitions (simuls): pending, created, started and finished ones with host, variants and applicant counts.
  • list_top_broadcasts: List top live and upcoming broadcasts of over-the-board events as shown on lichess.org/broadcast: tournament, round, start times and links.
  • get_fide_player: Get a FIDE player by FIDE id: name, title, federation, birth year, standard, rapid and blitz ratings and inactive flag.
  • search_fide_players: Search FIDE players by name: FIDE id, name, title, federation and standard, rapid and blitz ratings.
  • get_puzzle: Get a Lichess puzzle by id: rating, play count, themes, start position (FEN), last move and solution moves, plus the source game id and players.
  • list_live_streamers: List Lichess users who are streaming right now: name, title, platform (Twitch or YouTube), stream status and language.
  • autocomplete_usernames: Find Lichess usernames that start with the typed text (for example to fix a spelling), returning id, name, title and online flag.
  • get_crosstable: Get the total number of games and the current score between two Lichess users.

BYOK key

You bring your own Lichess Community personal API token (no scopes are needed for these read tools) (https://lichess.org/account/oauth/token). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to lichess.org over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Lichess Community API (lichess.org) with a BYOK key; documentation: https://lichess.org/api. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Lichess Community. Lichess Community and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Lichess Community account.

Built for: Worldwide. Languages: English.