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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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: randomusernamestringUsername of the player to challenge
timeControlstringTime control (e.g. '10+0' for 10 minutes)default: 10+0
make_moveMake a move in an ongoing game3 params
Make a move in an ongoing game
Parameters* required
movestringMove in UCI format (e.g. 'e2e4')
gameIdstringID of the game
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.
withSignalbooleanInclude network signal strength (1-4)
withGameIdsbooleanInclude IDs of ongoing games
withGameMetasbooleanInclude metadata of ongoing games
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
tagsbooleanInclude the PGN tagsdefault: true
evalsbooleanInclude analysis evaluation commentsdefault: true
movesbooleanInclude the PGN movesdefault: true
clocksbooleanInclude clock comments in the PGN movesdefault: true
gameIdstringThe game ID
openingbooleanInclude opening namedefault: true
accuracybooleanInclude accuracy percentagesdefault: false
literatebooleanInclude textual annotationsdefault: false
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
export_ongoing_gameExport ongoing game of a user7 params
Export ongoing game of a user
Parameters* required
tagsbooleanInclude the PGN tagsdefault: true
evalsbooleanInclude analysis evaluation commentsdefault: true
movesbooleanInclude the PGN movesdefault: true
clocksbooleanInclude clock comments in the PGN movesdefault: true
openingbooleanInclude opening namedefault: true
usernamestringThe username
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
export_user_gamesExport all games of a user20 params
Export all games of a user
Parameters* required
vsstringOnly games against this opponent
maxnumberMaximum number of games to download
sortstringSort order of gamesone of
dateAsc · dateDescdefault: dateDesctagsbooleanInclude tagsdefault: true
colorstringOnly games played as this colorone of
white · blackevalsbooleanInclude analysisdefault: false
movesbooleanInclude movesdefault: true
ratedbooleanOnly rated (true) or casual (false) games
sincenumberDownload games played since timestamp
untilnumberDownload games played until timestamp
clocksbooleanInclude clock commentsdefault: false
lastFenbooleanInclude last position FENdefault: false
ongoingbooleanInclude ongoing gamesdefault: false
openingbooleanInclude openingdefault: false
accuracybooleanInclude accuracydefault: false
analysedbooleanOnly games with or without computer analysis
finishedbooleanInclude finished gamesdefault: true
literatebooleanInclude textual annotationsdefault: false
perfTypestringOnly games in these speeds or variantsone of
ultraBullet · bullet · blitz · rapid · classical · correspondenceusernamestringThe username
export_games_by_idsExport multiple games by IDs7 params
Export multiple games by IDs
Parameters* required
idsstringGame IDs separated by commas. Up to 300 IDs.
tagsbooleanInclude the PGN tagsdefault: true
evalsbooleanInclude analysisdefault: false
movesbooleanInclude the PGN movesdefault: true
clocksbooleanInclude clock commentsdefault: false
openingbooleanInclude opening namedefault: false
pgnInJsonbooleanInclude the full PGN within the JSON responsedefault: false
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
teamIdstringThe team ID
messagestringOptional message for team leaders
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
movestringMove in UCI format (e.g. e2e4)
gameIdstringThe game ID
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
roomstringThe chat roomone of
player · spectatortextstringThe message to send
gameIdstringThe game ID
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
reasonstringReason for decliningone of
generic · later · tooFast · tooSlow · timeControl · ratedchallengeIdstringID of the challenge to decline
cancel_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
namestringName of the tournament
ratedbooleanWhether the tournament is rateddefault: true
hasChatbooleanWhether players can discuss in a chatdefault: true
minutesnumberTournament duration in minutesdefault: 45
variantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardpositionstringCustom initial position in FEN format
clockTimenumberClock initial time in minutesdefault: 3
startDatenumberTimestamp to start the tournament at a given date
conditionsobjectRestrict participation
streakablebooleanWhether players can get streaksdefault: true
berserkablebooleanWhether players can use berserkdefault: true
descriptionstringTournament description (HTML)
waitMinutesnumberTime before tournament starts, in minutesdefault: 5
clockIncrementnumberClock increment in secondsdefault: 2
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
namestringName of the tournament
clockobjectClock settings
ratedbooleanWhether the tournament is rateddefault: true
teamIdstringID of the team hosting the tournament
variantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardnbRoundsnumberNumber of rounds to playdefault: 7
descriptionstringTournament description (HTML)
roundIntervalnumberInterval between rounds in secondsdefault: 300
get_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
namestringName of the simul
textstringDescription of the simul
colorstringColor the host will playone of
white · blackdefault: whitevariantstringVariant keyone of
standard · chess960 · crazyhouse · antichess · atomic · hordedefault: standardclockTimenumberClock initial time in minutesdefault: 5
maxRatingnumberMaximum rating to join
minRatingnumberMinimum rating to join
clockIncrementnumberClock increment in secondsdefault: 3
join_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
studyIdstringStudy ID
chapterIdstringChapter 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
mcp-lichess
Lichess MCP — public read-only API for users, games, explorer, tablebase.
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
user | Player profile with ratings across all variants. |
users | Bulk lookup of up to 300 users by username. |
user_status | Online / playing status for the given usernames (up to 100). |
user_performance | Single-variant performance + best rated game for a user. |
top_players | Top-rated players for one variant. |
leaderboards | Top-10 across all variants in one call. |
tv_channels | Currently-featured TV games per variant. |
cloud_eval | Stockfish cloud evaluation for a FEN position. |
tablebase | Syzygy tablebase lookup (≤7 pieces). Variant: standard (default), atomic, antichess. |
opening_explorer | Opening explorer. scope: "lichess" (community), "masters" (top 2200+ humans), "player" (single user). |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"lichess": {
"url": "https://gateway.pipeworx.io/lichess/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Lichess data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →