List studies of a user
List the studies of a user with their IDs, names and update dates.
MCP tool lichess_read → list_studies
read
Returns each study's ID, name, creation date and last update, most recent first. For the signed-in account it includes private and unlisted studies; for another user only public ones. It reads only.
Parameters
| Name | Type | Description |
|---|---|---|
| username string | string | Lichess username. Defaults to the signed-in account, which also returns private and unlisted studies. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "lichess_read",
"arguments": {
"operation": "list_studies",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"studies": [
{
"study_id": "Wk3bPzQa",
"name": "Club Games 2026",
"created_at": "2026-01-09T18:00:00Z",
"updated_at": "2026-10-11T20:41:00Z"
},
{
"study_id": "Hn8eLr2c",
"name": "Opening Repertoire: London System",
"created_at": "2025-11-22T09:15:00Z",
"updated_at": "2026-09-02T07:30:00Z"
}
]
},
"isError": false
}