Summary
Connects Claude to Lichess's public API for chess data and analysis. You get player profiles and ratings across all variants, bulk user lookups, online status checks, and leaderboards. The real power is in the game analysis tools: cloud eval hits Stockfish for position evaluation, tablebase does endgame lookups for positions with seven pieces or fewer, and opening explorer queries community games, master games, or individual player repertoires. Hosted by Pipeworx as a streamable HTTP gateway, so no local installation. Useful when you're building chess coaching tools, doing player research, or need programmatic access to opening theory and engine analysis without running your own infrastructure.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
set_tokenSet your Lichess API token1 params
Set your Lichess API token
Parameters* required
tokenstringYour Lichess API token
get_my_profileGet your Lichess profile information
Get your Lichess profile information
No parameter schema in public metadata yet.
get_user_profileGet a user's Lichess profile information2 params
Get a user's Lichess profile information
Parameters* required
trophiesbooleanInclude user trophiesdefault: false
usernamestringUsername of the player
get_my_emailGet your email address
Get your email address
No parameter schema in public metadata yet.
get_kid_modeGet kid mode status
Get kid mode status
No parameter schema in public metadata yet.
set_kid_modeSet kid mode status1 params
Set kid mode status
Parameters* required
valuebooleanEnable or disable kid mode
create_challengeCreate a new challenge3 params
Create a new challenge
Parameters* required
colorstringone of
white · black · randomdefault: randomtimeControlstringTime control (e.g. '10+0' for 10 minutes)default: 10+0
usernamestringUsername of the player to challenge
make_moveMake a move in an ongoing game3 params
Make a move in an ongoing game
Parameters* required
gameIdstringID of the game
movestringMove in UCI format (e.g. 'e2e4')
offeringDrawbooleanWhether to offer/accept a drawdefault: false
get_preferencesGet your preferences
Get your preferences
No parameter schema in public metadata yet.
get_timelineGet your timeline2 params
Get your timeline
Parameters* required
nbnumberMax number of events to fetch (1-30)default: 15
sincenumberShow events since this timestamp
test_tokensTest multiple OAuth tokens1 params
Test multiple OAuth tokens
Parameters* required
tokensstringOAuth tokens separated by commas. Up to 1000.
revoke_tokenRevoke the current access token
Revoke the current access token
No parameter schema in public metadata yet.
upgrade_to_botUpgrade to Bot account. WARNING: This is irreversible and the account must not have played any games.
Upgrade to Bot account. WARNING: This is irreversible and the account must not have played any games.
No parameter schema in public metadata yet.
add_user_noteAdd a private note about a user2 params
Add a private note about a user
Parameters* required
textstringThe contents of the note
usernamestringUsername of the player
send_messageSend a private message to another player2 params
Send a private message to another player
Parameters* required
textstringMessage text
usernamestringUsername of the recipient
get_followingGet users followed by the logged in user
Get users followed by the logged in user
No parameter schema in public metadata yet.
follow_userFollow a player1 params
Follow a player
Parameters* required
usernamestringUsername of the player to follow
unfollow_userUnfollow a player1 params
Unfollow a player
Parameters* required
usernamestringUsername of the player to unfollow
block_userBlock a player1 params
Block a player
Parameters* required
usernamestringUsername of the player to block
get_users_statusGet real-time users status4 params
Get real-time users status
Parameters* required
idsstringUser IDs separated by commas. Up to 100 IDs.
withGameIdsbooleanInclude IDs of ongoing games
withGameMetasbooleanInclude metadata of ongoing games
withSignalbooleanInclude network signal strength (1-4)
get_all_top_10Get the top 10 players for each speed and variant
Get the top 10 players for each speed and variant
No parameter schema in public metadata yet.
get_leaderboardGet the leaderboard for a single speed or variant2 params
Get the leaderboard for a single speed or variant
Parameters* required
nbnumberHow many users to fetch (1-200)default: 100
perfTypestringThe speed or variantone of
ultraBullet · bullet · blitz · rapid · classical · chess960get_user_public_dataGet public data of a user2 params
Get public data of a user
Parameters* required
usernamestringUsername of the player
withTrophiesbooleanInclude user trophiesdefault: false
get_rating_historyGet rating history of a user for all perf types1 params
Get rating history of a user for all perf types
Parameters* required
usernamestringUsername of the player
get_user_performanceGet performance statistics of a user2 params
Get performance statistics of a user
Parameters* required
perfstringThe speed or variantone of
ultraBullet · bullet · blitz · rapid · classical · correspondenceusernamestringUsername of the player
get_user_activityGet activity feed of a user1 params
Get activity feed of a user
Parameters* required
usernamestringUsername of the player
get_users_by_idGet multiple users by their IDs1 params
Get multiple users by their IDs
Parameters* required
idsstringUser IDs separated by commas. Up to 300 IDs.
unblock_userUnblock a user1 params
Unblock a user
Parameters* required
usernamestringUsername of the player to unblock
export_gameExport one game in PGN or JSON format9 params
Export one game in PGN or JSON format
Parameters* required
accuracybooleanInclude accuracy percentagesdefault: false
clocksbooleanInclude clock comments in the PGN movesdefault: true
evalsbooleanInclude analysis evaluation commentsdefault: true
gameIdstringThe game ID
literatebooleanInclude textual annotationsdefault: false
movesbooleanInclude the PGN movesdefault: true
openingbooleanInclude opening namedefault: true
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
tagsbooleanInclude the PGN tagsdefault: true
export_ongoing_gameExport ongoing game of a user7 params
Export ongoing game of a user
Parameters* required
clocksbooleanInclude clock comments in the PGN movesdefault: true
evalsbooleanInclude analysis evaluation commentsdefault: true
movesbooleanInclude the PGN movesdefault: true
openingbooleanInclude opening namedefault: true
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
tagsbooleanInclude the PGN tagsdefault: true
usernamestringThe username
export_user_gamesExport all games of a user20 params
Export all games of a user
Parameters* required
accuracybooleanInclude accuracydefault: false
analysedbooleanOnly games with or without computer analysis
clocksbooleanInclude clock commentsdefault: false
colorstringOnly games played as this colorone of
white · blackevalsbooleanInclude analysisdefault: false
finishedbooleanInclude finished gamesdefault: true
lastFenbooleanInclude last position FENdefault: false
literatebooleanInclude textual annotationsdefault: false
maxnumberMaximum number of games to download
movesbooleanInclude movesdefault: true
ongoingbooleanInclude ongoing gamesdefault: false
openingbooleanInclude openingdefault: false
perfTypestringOnly games in these speeds or variantsone of
ultraBullet · bullet · blitz · rapid · classical · correspondenceratedbooleanOnly rated (true) or casual (false) games
sincenumberDownload games played since timestamp
sortstringSort order of gamesone of
dateAsc · dateDescdefault: dateDesctagsbooleanInclude tagsdefault: true
untilnumberDownload games played until timestamp
usernamestringThe username
vsstringOnly games against this opponent
export_games_by_idsExport multiple games by IDs7 params
Export multiple games by IDs
Parameters* required
clocksbooleanInclude clock commentsdefault: false
evalsbooleanInclude analysisdefault: false
idsstringGame IDs separated by commas. Up to 300 IDs.
movesbooleanInclude the PGN movesdefault: true
openingbooleanInclude opening namedefault: false
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
tagsbooleanInclude the PGN tagsdefault: true
get_tv_channelsGet all TV channels and their current games
Get all TV channels and their current games
No parameter schema in public metadata yet.
get_tv_gameGet current TV game in PGN format1 params
Get current TV game in PGN format
Parameters* required
channelstringChannel name like 'bot', 'blitz', etc.one of
bot · blitz · racingKings · ultraBullet · bullet · classicalget_puzzle_activityGet your puzzle activity1 params
Get your puzzle activity
Parameters* required
maxnumberHow many entries to download. Leave empty to get all activity.
get_puzzle_dashboardGet your puzzle dashboard1 params
Get your puzzle dashboard
Parameters* required
daysnumberHow many days of history to return (max 30)default: 30
get_puzzle_raceGet info about a puzzle race1 params
Get info about a puzzle race
Parameters* required
raceIdstringID of the puzzle race
create_puzzle_raceCreate a puzzle race
Create a puzzle race
No parameter schema in public metadata yet.
get_puzzle_storm_dashboardGet your puzzle storm dashboard1 params
Get your puzzle storm dashboard
Parameters* required
daysnumberHow many days of history to return (max 30)default: 30
get_team_infoGet team information by ID1 params
Get team information by ID
Parameters* required
teamIdstringThe team ID
get_team_membersGet members of a team2 params
Get members of a team
Parameters* required
maxnumberMaximum number of members to fetchdefault: 100
teamIdstringThe team ID
get_team_join_requestsGet join requests for a team1 params
Get join requests for a team
Parameters* required
teamIdstringThe team ID
join_teamJoin a team2 params
Join a team
Parameters* required
messagestringOptional message for team leaders
teamIdstringThe team ID
leave_teamLeave a team1 params
Leave a team
Parameters* required
teamIdstringThe team ID
kick_user_from_teamKick a user from your team2 params
Kick a user from your team
Parameters* required
teamIdstringThe team ID
userIdstringThe user ID
accept_join_requestAccept a join request for your team2 params
Accept a join request for your team
Parameters* required
teamIdstringThe team ID
userIdstringThe user ID
decline_join_requestDecline a join request for your team2 params
Decline a join request for your team
Parameters* required
teamIdstringThe team ID
userIdstringThe user ID
search_teamsSearch for teams2 params
Search for teams
Parameters* required
pagenumberPage number (starting at 1)default: 1
textstringSearch text
make_board_moveMake a move in a board game3 params
Make a move in a board game
Parameters* required
gameIdstringThe game ID
movestringMove in UCI format (e.g. e2e4)
offeringDrawbooleanWhether to offer/accept a drawdefault: false
abort_board_gameAbort a board game1 params
Abort a board game
Parameters* required
gameIdstringThe game ID
resign_board_gameResign a board game1 params
Resign a board game
Parameters* required
gameIdstringThe game ID
write_in_chatWrite in the chat of a board game3 params
Write in the chat of a board game
Parameters* required
gameIdstringThe game ID
roomstringThe chat roomone of
player · spectatortextstringThe message to send
handle_draw_board_gameHandle draw offers for a board game2 params
Handle draw offers for a board game
Parameters* required
acceptbooleanWhether to accept or decline the draw offerdefault: true
gameIdstringThe game ID
claim_victoryClaim victory if opponent abandoned the game1 params
Claim victory if opponent abandoned the game
Parameters* required
gameIdstringThe game ID
list_challengesList incoming and outgoing challenges
List incoming and outgoing challenges
No parameter schema in public metadata yet.
accept_challengeAccept an incoming challenge1 params
Accept an incoming challenge
Parameters* required
challengeIdstringID of the challenge to accept
decline_challengeDecline an incoming challenge2 params
Decline an incoming challenge
Parameters* required
challengeIdstringID of the challenge to decline
reasonstringReason for decliningone of
generic · later · tooFast · tooSlow · timeControl · ratedcancel_challengeCancel an outgoing challenge1 params
Cancel an outgoing challenge
Parameters* required
challengeIdstringID of the challenge to cancel
get_arena_tournamentsGet current tournaments
Get current tournaments
No parameter schema in public metadata yet.
create_arenaCreate a new arena tournament14 params
Create a new arena tournament
Parameters* required
berserkablebooleanWhether players can use berserkdefault: true
clockIncrementnumberClock increment in secondsdefault: 2
clockTimenumberClock initial time in minutesdefault: 3
conditionsobjectRestrict participation
descriptionstringTournament description (HTML)
hasChatbooleanWhether players can discuss in a chatdefault: true
minutesnumberTournament duration in minutesdefault: 45
namestringName of the tournament
positionstringCustom initial position in FEN format
ratedbooleanWhether the tournament is rateddefault: true
startDatenumberTimestamp to start the tournament at a given date
streakablebooleanWhether players can get streaksdefault: true
variantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardwaitMinutesnumberTime before tournament starts, in minutesdefault: 5
get_arena_infoGet info about an arena tournament1 params
Get info about an arena tournament
Parameters* required
tournamentIdstringTournament ID
get_arena_gamesGet games of an arena tournament1 params
Get games of an arena tournament
Parameters* required
tournamentIdstringTournament ID
get_arena_resultsGet results of an arena tournament1 params
Get results of an arena tournament
Parameters* required
tournamentIdstringTournament ID
join_arenaJoin an arena tournament1 params
Join an arena tournament
Parameters* required
tournamentIdstringTournament ID
withdraw_from_arenaWithdraw from an arena tournament1 params
Withdraw from an arena tournament
Parameters* required
tournamentIdstringTournament ID
get_team_battle_resultsGet results of a team battle tournament1 params
Get results of a team battle tournament
Parameters* required
tournamentIdstringTournament ID
create_swissCreate a new Swiss tournament8 params
Create a new Swiss tournament
Parameters* required
clockobjectClock settings
descriptionstringTournament description (HTML)
namestringName of the tournament
nbRoundsnumberNumber of rounds to playdefault: 7
ratedbooleanWhether the tournament is rateddefault: true
roundIntervalnumberInterval between rounds in secondsdefault: 300
teamIdstringID of the team hosting the tournament
variantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardget_swiss_infoGet info about a Swiss tournament1 params
Get info about a Swiss tournament
Parameters* required
swissIdstringSwiss tournament ID
get_swiss_gamesGet games of a Swiss tournament1 params
Get games of a Swiss tournament
Parameters* required
swissIdstringSwiss tournament ID
get_swiss_resultsGet results of a Swiss tournament1 params
Get results of a Swiss tournament
Parameters* required
swissIdstringSwiss tournament ID
join_swissJoin a Swiss tournament1 params
Join a Swiss tournament
Parameters* required
swissIdstringSwiss tournament ID
withdraw_from_swissWithdraw from a Swiss tournament1 params
Withdraw from a Swiss tournament
Parameters* required
swissIdstringSwiss tournament ID
get_current_simulsGet recently started simuls
Get recently started simuls
No parameter schema in public metadata yet.
create_simulCreate a new simul8 params
Create a new simul
Parameters* required
clockIncrementnumberClock increment in secondsdefault: 3
clockTimenumberClock initial time in minutesdefault: 5
colorstringColor the host will playone of
white · blackdefault: whitemaxRatingnumberMaximum rating to join
minRatingnumberMinimum rating to join
namestringName of the simul
textstringDescription of the simul
variantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardjoin_simulJoin a simul1 params
Join a simul
Parameters* required
simulIdstringID of the simul
withdraw_from_simulWithdraw from a simul1 params
Withdraw from a simul
Parameters* required
simulIdstringID of the simul
export_study_chapterExport one study chapter in PGN format2 params
Export one study chapter in PGN format
Parameters* required
chapterIdstringChapter ID
studyIdstringStudy ID
export_all_study_chaptersExport all chapters of a study in PGN format1 params
Export all chapters of a study in PGN format
Parameters* required
studyIdstringStudy ID
get_user_studiesGet studies created by a user1 params
Get studies created by a user
Parameters* required
usernamestringUsername of the player
get_threadGet a message thread1 params
Get a message thread
Parameters* required
userIdstringUser ID of the other person
@pipeworx/lichess
Lichess.org public API MCP — player profiles, games, broadcasts, opening explorer, tablebase. Keyless.
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
user(username)— player profile + ratings across variantsusers(usernames[])— bulk lookup (up to 300)user_status(usernames[])— online / playing statususer_performance(username, perf)— single-variant performance + best rated gametop_players(perf, limit?)— top players for a variant (bullet/blitz/rapid/classical/etc.)leaderboards()— top 10 across all variantstv_channels()— currently-featured TV games per variantcloud_eval(fen, multi_pv?)— engine cloud eval for a FEN positiontablebase(fen, variant?)— Syzygy tablebase result (≤7 pieces)opening_explorer(scope, fen|play, ...)— Lichess / masters / player opening DB
Data source
https://lichess.org/api, https://explorer.lichess.ovh, https://tablebase.lichess.ovh.
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"lichess": {
"url": "https://gateway.pipeworx.io/lichess/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/lichess/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Lichess data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →