List a book's editions
list_book_editionsLists the known editions of a book in the reader's ReadingRate library (publisher, year, pages, ISBN, language and translators, cover) and says which edition the reader's current reading is in. Each reading of a book can be in its own edition: a re-read in another translation has its own pages, cover and translator, and earlier readings keep theirs. Use when the reader says which edition, translation or printing they are reading, starts a re-read in another one, or asks which editions ReadingRate knows. Then ask them to pick one and call update_book_edition with its edition_id; if theirs is not listed, ask for the ISBN printed on the back or the copyright page (or a photo of the barcode, whose digits you read) and call update_book_edition with isbn. To start a re-read first, use update_book_status with status "reading". Examples:
{"book_id": ""}
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": {
"book_id": "<book_id>"
},
"name": "list_book_editions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book_id | Yes | The book's ReadingRate id or slug, or its library entry id |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | Yes | The book: id, slug, title | |
| editions | Yes | The known editions: edition_id, publisher, year, pages, isbn_13, format, language, translators, cover_url, current | |
| translations | No | The book's known translations: translation_id, language, translators, original (true for the original language); pass translation_id to update_book_edition with an ISBN | |
| current_reading | No | The reading the edition applies to: reading_id, reading_number (2 for a first re-read), status, edition_id (null when none is named) |