io.github.sepehr071/30book-mcp

What it mainly works on, as our AI model read its tool descriptions: nothing outside itself: it only answers questions.

None of its 14 tools are described as changing anything.

• sb_searchreads or searches

  “Search books by title: price, final_price, discount_pct, in_stock, publisher, id.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  8 inputs, 1 required

  • querystringrequired“Title words, Persian, e.g.”
  • extendedboolean“Match words, not the exact phrase (more results).”
  • sortstring or null“Order; omit for the page default.”
  • available_onlyboolean“Only books that are in stock.”
  • publisher_idinteger or null“Only this publisher (id from sb_find_publisher or a book's publisher.id).”
  • author_idinteger or null“Only this author (id from sb_find_person or a book's authors[].id).”
  • translator_idinteger or null“Only this translator (person id).”
  • pageinteger“Page from 1.”
• sb_browsereads or searches

  “Books of a category (bta-N-M or btf-N-M-K; bts-N sections are landing pages only), genre, nation, award list or tag.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  6 inputs, 2 required

  • kindstringrequired“What to open.”
  • keystringrequired“category: code like 'bta-1-1' (sb_categories, sb_book); genre / nation / award: id from sb_collections; tag: text, e.g.”
  • sortstring or null“Order; omit for the page default.”
  • available_onlyboolean“Only books that are in stock.”
  • publisher_idinteger or null“Only this publisher.”
  • pageinteger“Page from 1.”
• sb_publisherreads or searches

  “One publisher's books plus a short about text.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  4 inputs, 1 required

  • publisher_idintegerrequired“Publisher id (sb_find_publisher, or publisher.id in sb_book).”
  • sortstring or null“Order; omit for the page default.”
  • available_onlyboolean“Only books that are in stock.”
  • pageinteger“Page from 1.”
• sb_authorreads or searches

  “Books by one author or translator (default newest first).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  4 inputs, 1 required

  • person_idintegerrequired“Person id (sb_find_person, or authors[].id / translators[].id in sb_book).”
  • sortstring or null“Order; omit for the page default.”
  • available_onlyboolean“Only books that are in stock.”
  • pageinteger“Page from 1.”
• sb_bestsellersreads or searches

  “Site-wide best sellers (10 pages).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs

  • available_onlyboolean“Only books that are in stock.”
  • pageinteger“Page from 1.”
• sb_new_releasesreads or searches

  “Newest books (10 pages).”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs

  • available_onlyboolean“Only books that are in stock.”
  • pageinteger“Page from 1.”
• sb_dealsreads or searches

  “Best sellers (or one subject) by biggest discount.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  3 inputs

  • subjectstring or null“Subject code such as 'bta-1-1'; omit for all best sellers.”
  • available_onlyboolean“Only books that are in stock.”
  • pageinteger“Page from 1.”
• sb_find_publisherreads or searches

  “Look up publisher ids by name.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input, 1 required

  • namestringrequired“Part of the publisher name, Persian, e.g.”
• sb_find_personreads or searches

  “Look up author / translator ids by name.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input, 1 required

  • namestringrequired“Part of a person's name, Persian, e.g.”
• sb_bookreads or searches

  “One book: authors, translators, publisher, price, final_price, discount_pct, in_stock, ISBN, pages, cover, size, language, edition, year (Shamsi), weight, categories (codes for sb_browse), rating, ta…”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  3 inputs, 1 required

  • book_idintegerrequired“Book id from sb_search / listings, e.g.”
  • max_charsinteger“Cut the description here (0 = no cut).”
  • include_blurbboolean“Also return review_text (blurb) and stats.”
• sb_similarreads or searches

  “Similar books, more by the author and (translations) by the translator, up to 20 each.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input, 1 required

  • book_idintegerrequired“Book id from sb_search / listings, e.g.”
• sb_reviewsreads or searches

  “Reader comments (author, date, stars, text cut to 400 chars unless full_text, likes) and the rating summary; only the first comments on the page are available.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  2 inputs, 1 required

  • book_idintegerrequired“Book id from sb_search / listings, e.g.”
  • full_textboolean“Return whole review texts instead of 400 chars.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.