get_reading_stats
Retrieve reading statistics—total books read and average rating—for all-time or filtered from a specified date. Provide a numeric user ID to get personalized results.
Instructions
Get reading statistics: total books read all-time AND since an optional date (e.g. '2026-01-01' for this year, '2026-08-01' for this month), plus average rating for each window. Requires the user's numeric ID (use get_me to find it).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"user_id": "<user_id>"
},
"name": "get_reading_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | Optional YYYY-MM-DD start date to filter the 'filtered' count (e.g. 2026-01-01) | |
| user_id | Yes | Hardcover numeric user ID |