{"openapi":"3.0.3","info":{"title":"Gnist Context — Open Library","description":"Book metadata — search by title/author, work details, ISBNs, cover images.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/open-library/`\n- **Toolkit page:** `/toolkits/open-library`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/open-library/search_books":{"post":{"tags":["Reference"],"summary":"search_books","description":"Search Open Library for books by title, author, or subject.\n\nReturns matching books with titles, authors, publication years, ISBNs,\nsubjects, and cover image IDs. Use the returned work key (e.g. /works/OL27448W)\nwith get_book() for full details.","operationId":"open_library_search_books","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search query — title, author, or subject (e.g. \"the lord of the rings\", \"tolkien\").","type":"string"},"limit":{"default":10,"description":"Max results to return (1-100). Default 10.","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/open-library/get_book":{"post":{"tags":["Reference"],"summary":"get_book","description":"Get detailed information about a book/work by its Open Library work ID.\n\nReturns title, description, subjects, author references, cover IDs, and\ntimestamps. Work IDs end in \"W\" — find them via search_books().","operationId":"open_library_get_book","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"olid":{"description":"Open Library work ID (e.g. \"OL27448W\" for The Lord of the Rings).","type":"string"}},"required":["olid"],"type":"object"}}}}}},"/rest/open-library/search_authors":{"post":{"tags":["Reference"],"summary":"search_authors","description":"Search Open Library for authors by name.\n\nReturns matching authors with names, birth/death dates, top works, and\nwork counts. Use the returned author key with get_author() for full bio.","operationId":"open_library_search_authors","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Author name to search for (e.g. \"tolkien\", \"ursula le guin\").","type":"string"},"limit":{"default":10,"description":"Max results to return (1-100). Default 10.","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/open-library/get_author":{"post":{"tags":["Reference"],"summary":"get_author","description":"Get detailed information about an author by Open Library author ID.\n\nReturns name, biography, birth/death dates, external links, and photo IDs.\nAuthor IDs end in \"A\" — find them via search_authors().","operationId":"open_library_get_author","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"olid":{"description":"Open Library author ID (e.g. \"OL26320A\" for J.R.R. Tolkien).","type":"string"}},"required":["olid"],"type":"object"}}}}}},"/rest/open-library/get_editions":{"post":{"tags":["Reference"],"summary":"get_editions","description":"Get all editions of a work — different publishers, languages, formats.\n\nReturns edition details including publishers, publication dates, ISBNs,\npage counts, languages, and cover IDs. Useful for finding specific\ntranslations or print editions.","operationId":"open_library_get_editions","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"olid":{"description":"Open Library work ID (e.g. \"OL27448W\").","type":"string"},"limit":{"default":10,"description":"Max editions to return (1-100). Default 10.","type":"integer"}},"required":["olid"],"type":"object"}}}}}},"/rest/open-library/search_by_isbn":{"post":{"tags":["Reference"],"summary":"search_by_isbn","description":"Look up a specific book edition by its ISBN-10 or ISBN-13.\n\nReturns the edition's title, publishers, publication date, ISBNs, page\ncount, languages, covers, and linked work keys. Dashes in the ISBN are\nstripped automatically.","operationId":"open_library_search_by_isbn","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"isbn":{"description":"ISBN-10 or ISBN-13 (e.g. \"9780618640157\" or \"0618640150\").","type":"string"}},"required":["isbn"],"type":"object"}}}}}},"/rest/open-library/report_feedback":{"post":{"tags":["Reference"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"open_library_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Reference","description":"Data sources: Reference"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}