MCP tool reference · #513 of 563 by publishers
list_books
Exposed by 8 servers from 8 publishers, read from the live servers by the Serverdex check; most of them sit in Education & Reference; 50% of them take a limit parameter; the most-starred is Source Library (32 stars).
list_books(limit?: integer, language?: string, offset?: integer, …)Parameters
share = % of the 8 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 50% | 0% | Max results (default 100, max 200) |
| language | string | 37.5% | 0% | ISO language code for the localized names (default "en"). |
| offset | integer | 37.5% | 0% | Pagination offset. When truncated is true, call again with next_offset; a full page is not the whole holding (default 0). |
| author_id | string | 12.5% | 0% | Canonical author slug, e.g. "jan-hus" — filters to exactly that person's books via the author thesaurus (variant slugs resolve to the canonical person). Every b |
| before_id | — | 12.5% | 0% | — |
| category | string | 12.5% | 0% | Subject category. "first-translation" is accepted as an alias for first_translation=true. |
| clientId | string | 12.5% | 0% | A practice client's id, to list that client's books instead of the practice's own |
| cursor | string | 12.5% | 0% | — |
| edition_key | string | 12.5% | 0% | Other digitizations of ONE printing — pass the edition_key from a result row. Only full-quality keys match on both sides, so this answers "what other scans of t |
| first_translation | boolean | 12.5% | 0% | Only books carrying the site's "First Translation" flag (same filter as the website). A researched claim, not a proof; get_book returns the status and evidence. |
| has_edition | string | 12.5% | 0% | ISO code — return only books READABLE in that language, e.g. "es". Different from `language`, which is the language printed on the leaves of the scan: a Latin b |
| query | string | 12.5% | 0% | Part of an alias, Arabic or English title, short name, or author. |
Source: the input schema each server returns for list_books, aggregated over the 8 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with list_books
8 of 8 · 8 publishers · 8 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes list_books |
|---|---|---|---|---|---|---|
| 1 | Source Libraryembassy-of-the-free-mind · Education & Reference | embassy-of-the-free-mind | Education & Reference | 32 | yes | BROWSES/FILTERS THE CATALOG by metadata (canonical author via author_id, title/author/summary words via search, language, category, year range, translation recency) — no page-text matching. PICK THIS to see WHAT EXISTS by an author or in a tradition, or to enumerate a date range. Returns books with title, author (string + canonical author_id + author_url), language, year, translation progress, and |
| 2 | HadithDBiadnanmukhtar · Education & Reference | iadnanmukhtar | Education & Reference | 8 | yes | Discover book aliases, authors and reader URLs across the public library. A translation renders Quran wording, a tafsir explains an ayah, and a sharh explains a hadith. Hadith collections include virtual compilations with their own numbering. Sirah and history contain narrative passages. Use lookup_book for a known alias. |
| 3 | Eremos Thai Biblebtwinguitarists · Education & Reference | btwinguitarists | Education & Reference | 1 | yes | List all 66 books with English and Thai names, USFM codes and chapter counts. |
| 4 | Bible by Midvashmidvash · Education & Reference | midvash | Education & Reference | 1 | yes | Lists the 66 canonical Bible books with localized names, slugs, abbreviations, testament grouping, and chapter counts. Use this when an agent needs valid book identifiers or localized display names before calling lookup tools. |
| 5 | DIY Accounting Submitdiy-accounting-uk · Finance | diy-accounting-uk | Finance | — | yes | List the books saved in the DIYA cloud, most recently updated first, signed in as the session's credentials. Each row carries the bookId open_book takes, the book's title, its product and the period it covers. With clientId, lists that practice client's books instead of the practice's own. |
| 6 | Arcképgmen1057 · Media & Creative | gmen1057 | Media & Creative | — | yes | List the caller's book digitization orders, newest first (id, title, status, page_count, pages_done, billing). |
| 7 | Hebrew Bible (Tanakh)moshecohen90 · Education & Reference | moshecohen90 | Education & Reference | — | yes | List every book available in this corpus with its English name, localized name, and the link to its first chapter. Call this to discover valid book names for get_chapter / get_verse. |
| 8 | aipongemameziane · Productivity | mameziane | Productivity | — | yes | Show / list the user's OWN books — "what books do I have?", "my library", "my books". Returns only the books they own or created, NOT the shared aiponge catalog. To discover or search the wider aiponge book catalog, use browse_books instead. |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint.