@cyanheads/openlibrary-mcp-server
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 1 tool tried
Contacts while installing and starting: nothing
Its tool definitions changed since version 0.4.0. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @cyanheads/openlibrary-mcp-server@0.4.1
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
1 tool that takes no input and looks read-only was called once with nothing. 0 returned a result.
openlibrary_search_books | No usable answer tool reported an error: Error: The search has no criterion: query, title, author, subject, publisher, and isbn are all absent or blank. Recovery: Supply a non- |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
openlibrary_search_books query, title, author, subject, publisher, isbn, language, sort, limit, offset, include_availability
Full-text book search across Open Library works. Supports field filters (title, author, subject, publisher, ISBN, language) and returns work-level records with edition counts, cover IDs, and reading availability. Use query for general search or combine specific field filters; a search needs at least one of query, title, author, subject, publisher, or isbn with a non-blank value, and language and sort only narrow or order it. Results are work-level — drill into editions via openlibrary_get_editions.
openlibrary_search_inside query, limit, offset
Search the full text of books scanned by the Internet Archive — the "which book contains this passage?" lookup that the metadata tools cannot answer. Quote a phrase for an exact-phrase match; bare terms match anywhere in the text. Each result is an Internet Archive item with the matching passages as snippets, plus a relevance score. The full-text index is far slower than the metadata endpoints, and a search usually takes 10–30 seconds. Use it when the passage is the question, and use openlibrary_search_books to search by title, author, or subject. Results key on Internet Archive items rather than Open Library works. To reach the catalogue record, pass an ia_identifier to openlibrary_search_books as query "ia:<ia_identifier>", which returns its work and, in matching_edition, the edition holding that scan; when that matches nothing (a scan no edition records), search openlibrary_search_books by the item's title and creator and compare the ia_identifiers on its results. Each ia_identifier also reads at archive.org.
openlibrary_get_work work_id
Fetch a work by Open Library Work ID (OL…W). Returns title, description, subjects, cover IDs, and linked author IDs for follow-up lookups. Works represent the abstract book concept independent of any specific edition. A merged work ID resolves to the work it was merged into. To reach a work from an ISBN, call openlibrary_get_edition with id_type "isbn" — its work_id output is the parent work. Note: author names are not included — use openlibrary_get_author or openlibrary_search_books for names.
openlibrary_get_editions work_id, limit, offset
List editions of a work — different publishers, languages, formats, translations, and print runs. Returns ISBNs, publisher, language, page count, edition OLIDs, and edition-level credits: subtitle, by-statement, translators and other contributors, and the language translated from. Use after openlibrary_get_work or openlibrary_search_books to find a specific printing. A merged work ID resolves to the work it was merged into. To reach a work from an ISBN, call openlibrary_get_edition with id_type "isbn" — its work_id output is the parent work.
openlibrary_get_edition identifiers, id_type
Resolve one or more editions by identifier: ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID (OL…M). Every identifier in a call shares one id_type — pass id_type "isbn" for both ISBN-10 and ISBN-13. Up to 50 identifiers resolve in a single upstream batch; with limit clamping enabled, exact duplicates collapse and remaining identifiers are returned as unprocessed for another call. Returns full edition metadata including authors, edition-level credits (subtitle, by-statement, translators and other contributors, the language translated from), publisher, languages, all identifier types, and the parent work ID. Author names come inline when recorded; otherwise bounded lookups recover parent-work credits marked as such, and a notice names any edition whose recovery failed. Identifiers that resolve come back in editions, each row echoing its identifier as supplied; processed misses are listed in unresolved with a reason. The call fails only when no processed identifier resolves, and any unprocessed remainder remains in its error data and recovery guidance.
5 more tools
openlibrary_search_authors query, limit, offset
Search Open Library authors by name. Returns Open Library Author IDs, names, birth/death dates, top works, and subject associations. Use author IDs for openlibrary_get_author (bio, remote IDs) or openlibrary_get_author_works (list of works).
openlibrary_get_author author_id
Fetch author detail by Open Library Author ID (OL…A). Returns bio, birth/death dates, photo IDs, and linked identifiers from Wikidata, VIAF, ISNI, Goodreads, and LibraryThing. Use openlibrary_search_authors to find an author ID first.
openlibrary_get_author_works author_id, limit, offset
List works by an author. Returns titles, cover IDs, and work OLIDs for drilling into editions or details. For the author's works ranked by edition count, call openlibrary_search_books with query "author_key:<author_id>" and sort "editions". Use openlibrary_get_author for author bio and details, or openlibrary_get_editions to explore specific printings.
openlibrary_get_subject subject, limit, offset
Browse works by subject. Returns matching works with edition counts and cover IDs, the total work count, and the subject type. Case and spacing are normalized before lookup, so "Science Fiction" and "science_fiction" are the same request. Prefix a value with place:, person:, or time: to browse a place, person, or time period, passing a value from openlibrary_get_work's subject_places, subject_people, or subject_times verbatim after the prefix (e.g., "place:London (England)"); a space after the colon is dropped. Subject tags are user-contributed and the vocabulary varies — when a subject returns no works, try a different word form (singular/plural), a synonym, or a broader term.
openlibrary_get_cover_url identifier, id_type, target, size
Construct a cover image URL for a book or author photo without fetching the image. Returns a direct HTTPS URL in the requested size (S/M/L). The identifier format is validated locally: "id" must be numeric, "isbn" 10 or 13 digits (an ISBN-10 may end in an X check digit), "olid" an edition OLID (OL…M) for target "book" and an author OLID (OL…A) for target "author". Identifiers with path separators or control characters, and author-by-ISBN lookups, are rejected. A returned URL does not verify that a cover exists.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | Apache-2.0 |
|---|---|
| Needs | node >=24.0.0 |
| Source | github.com/cyanheads/openlibrary-mcp-server |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-1gW6IQjeX/6oVN/NnOTSfCcgIq77mzFpM5+sOa3RoI2U2JVjMww6xSE2eArrRV5Njhmdnfi4iZbTkrjVjooNsw== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 0.4.1 | 2026-11-16 | Starts with no setup | 10 |
| 0.4.0 | 2026-11-12 | Starts with no setup | 10 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40cyanheads/openlibrary-mcp-server)
New version out? Ask for a fresh report.