AI assistants (MCP)
Club Ladder has an MCP server, so an AI assistant can read public ladders, convert ratings between Lichess and chess.com, find clubs at a level, and give an organizer a link that starts a ladder for their own club. It only reads. It never creates or changes a ladder, and it never returns a private or link-only ladder.
- Server address
https://chessclubladder.com/api/mcp- Sign-in
- None. Leave authentication off.
- Transport
- Streamable HTTP, protocol versions up to 2025-11-25.
Set it up
Claude (claude.ai and the desktop app)
- Open Settings, then Connectors, and press Add custom connector.
- Name it Club Ladder and paste
https://chessclubladder.com/api/mcpas the URL. Leave the sign-in fields empty. - In a chat, turn Club Ladder on from the tools menu and ask a question from the list below.
Claude Code
claude mcp add --transport http club-ladder https://chessclubladder.com/api/mcp
ChatGPT (developer mode)
- Open Settings, then Apps, then Advanced settings, and turn on developer mode.
- Create an app. Name it Club Ladder, paste
https://chessclubladder.com/api/mcpas the server URL and choose no authentication. - In a chat, pick Club Ladder from the tools menu.
Cursor
Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:
{ "mcpServers": { "club-ladder": { "url": "https://chessclubladder.com/api/mcp" } } }
VS Code
Add this to .vscode/mcp.json in your workspace, then start the server from the file:
{ "servers": { "club-ladder": { "type": "http", "url": "https://chessclubladder.com/api/mcp" } } }
Other clients
Any client that speaks streamable HTTP connects with the address above and no sign-in. The server card is at /.well-known/mcp/server-card.json.
Tools
Every answer has a short summary with links and dates, and the same data as JSON.
start_club_ladder: Start a ladder for a club
Use when someone wants a rating ladder for their own chess club, class or group. Give the club's Lichess team or chess.com club as a link, an id or a name. Returns the club as found, a Start page link with that club filled in, what the free plan and the Club pass include, and the Discord app link when the club uses Discord. The organizer creates the ladder in the browser from that link; this tool creates nothing.
club(text, required): A Lichess team link (lichess.org/team/...), a chess.com club link (chess.com/club/...), a team id or club slug, or the club's name.site(lichess,chesscom): Which site the club is on. Needed only when club is a bare id; narrows a name search.uses_discord(true or false): True when the club has a Discord server, false when it has none. Leave out when not known.
Ask: "We run a chess club on Lichess at lichess.org/team/maple-street-chess-club. Set up a ladder for us."
list_public_ladders: List public ladders
Public ladders on Club Ladder: ladders whose organizers made them public, with name, id, player count and link. Use to find a club's ladder by name before reading its standings. Private ladders and ladders shared only by link are never listed.
name(text): Words from the ladder's name or description. Leave out to list them all.
Ask: "Which public chess club ladders can I look at?"
get_public_ladder: Get a public ladder
Standings of one public ladder, by id or ladder link: each named player's Lichess and chess.com rating, change and games in one time control, sorted as on the ladder page, plus this week's awards and recent results. Comes in pages; use offset for the next page. Private and link-only ladders are never returned.
id(text, required): The ladder id, the part after /l/ in its link (for example demo-club), or the whole link.period(7,30,season): Days to measure change over: 7 (default) or 30, or season for a ladder with seasons.time_control(bullet,blitz,rapid,classical,daily): Time control to rank by. Default: the one most of the club plays.limit(whole number, 1 to 20): Players per page. Default 20.offset(whole number, 0 to 2000): Players to skip, for the next page. Default 0.results_limit(whole number, 0 to 10): How many recent weekly awards and challenge results to include. Default 5.
Ask: "Who is leading The Candidates ladder this month?"
estimate_rating: Convert a Lichess or chess.com rating
Converts one rating between Lichess and chess.com for a time control, from people who play on both sites. Give lichess or chesscom (exactly one) and time_control. Returns the estimate on the other site and the range most people with that rating fall in.
time_control(blitz,rapid,bullet,daily, required): Time control. Each site and time control is its own rating pool.lichess(whole number, 400 to 3400): A Lichess rating to convert to chess.com.chesscom(whole number, 100 to 3500): A chess.com rating to convert to Lichess.
Ask: "I'm 1500 in blitz on Lichess. What is that on chess.com?"
rating_percentile: Where a rating sits
Where one Lichess or chess.com rating sits among the club players, team members and people on both sites whose settled ratings Club Ladder reads: the share below it and the percentiles of that pool. Give lichess or chesscom (exactly one) and time_control. Use for questions like whether a rating is good.
time_control(blitz,rapid,bullet,daily, required): Time control. Each site and time control is its own rating pool.lichess(whole number, 400 to 3400): A Lichess rating.chesscom(whole number, 100 to 3500): A chess.com rating.
Ask: "Is 1400 rapid on chess.com a good rating?"
find_lichess_clubs: Find Lichess clubs at a rating
Up to ten Lichess clubs (teams) where the given rating sits in the middle half of the members' blitz or rapid ratings, largest first, with member counts, medians, how many members were active in the last month, and a Start link for each. Use when a player wants a club at their level.
rating(whole number, 400 to 3200, required): A Lichess blitz or rapid rating.open_to_join(true or false): True for clubs anyone can join without approval. Default false.
Ask: "Find active Lichess clubs to join at a 1400 rapid rating."
Heavier use
An assistant answering a person's questions needs nothing more. Automated or programmatic use beyond the free trial needs a Pro key, which is the Club pass. Send it as a header:
Authorization: Bearer YOUR-LICENSE-KEY
When the free trial runs out, the answer says so and says what to do.
Privacy
We receive the tool name and what the assistant sends with it, such as a ladder id, a rating or a club's link. We do not receive your conversation, your name or your account with the assistant. Players are named only where the ladder page names them, and never by email. Details: Privacy, AI assistants.
Support
Write to hello@chessclubladder.com.