Search / com.siftivo/siftivo
siftivo
R0· no sign-inBook recommendations from your reading history, plus your shelves, ratings and series order.
v0.2.0 · active · repository · website · descriptor JSON · versions
Search / com.siftivo/siftivo
R0· no sign-inBook recommendations from your reading history, plus your shelves, ratings and series order.
v0.2.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"siftivo": {
"type": "http",
"url": "https://api.siftivo.com/mcp"
}
}
}claude mcp add --transport http siftivo https://api.siftivo.com/mcp[mcp_servers.siftivo]
url = "https://api.siftivo.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"siftivo": {
"type": "remote",
"url": "https://api.siftivo.com/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"siftivo": {
"type": "http",
"url": "https://api.siftivo.com/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=siftivo&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnNpZnRpdm8uY29tL21jcCJ9"
}{
"servers": {
"siftivo": {
"type": "http",
"url": "https://api.siftivo.com/mcp"
}
}
}{
"mcpServers": {
"siftivo": {
"httpUrl": "https://api.siftivo.com/mcp"
}
}
}extensions:
"siftivo":
enabled: true
name: "siftivo"
type: streamable_http
uri: "https://api.siftivo.com/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations13 of 13 tools declare readOnlyHint or destructiveHinttools.directory_hints2 of 13 tools declare all four hints; missing: what_to_read_next (idempotentHint); get_author (idempotentHint); get_series (idempotentHint); …tools.token_costabout 2,654 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes22 tool changes in 30 daysstability.rug_pull7 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageget_my_tastechangeddescription, input schemameaning changedWhat is shaping the signed-in reader's Siftivo recommendations. Each entry is a book, author, series, reader, genre, topic or vibe, whether it pulls recommendations toward it or away from it, and why it counts: reading it now, finished it on a date, rated it, pinned it as a favorite, follows them, left that genre out. Entries the reader has switched off are listed by name under muted, and discovery style is how far from their usual taste they like to range, per fiction and nonfiction. It is the same profile the app's own recommendations are built from.
The signed-in reader's taste: the books, authors, series, genres and moods they love, what they avoid or quit, why each one counts, and how far from their usual taste they like to range. A recommendation for this reader rests on it, so it suits "what should I read next", "recommend me a book", "something I would like" and "what kind of books do I like" when no book or mood is named. The strongest 40 entries come back by default, and limit raises that. Needs a linked Siftivo account. It is the same profile the app's own recommendations use.
remove_from_librarychangeddescriptionTake a book off the signed-in reader's shelves entirely, discarding its shelf, progress and notes. The reader's rating for the book stays. This is removal rather than a shelf change: add_to_library with a new readingStatus moves a book between shelves instead.
Take a book off the signed-in reader's shelves entirely, discarding its shelf, progress and notes. The reader's rating for the book stays. Suits "take X off my shelves" and "remove X from my list". Moving a book between shelves is add_to_library with a new readingStatus. Needs a linked Siftivo account.
get_my_bookchangeddescription, input schemameaning changedWhether the signed-in reader has this book on a shelf, and if so which shelf, their rating and how far through they are. Answers "have I read this?" without pulling the whole library.
Which of up to 25 books the signed-in reader already has on a shelf, and for each one the shelf, their rating and their progress. Takes titles ("Title by Author" resolves best) or workIds. Suits "have I read X", "which of these have I read" and checking a list of book suggestions against what the reader has already read. Titles not in the catalog come back under unmatched. Needs a linked Siftivo account.
add_to_librarychangeddescriptionPut a book on one of the signed-in reader's shelves, move it to a different shelf, rate it, or record how far through it they are. The workId is one returned by search_books, get_book or recommend_from_titles. "Finished it, four and a half stars" is one call with readingStatus FINISHED and rating 4.5. Each field given replaces what the reader had there before, so send a rating or a note only when they asked for that one to change. Omitting readingStatus leaves the book on the shelf it is already on.
Log reading on the signed-in reader's Siftivo shelves: add a book to want to read (NOT_STARTED), mark it READING, FINISHED or DNF, rate it, or record progress. Suits "add X to my list", "I just finished X, four stars" and "I'm halfway through X". "Finished it, four and a half stars" is one call with readingStatus FINISHED and rating 4.5. The workId comes from search_books. Each field given replaces what the reader had there before, so send a rating or a note only when they asked for that one to change. Omitting readingStatus leaves the book on the shelf it is already on. Needs a linked Siftivo account.
get_my_librarychangeddescriptionmeaning changedThe signed-in reader's own Siftivo library: what they want to read, are reading, finished, or set down, with their ratings.
The signed-in reader's Siftivo shelves: what they want to read, are reading, finished or did not finish, with their ratings, progress and private notes. Suits "what am I reading", "what is on my to-read list" and "what have I finished". Filter to one shelf with status. Needs a linked Siftivo account.
recommend_from_titleschangeddescriptionGive Siftivo a few books someone liked, by title, and get books like them. Titles are resolved against the catalog first; anything that does not resolve is reported back rather than guessed at. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why.
Book recommendations from books the reader already loved, named by title: "books like Project Hail Mary", "I loved Circe and Piranesi, what else would I like", a book club that enjoyed one pick. Titles are resolved against the catalog first, and any that do not resolve are reported back rather than guessed at. Other books by the same authors are left out. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why.
recommend_from_descriptionchangeddescriptionDescribe what someone is in the mood for, in their own words, and get books that match. It suits a theme, subject or feeling ("books about grief", "cozy mysteries set in Cornwall"), and matches on meaning rather than on a title or an author name. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why.
Book recommendations from a mood, theme or subject in the reader's own words: "cozy fantasy with found family", "a good book about grief", "something light for the beach". Matches on meaning rather than on a title or an author name. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why.
get_reading_indexchangeddescriptionThe weekly Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation this week, ranked.
The weekly Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation this week, ranked, with weeks on the chart and new entries. Suits "what books are popular right now", "what is everyone reading" and "what are the big books this week".
get_serieschangeddescription, input schemameaning changedA series and its works in reading order. Accepts a series id or slug.
A book series in reading order: every book with its position and publication year, and whether the series is complete. Suits "what order do the X books go in", "what is book 3 of X" and "is the next X book out". Takes the series name, or a series id from get_book or what_to_read_next.
get_authorchangeddescription, input schemameaning changedAn author, their biography, and the works Siftivo holds for them. Accepts an author id or slug.
An author's biography and the books Siftivo holds for them, with years. Suits "what else has X written" and "tell me about X". Takes the author's name, an author id, or a siftivo.com slug.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +dns-namespace +website +reachable +uptime-100% +updated-5d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://api.siftivo.com/mcp streamable-http | none | yes | 100% | 237 ms | 2025-11-25 | 2026-10-20 |
add_to_librarydestructive | Log reading on the signed-in reader's Siftivo shelves: add a book to want to read (NOT_STARTED), mark it READING, FINISHED or DNF, rate it, or record progress. Suits "add X to my list", "I just finished X, four stars" and "I'm halfway through X". "Finished it, four and a half stars" is one call with readingStatus FINISHED and rating 4.5. The workId comes from search_books. Each field given replaces what the reader had there before, so send a rating or a note only when they asked for that one to change. Omitting readingStatus leaves the book on the shelf it is already on. Needs a linked Siftivo account. |
get_authorread-only | An author's biography and the books Siftivo holds for them, with years. Suits "what else has X written" and "tell me about X". Takes the author's name, an author id, or a siftivo.com slug. |
get_bookread-only | What one book is about: synopsis, authors, year, series and position, genres, and its siftivo.com page. Suits "what is X about" and "is X part of a series". For a reader who has linked their Siftivo account it also suits "would I like X": when the book fits their taste, the result says why. Takes a workId from search_books, or a siftivo.com slug. |
get_my_bookread-only | Which of up to 25 books the signed-in reader already has on a shelf, and for each one the shelf, their rating and their progress. Takes titles ("Title by Author" resolves best) or workIds. Suits "have I read X", "which of these have I read" and checking a list of book suggestions against what the reader has already read. Titles not in the catalog come back under unmatched. Needs a linked Siftivo account. |
get_my_libraryread-only | The signed-in reader's Siftivo shelves: what they want to read, are reading, finished or did not finish, with their ratings, progress and private notes. Suits "what am I reading", "what is on my to-read list" and "what have I finished". Filter to one shelf with status. Needs a linked Siftivo account. |
get_my_tasteread-only | The signed-in reader's taste: the books, authors, series, genres and moods they love, what they avoid or quit, why each one counts, and how far from their usual taste they like to range. A recommendation for this reader rests on it, so it suits "what should I read next", "recommend me a book", "something I would like" and "what kind of books do I like" when no book or mood is named. The strongest 40 entries come back by default, and limit raises that. Needs a linked Siftivo account. It is the same profile the app's own recommendations use. |
get_reading_indexread-only | The weekly Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation this week, ranked, with weeks on the chart and new entries. Suits "what books are popular right now", "what is everyone reading" and "what are the big books this week". |
get_seriesread-only | A book series in reading order: every book with its position and publication year, and whether the series is complete. Suits "what order do the X books go in", "what is book 3 of X" and "is the next X book out". Takes the series name, or a series id from get_book or what_to_read_next. |
recommend_from_descriptionread-only | Book recommendations from a mood, theme or subject in the reader's own words: "cozy fantasy with found family", "a good book about grief", "something light for the beach". Matches on meaning rather than on a title or an author name. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why. |
recommend_from_titlesread-only | Book recommendations from books the reader already loved, named by title: "books like Project Hail Mary", "I loved Circe and Piranesi, what else would I like", a book club that enjoyed one pick. Titles are resolved against the catalog first, and any that do not resolve are reported back rather than guessed at. Other books by the same authors are left out. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why. |
remove_from_librarydestructive | Take a book off the signed-in reader's shelves entirely, discarding its shelf, progress and notes. The reader's rating for the book stays. Suits "take X off my shelves" and "remove X from my list". Moving a book between shelves is add_to_library with a new readingStatus. Needs a linked Siftivo account. |
search_booksread-only | Find a book in the Siftivo catalog by its title or author, or by words from what it is about, and get the workId the other Siftivo tools take. Suits a named book ("add Circe to my list", "what is Babel about", "is Demon Copperhead worth reading") and the book behind a half-remembered plot ("the novel about a man alone in an endless house of statues"). |
what_to_read_nextread-only | What to read after one particular book: the next books in its series, more by the same author, and books that read like it, the same set its siftivo.com page shows. Suits "what should I read after X", "is there a sequel to X" and "more like X". For a reader who has linked their Siftivo account, each list leaves out books already in their library and books they hid, avoided or recently passed on, and a book that fits their taste says why. Takes a workId from search_books. |
Schemas: list_tools.
{
"name": "com.siftivo/siftivo",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://api.siftivo.com/mcp",
"type": "streamable-http"
}
],
"version": "0.2.0",
"repository": {
"url": "https://github.com/btg5679/siftivo",
"source": "github"
},
"websiteUrl": "https://siftivo.com/blog/siftivo-for-agents/",
"description": "Book recommendations from your reading history, plus your shelves, ratings and series order."
}