# openlibrary-mcp-server MCP server

Search books and authors, fetch editions, browse subjects, and resolve cover images.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-openlibrary-mcp-server
- Repository: https://github.com/cyanheads/openlibrary-mcp-server

## Install
- Command: `npx -y @cyanheads/openlibrary-mcp-server`
- Endpoint: https://openlibrary.caseyjhand.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @cyanheads/openlibrary-mcp-server v0.1.5
- Environment variable: MCP_LOG_LEVEL (default info)
- Package: Npm @cyanheads/openlibrary-mcp-server v0.1.5
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_PUBLIC_URL
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- Remote endpoint: https://openlibrary.caseyjhand.com/mcp

## Tools
- openlibrary_search_books (Search Books) - 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. Results are work-level — drill into editions via openlibrary_get_editions. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_work (Get Work) - 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. Note: author names are not included — use openlibrary_get_author or openlibrary_search_books for names. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_editions (Get Editions) - List editions of a work — different publishers, languages, formats, and print runs. Returns ISBNs, publisher, language, page count, and edition OLIDs. Use after openlibrary_get_work or openlibrary_search_books to find a specific printing. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_edition (Get Edition) - Fetch a single edition by identifier: ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID (OL…M). Returns full edition metadata including authors, publisher, language, all identifier types, and the parent work ID. Use for ISBN lookups — pass id_type "isbn" for both ISBN-10 and ISBN-13. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_search_authors (Search Authors) - 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). Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_author (Get Author) - 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. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_author_works (Get Author Works) - List works by an author. Returns titles, cover IDs, and work OLIDs for drilling into editions or details. Use openlibrary_get_author for author bio and details, or openlibrary_get_editions to explore specific printings. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_subject (Get Subject) - Browse works by subject. Returns matching works with edition counts and cover IDs, plus the total work count for the subject. Subjects are user-contributed and may be inconsistent ("science fiction", "Science fiction", "SF" are separate tags). Try lowercase forms first. Endpoint: https://openlibrary.caseyjhand.com/mcp
- openlibrary_get_cover_url (Get Cover URL) - Resolve a cover image URL for a book or author photo. Returns a direct HTTPS URL in the requested size (S/M/L). The Covers API always returns HTTP 200 — missing covers return a 1×1 placeholder GIF, not a 404. URLs can be embedded in markdown as ![cover](url). Endpoint: https://openlibrary.caseyjhand.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.cyanheads
- Version: 0.1.5
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 24, 2026
- Source: https://registry.modelcontextprotocol.io