Get similar books
get_similar_booksList the books in the ShelfClub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book, chosen from its 10,000 most-read books. The tags are machine-generated, or voted for by at least three readers of the book, and a book that has none has no similar books. Returns up to 10 books, each with its ShelfClub id, authors, description, reader rating, series, tags and shelfclub.app link.
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": {
"id": "<id>"
},
"name": "get_similar_books"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ShelfClub id of the book, as the other tools return it. | |
| limit | No | How many books to return. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| books | No | ||
| status | Yes | "try_again_later": the service was busy and looked nothing up, so the other fields are absent. | |
| tagProvenance | No | Where the moods, vibes, pace and genres come from. | |
| retryAfterSeconds | No | With "try_again_later", when known: how long to wait. |