gutenberg-mcp-server
Server Details
MCP server for Project Gutenberg: 78,000+ public-domain ebooks with full plain-text retrieval.
- Status
- Healthy
- Uptime
- 100.0% over 82 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/gutenberg-mcp-server
- GitHub Stars
- 6
- Server Listing
- gutenberg-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 4 tools
browse_popular and search_books are close cousins (popularity-ordered listing vs. keyword search), but the descriptions clearly separate discovery from querying, and get_book vs. get_text cleanly split metadata from content. Minor risk of an agent choosing browse when a filtered search would serve better, but boundaries are explained.
All four tools follow a strict gutenberg_<verb>_<noun> pattern: browse_popular, get_book, get_text, search_books. Fully predictable and distinguishable at a glance.
Four tools is tightly scoped and each maps to an essential capability (discover, search, inspect metadata, read content). Nothing feels padded or missing for a read-only catalog server.
The lifecycle from discovery to full text is covered, including pagination and format URLs. Minor gaps like dedicated author or bookshelf browsing are largely absorbed by the search filters, so agents have workarounds.
Available Tools
4 toolsgutenberg_browse_popularBrowse Popular Gutenberg BooksARead-onlyIdempotentInspect
Browse Project Gutenberg books ordered by downloads in the last 30 days at the source snapshot. Returns up to 32 titles with IDs, authors, languages, download counts, and is_readable. Filter by language, topic, MIME prefix or copyright status. Empty matches succeed with criteria and a notice; truncated results include executable search continuation. Use this for discovery — "what are the most popular classics in French?".
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Requested number of books. Default 20; requests above 32 are capped locally at 32. | |
| topic | No | Filter by a subject or bookshelf keyword (case-insensitive phrase match). Example: "science fiction", "adventure", "detective". Applies on top of the language filter. | |
| copyright | No | Any selected source copyright status: "true" copyrighted, "false" public domain in the USA, "null" unknown. Empty means all statuses; this is not worldwide legal clearance. | |
| languages | No | Restrict to books in these catalog language codes, exactly as results report them ("en", not "eng"). Example: ["en"] for English only, ["de", "fr"] for German or French, ["ang"] for Old English. Omit for all languages. | |
| mime_type | No | Literal prefix of a format MIME key, such as "text/plain" or "application/pdf". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cap | No | The limit that was applied. |
| books | No | Top books by downloads in the last 30 days at the source snapshot, most popular first. |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Number of books returned in this response. |
| notice | No | Guidance for empty or capped results. |
| truncated | No | True when the catalog held more matches than were returned. |
| appliedLimit | No | Book limit applied locally, at most 32. |
| continuation | No | Present only when more matching books exist. |
| requestedLimit | No | Positive integral book limit requested before capping. |
| totalInCatalog | No | Total books matching the filter in the full catalog (useful for context — "top 20 of 60,000"). |
| effectiveCriteria | No | Normalized browse criteria, including popular sort and first page. |
| truncationCeiling | No | Downloads in the last 30 days at the source snapshot for the least-popular book shown; omitted books have at most this count. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the read-only/idempotent/open-world profile, and the description adds behavior the annotations cannot: a hard 32-title cap, the fact that empty matches still succeed (with criteria and a notice rather than an error), and that truncated pages carry an executable continuation. These are exactly the edge cases an agent needs and none are derivable from structured fields.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the ordering and scope, then behavior, then usage — a sound information order. It is dense with semicolon-joined clauses and the return-field list is arguably redundant given the output schema, but no sentence is pure filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so the description does not need the ID/author/language field list it includes, and that is the only wasted coverage. The genuinely load-bearing parts — the 32 cap, empty-result semantics, and continuation behavior — make it complete enough for an open-world, zero-required-parameter browse tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the parameter descriptions already explain language codes, copyright tri-state, and MIME prefix matching in more detail than the description does. The description's "Filter by language, topic, MIME prefix or copyright status" only enumerates what the schema already documents; the one added signal, that results cap at 32, is also restated in the limit schema description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource plus its ranking basis: "Browse Project Gutenberg books ordered by downloads in the last 30 days at the source snapshot." That clearly separates it from gutenberg_get_book and gutenberg_get_text, but the nearest sibling, gutenberg_search_books, is never named, so the agent must infer the popularity-list vs keyword-search split.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The closing clause "Use this for discovery — 'what are the most popular classics in French?'" gives concrete use context and an example query shape. It stops short of stating when-not or naming the keyword-search alternative, so the routing rule is implied rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gutenberg_get_bookGet Gutenberg BookARead-onlyIdempotentInspect
Fetch complete metadata for a Project Gutenberg book by ID — title, authors (with birth/death years), translators, editors, source bibliographic notes, subjects, bookshelves, languages, copyright status, and the full formats map with download URLs (plain text, HTML, EPUB, cover image, etc.). Use is_readable before gutenberg_get_text; source_notes may identify specific editions.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Project Gutenberg book ID. Visible in Gutenberg URLs (e.g., gutenberg.org/ebooks/1342) and returned by gutenberg_search_books and gutenberg_browse_popular. Example: 1342 for Pride and Prejudice, 2600 for War and Peace. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | Gutenberg ID. |
| error | No | Present when the call failed. Absent on success. |
| title | No | Book title. |
| authors | No | Primary author(s). |
| editors | No | Editors, if any. |
| formats | No | Map of MIME type to download URL. Key types: "text/plain; charset=utf-8" (preferred for gutenberg_get_text), "text/html", "application/epub+zip", "image/jpeg" (cover). Not every format is present for every book. |
| summary | No | First entry of summaries, not necessarily primary, or null when the source has none. |
| subjects | No | Library of Congress subject headings. |
| copyright | No | Copyright status: false = public domain in the USA, true = under copyright, null = unknown. |
| languages | No | Catalog language codes for this edition. |
| summaries | No | Every source-provided summary: sorted on the RDF mirror, upstream order on live fallback. Empty when there are none. |
| media_type | No | Source media type, such as "Text" or "Sound" (audio). Use is_readable to check reader support. |
| bookshelves | No | Project Gutenberg bookshelf categories (e.g., "Best Books Ever Listings", "Category: Classics of Literature"). |
| is_readable | No | Eligible Text record with UTF-8 plain text, or HTML without audio formats. Does not guarantee the mirror file exists. |
| translators | No | Translators, if this is a translated work. |
| source_notes | No | Source-provided RDF bibliographic notes in document order, including explicit edition references. [] means inspected with no notes; null means unavailable from this source. |
| download_count | No | Downloads in the last 30 days at the source snapshot, used for popularity ranking. |
| has_plain_text | No | True if media_type is "Text" and "text/plain; charset=utf-8" is present. HTML-only editions can still have is_readable=true. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, and openWorld, so the safety profile is covered. The description adds real value on top: it lists the exact breadth of data returned, including birth/death years, copyright status, and the full formats map with download URLs, which tells the agent this is a heavy single-record lookup rather than a stub.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the core purpose and a dense but useful field inventory. The trailing clause about 'is_readable' is the one piece that does not earn its place, since it names a tool the agent cannot invoke.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description needn't explain return values, and annotations plus the schema carry safety and parameter meaning. It is complete enough to call correctly; only the dangling non-sibling tool reference slightly muddies it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the single `id` parameter is documented with URL patterns and two concrete examples (1342, 2600). The description only says 'by ID' and adds nothing the schema does not already say, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('Fetch complete metadata for a Project Gutenberg book by ID') and enumerates the payload (title, authors, translators, subjects, formats map), which makes it trivially distinguishable from gutenberg_get_text, which returns the book body.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The second sentence gestures at a workflow ('source_notes may identify specific editions') and at a readable-check before fetching text, implying this is the metadata step. But it references 'is_readable', a tool that is not among the siblings (gutenberg_browse_popular, gutenberg_get_text, gutenberg_search_books), so the routing advice points at something the agent cannot call. Usage is implied rather than stated cleanly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gutenberg_get_textGet Gutenberg Book TextARead-onlyIdempotentInspect
Retrieve the plain-text content of a Project Gutenberg book, stripped of the standard license header and footer. Front matter such as producer credits, the title page, contents, and prefaces stays in the text. For long works — novels routinely run 500KB–2MB — use offset and limit to read in chunks rather than fetching the whole book at once, or pass find to jump to a known passage without paging. The response reports totalChars and remainingChars for reliable pagination. Prefers UTF-8 plain text; falls back to an HTML edition converted to text; refuses audio books (media_type "Sound") with a clear error.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Project Gutenberg book ID. Use gutenberg_search_books or gutenberg_get_book to find IDs. Example: 1342 for Pride and Prejudice, 2600 for War and Peace, 84 for Frankenstein. | |
| find | No | A passage to locate instead of paging to it: the response starts at the first occurrence at or after offset and adds match, and an absent passage fails with passage_not_found rather than returning other text. Matching ignores letter case and whitespace around find. Any run of spaces, tabs, or line breaks matches any other such run, so a hard-wrapped line still matches. Straight and curly quotes match each other. Accents count: "cafe" does not match "café". Everything else is literal, with no wildcards or patterns, so an italic word stored as _word_ needs its underscores. A blank find is an ordinary read. | |
| limit | No | Requested maximum characters. Default 20,000; requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation. Trimming never cuts before a find match ends. | |
| offset | No | Character offset into the stripped literary text at which to start reading. 0 returns the beginning of the work. To read subsequent chunks, use offset = prior_offset + prior_length (the length field from the previous response — NOT offset + limit, because the actual returned length may be slightly less than limit due to paragraph-boundary trimming). With find, the search starts here and the returned chunk starts at the match. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | Gutenberg book ID. |
| text | No | The requested chunk of literary text, stripped of Gutenberg license boilerplate. Encoding: UTF-8. Line endings: normalized to LF. |
| error | No | Present when the call failed. Absent on success. |
| match | No | Where find matched. Absent on a read without find. |
| title | No | Book title, from the catalog record. |
| length | No | Number of characters in this chunk. |
| offset | No | Character offset where this chunk begins: the match start when find matched. |
| hasMore | No | True if there is more text after this chunk. When true, call again with offset = offset + length and no find. |
| provenance | No | One-line source note with Project Gutenberg ID, title, and license URL. |
| totalChars | No | Total characters in the stripped literary text. Use with offset and length to determine progress and plan subsequent calls. |
| appliedLimit | No | Character limit applied to this chunk, at most 50,000. |
| sourceFormat | No | The format that was fetched. "text/html" indicates HTML-to-text conversion was applied because no plain-text format was available. |
| remainingChars | No | Characters remaining after this chunk (totalChars - offset - length). 0 means this chunk includes the end of the book. |
| requestedLimit | No | Positive integral character limit requested by the caller, before capping. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly/idempotent, so the bar is lower, yet the description adds substantial context beyond them: license boilerplate removal, retention of front matter, realistic size ranges (500KB–2MB), UTF-8 preference with HTML fallback, and an explicit refusal path for audio books (media_type "Sound"). It also discloses that the response carries totalChars/remainingChars for pagination.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Purpose is front-loaded in the first clause, then chunking guidance, then the behavioral caveats. Roughly five dense sentences with no filler — each one carries information an agent would otherwise have to discover by trial.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return-value detail is not required, yet the description still flags totalChars/remainingChars for pagination. Combined with the size ranges and fallback/refusal behavior, an agent has everything needed to call this correctly on the first try.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the parameter docs are already very detailed, so the baseline of 3 applies. The description restates the chunking strategy and find-jump pattern but adds no matching syntax or edge-case rules beyond what the schema already spells out.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Retrieve the plain-text content of a Project Gutenberg book') plus precise scope: license header/footer stripped, front matter retained. The distinction from siblings such as gutenberg_get_book is only implicit — the description never names the metadata tool it complements — so it falls just short of full sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives explicit operational guidance: chunk with offset/limit for long works, or use find to jump to a known passage instead of paging. What's missing is routing relative to alternatives (e.g. 'use gutenberg_get_book first if you only need metadata'), so usage is clear but not exclusive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gutenberg_search_booksSearch Gutenberg BooksARead-onlyIdempotentInspect
Search the Project Gutenberg catalog of 78,000+ books. Every query word matches a title or author substring; filter by topic, language, translator, author lifespan, IDs, MIME prefix or copyright status. More than four query words, and the translator filter, require the local mirror. Empty matches succeed with criteria and a notice. Default popularity uses downloads in the last 30 days at the source snapshot. Returns IDs, titles, authors, languages, subjects, counts, and is_readable — use gutenberg_get_book for full metadata.
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Narrow results to these Gutenberg IDs, intersected with other filters. An empty list selects nothing; omit for unrestricted IDs. Use gutenberg_get_book for full single-ID metadata. | |
| page | No | Page number for paginated results (1-indexed). Each page returns up to 32 books. Use totalCount to determine total pages. | |
| sort | No | Result ordering. "popular" (default) sorts by downloads in the last 30 days at the source snapshot, descending. "ascending" and "descending" sort by Gutenberg ID number. | popular |
| query | No | Every nonblank whitespace-separated word must match title or author name as a literal substring. The local mirror ignores case and accents; live fallback may require accents and rejects more than four words. Example: "dickens expectations" matches Great Expectations. | |
| topic | No | Phrase to match against subjects and bookshelves, ignoring case and, on the local mirror, accents. Example: "detective" matches the "Detective Fiction" bookshelf and "Detective and mystery stories" subject. Separate from query — topic searches categorization metadata, not title/author. | |
| copyright | No | Any selected source copyright status: "true" copyrighted, "false" public domain in the USA, "null" unknown. Empty means all statuses; this is not worldwide legal clearance. | |
| languages | No | Filter to books in any of these catalog language codes, exactly as results report them ("en", not "eng"). Example: ["en"] for English, ["fr", "de"] for French or German, ["enm"] for Middle English. | |
| mime_type | No | Literal prefix of a format MIME key, such as "text/plain" or "application/pdf". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset. | |
| translator | No | Every nonblank whitespace-separated word must match a translator name as a literal substring, ignoring case and accents; words can land on different translators of one book. Requires the local mirror. Example: "maude" finds the Aylmer and Louise Maude translations. Result rows omit translators; gutenberg_get_book reports them. | |
| author_year_end | No | Include only books with an author who has a known birth or death year on or before this year. With author_year_start, one author must meet both bounds. Example: author_year_start=1800 with author_year_end=1899 returns books with 19th-century authors. | |
| author_year_start | No | Include only books with an author who has a known birth or death year on or after this year (positive = CE, negative = BCE). With author_year_end, one author must meet both bounds. |
Output Schema
| Name | Required | Description |
|---|---|---|
| page | No | Current page number. |
| books | No | Matching books, ordered by the sort parameter. |
| error | No | Present when the call failed. Absent on success. |
| notice | No | Actionable guidance for an empty selection, or a caveat that the live catalog checked author_year_start and author_year_end separately. The caveat can accompany results. |
| hasMore | No | True if there are additional pages of results. |
| totalCount | No | Total number of books matching the query across all pages. |
| effectiveCriteria | No | Normalized search criteria, including sort and page defaults. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the read-only/idempotent annotations, it discloses non-obvious behavior: empty matches still succeed with criteria and a notice, popularity reflects downloads in the last 30 days at the source snapshot, and the live fallback degrades (rejects >4 words, may require accents). That is exactly the operational context annotations cannot carry.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Dense and front-loaded: capability, filters, mirror caveat, empty-result behavior, sort default, return fields, sibling pointer. Every sentence earns its place, though the filter enumeration in one clause is crammed and slightly scannability-poor.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For an 11-parameter, no-required-parameter search tool, the description covers filtering semantics, failure modes, and fallback behavior. It also lists return fields even though an output schema exists, which is mild redundancy rather than a gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3; the description still adds cross-parameter meaning the schema states only locally — the AND semantics of every query word, the mirror requirement for translator, and what the popularity default actually measures. It stops short of adding anything for ids, page, mime_type, or copyright beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Opens with a specific verb and resource plus scope: 'Search the Project Gutenberg catalog of 78,000+ books.' It also distinguishes itself from the sibling gutenberg_get_book by naming it for full metadata, so an agent can route without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly routes to gutenberg_get_book for full metadata and states the conditions that force the local mirror (more than four query words, translator filter). It does not contrast with gutenberg_browse_popular or gutenberg_get_text, so the sibling map is incomplete.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
- Changed
gutenberg_browse_popular10 fields changed- changed
Input schema / properties / mime_type / descriptionPrevious value: -"Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset."New value: +"Literal prefix of a format MIME key, such as \"text/plain\" or \"application/pdf\". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset." - changed
Output schema / properties / books / items / properties / is_readable / descriptionPrevious value: -"True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text."New value: +"Eligible Text record with UTF-8 plain text, or HTML without audio formats. Does not guarantee the mirror file exists." - changed
Output schema / properties / continuation / properties / arguments / properties / mime_type / descriptionPrevious value: -"Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset."New value: +"Literal prefix of a format MIME key, such as \"text/plain\" or \"application/pdf\". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset." - changed
Output schema / properties / continuation / properties / arguments / properties / query / descriptionPrevious value: -"Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words."New value: +"Every nonblank word must occur in the title or an author name as a literal substring. The local mirror ignores case and accents; live matching is upstream-defined. More than four words require the local mirror. Whitespace separates words." - changed
Output schema / properties / continuation / properties / arguments / properties / topic / descriptionPrevious value: -"Case-insensitive phrase in a subject or bookshelf; blank means unset."New value: +"Phrase in a subject or bookshelf, ignoring case and, on the local mirror, accents; blank means unset." - changed
Output schema / properties / continuation / properties / arguments / properties / translator / descriptionPrevious value: -"Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words."New value: +"Every nonblank word must occur in a translator name as a literal substring, ignoring case and accents. Requires the local mirror. Whitespace separates words." - changed
Output schema / properties / effectiveCriteria / properties / mime_type / descriptionPrevious value: -"Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset."New value: +"Literal prefix of a format MIME key, such as \"text/plain\" or \"application/pdf\". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset." - changed
Output schema / properties / effectiveCriteria / properties / query / descriptionPrevious value: -"Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words."New value: +"Every nonblank word must occur in the title or an author name as a literal substring. The local mirror ignores case and accents; live matching is upstream-defined. More than four words require the local mirror. Whitespace separates words." - changed
Output schema / properties / effectiveCriteria / properties / topic / descriptionPrevious value: -"Case-insensitive phrase in a subject or bookshelf; blank means unset."New value: +"Phrase in a subject or bookshelf, ignoring case and, on the local mirror, accents; blank means unset." - changed
Output schema / properties / effectiveCriteria / properties / translator / descriptionPrevious value: -"Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words."New value: +"Every nonblank word must occur in a translator name as a literal substring, ignoring case and accents. Requires the local mirror. Whitespace separates words."
- Changed
gutenberg_get_book3 fields changed- changed
Output schema / properties / is_readable / descriptionPrevious value: -"True for non-Sound records with a supported UTF-8 plain-text or HTML format for gutenberg_get_text."New value: +"Eligible Text record with UTF-8 plain text, or HTML without audio formats. Does not guarantee the mirror file exists." - changed
Output schema / properties / summaries / descriptionPrevious value: -"Every summary Gutendex holds for this work, in upstream order. Usually one; some records carry a long and a short variant. Empty when there are none."New value: +"Every source-provided summary: sorted on the RDF mirror, upstream order on live fallback. Empty when there are none." - changed
Output schema / properties / summary / descriptionPrevious value: -"First entry of summaries — the primary auto-generated summary of the work, or null when Gutendex has none."New value: +"First entry of summaries, not necessarily primary, or null when the source has none."
- Changed
gutenberg_get_text2 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Requested maximum characters. Default 20,000 (~4–5 pages of prose); requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation. Trimming never cuts before a find match ends."New value: +"Requested maximum characters. Default 20,000; requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation. Trimming never cuts before a find match ends." - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `text_file_not_found`: The catalog entry exists but its mirror text file returned HTTP 404. `text_fetch_rejected`: The mirror permanently rejected this text request. `invalid_text_response`: The mirror returned an empty document, HTML on a plain-text path, or recognizable server failure document. `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `passage_not_found`: find has no occurrence at or after offset. `text_fetch_failed`: The Gutenberg mirror had a transient failure or did not respond within the request budget. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `text_file_not_found`: The catalog entry exists but its mirror text file returned HTTP 404. `text_fetch_rejected`: The mirror permanently rejected this text request. `invalid_text_response`: The mirror returned an empty document, HTML on a plain-text path, or recognizable server failure document. `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an ASCII-only or PDF/TeX-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `passage_not_found`: find has no occurrence at or after offset. `text_fetch_failed`: The Gutenberg mirror had a transient failure or the download did not finish within the remaining upstream allowance. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler."
- Changed
gutenberg_search_books9 fields changed- changed
Input schema / properties / mime_type / descriptionPrevious value: -"Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset."New value: +"Literal prefix of a format MIME key, such as \"text/plain\" or \"application/pdf\". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset." - changed
Input schema / properties / query / descriptionPrevious value: -"Every nonblank whitespace-separated word must match title or author name as a case-insensitive literal substring. More than four words require the local mirror; live fallback rejects longer queries. Example: \"dickens expectations\" matches Great Expectations."New value: +"Every nonblank whitespace-separated word must match title or author name as a literal substring. The local mirror ignores case and accents; live fallback may require accents and rejects more than four words. Example: \"dickens expectations\" matches Great Expectations." - changed
Input schema / properties / topic / descriptionPrevious value: -"Case-insensitive phrase to match against subjects and bookshelves. Example: \"detective\" returns books on the \"Detective and Mystery Stories\" bookshelf. Separate from query — topic searches categorization metadata, not title/author."New value: +"Phrase to match against subjects and bookshelves, ignoring case and, on the local mirror, accents. Example: \"detective\" matches the \"Detective Fiction\" bookshelf and \"Detective and mystery stories\" subject. Separate from query — topic searches categorization metadata, not title/author." - changed
Input schema / properties / translator / descriptionPrevious value: -"Every nonblank whitespace-separated word must match a translator name as a case-insensitive literal substring; words can land on different translators of one book, and accents must match. Requires the local mirror. Example: \"maude\" finds the Aylmer and Louise Maude translations. Result rows omit translators; gutenberg_get_book reports them."New value: +"Every nonblank whitespace-separated word must match a translator name as a literal substring, ignoring case and accents; words can land on different translators of one book. Requires the local mirror. Example: \"maude\" finds the Aylmer and Louise Maude translations. Result rows omit translators; gutenberg_get_book reports them." - changed
Output schema / properties / books / items / properties / is_readable / descriptionPrevious value: -"True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text."New value: +"Eligible Text record with UTF-8 plain text, or HTML without audio formats. Does not guarantee the mirror file exists." - changed
Output schema / properties / effectiveCriteria / properties / mime_type / descriptionPrevious value: -"Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset."New value: +"Literal prefix of a format MIME key, such as \"text/plain\" or \"application/pdf\". Type and subtype casing is normalized; parameter suffixes retain literal case. Blank means unset." - changed
Output schema / properties / effectiveCriteria / properties / query / descriptionPrevious value: -"Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words."New value: +"Every nonblank word must occur in the title or an author name as a literal substring. The local mirror ignores case and accents; live matching is upstream-defined. More than four words require the local mirror. Whitespace separates words." - changed
Output schema / properties / effectiveCriteria / properties / topic / descriptionPrevious value: -"Case-insensitive phrase in a subject or bookshelf; blank means unset."New value: +"Phrase in a subject or bookshelf, ignoring case and, on the local mirror, accents; blank means unset." - changed
Output schema / properties / effectiveCriteria / properties / translator / descriptionPrevious value: -"Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words."New value: +"Every nonblank word must occur in a translator name as a literal substring, ignoring case and accents. Requires the local mirror. Whitespace separates words."
4 tool updates
- Changed
gutenberg_browse_popular12 fields changed- changed
Input schema / properties / languages / descriptionPrevious value: -"Restrict to books in these languages (two-character ISO 639-1 codes). Example: [\"en\"] for English only, [\"de\", \"fr\"] for German or French. Omit for all languages."New value: +"Restrict to books in these catalog language codes, exactly as results report them (\"en\", not \"eng\"). Example: [\"en\"] for English only, [\"de\", \"fr\"] for German or French, [\"ang\"] for Old English. Omit for all languages." - changed
Input schema / properties / languages / items / maxLengthPrevious value: -2New value: +3 - changed
Output schema / properties / continuation / properties / arguments / properties / author_year_end / descriptionPrevious value: -"At least one author has a birth or death year on or before this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or before this year (CE positive, BCE negative). With author_year_start, one author must meet both bounds." - changed
Output schema / properties / continuation / properties / arguments / properties / author_year_start / descriptionPrevious value: -"At least one author has a birth or death year on or after this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or after this year (CE positive, BCE negative). With author_year_end, one author must meet both bounds." - changed
Output schema / properties / continuation / properties / arguments / properties / languages / descriptionPrevious value: -"Any listed two-character ISO 639-1 language code; empty means all languages."New value: +"Any listed two- or three-letter catalog language code; empty means all languages." - changed
Output schema / properties / continuation / properties / arguments / properties / languages / items / maxLengthPrevious value: -2New value: +3 - added
Output schema / properties / continuation / properties / arguments / properties / translatorAdded value: +{ + "description": "Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words.", + "type": "string" +} - changed
Output schema / properties / effectiveCriteria / properties / author_year_end / descriptionPrevious value: -"At least one author has a birth or death year on or before this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or before this year (CE positive, BCE negative). With author_year_start, one author must meet both bounds." - changed
Output schema / properties / effectiveCriteria / properties / author_year_start / descriptionPrevious value: -"At least one author has a birth or death year on or after this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or after this year (CE positive, BCE negative). With author_year_end, one author must meet both bounds." - changed
Output schema / properties / effectiveCriteria / properties / languages / descriptionPrevious value: -"Any listed two-character ISO 639-1 language code; empty means all languages."New value: +"Any listed two- or three-letter catalog language code; empty means all languages." - changed
Output schema / properties / effectiveCriteria / properties / languages / items / maxLengthPrevious value: -2New value: +3 - added
Output schema / properties / effectiveCriteria / properties / translatorAdded value: +{ + "description": "Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words.", + "type": "string" +}
- Changed
gutenberg_get_book1 field changed- changed
Output schema / properties / languages / descriptionPrevious value: -"Two-character language codes for this edition."New value: +"Catalog language codes for this edition."
- Changed
gutenberg_get_text8 fields changed- added
Input schema / properties / findAdded value: +{ + "description": "A passage to locate instead of paging to it: the response starts at the first occurrence at or after offset and adds match, and an absent passage fails with passage_not_found rather than returning other text. Matching ignores letter case and whitespace around find. Any run of spaces, tabs, or line breaks matches any other such run, so a hard-wrapped line still matches. Straight and curly quotes match each other. Accents count: \"cafe\" does not match \"café\". Everything else is literal, with no wildcards or patterns, so an italic word stored as _word_ needs its underscores. A blank find is an ordinary read.", + "type": "string" +} - changed
Input schema / properties / limit / descriptionPrevious value: -"Requested maximum characters. Default 20,000 (~4–5 pages of prose); requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation."New value: +"Requested maximum characters. Default 20,000 (~4–5 pages of prose); requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation. Trimming never cuts before a find match ends." - changed
Input schema / properties / offset / descriptionPrevious value: -"Character offset into the stripped literary text at which to start reading. 0 returns the beginning of the work. To read subsequent chunks, use offset = prior_offset + prior_length (the length field from the previous response — NOT offset + limit, because the actual returned length may be slightly less than limit due to paragraph-boundary trimming)."New value: +"Character offset into the stripped literary text at which to start reading. 0 returns the beginning of the work. To read subsequent chunks, use offset = prior_offset + prior_length (the length field from the previous response — NOT offset + limit, because the actual returned length may be slightly less than limit due to paragraph-boundary trimming). With find, the search starts here and the returned chunk starts at the match." - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `text_file_not_found`: The catalog entry exists but its mirror text file returned HTTP 404. `text_fetch_rejected`: The mirror permanently rejected this text request. `invalid_text_response`: The mirror returned an empty document, HTML on a plain-text path, or recognizable server failure document. `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg mirror had a transient failure or did not respond within the request budget. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `text_file_not_found`: The catalog entry exists but its mirror text file returned HTTP 404. `text_fetch_rejected`: The mirror permanently rejected this text request. `invalid_text_response`: The mirror returned an empty document, HTML on a plain-text path, or recognizable server failure document. `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `passage_not_found`: find has no occurrence at or after offset. `text_fetch_failed`: The Gutenberg mirror had a transient failure or did not respond within the request budget. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "text_file_not_found", - "text_fetch_rejected", - "invalid_text_response", - "not_found", - "audio_book", - "no_text_format", - "offset_out_of_range", - "text_fetch_failed", - "catalog_unavailable" -]New value: +[ + "text_file_not_found", + "text_fetch_rejected", + "invalid_text_response", + "not_found", + "audio_book", + "no_text_format", + "offset_out_of_range", + "passage_not_found", + "text_fetch_failed", + "catalog_unavailable" +] - changed
Output schema / properties / hasMore / descriptionPrevious value: -"True if there is more text after this chunk. When true, call again with offset = offset + length."New value: +"True if there is more text after this chunk. When true, call again with offset = offset + length and no find." - added
Output schema / properties / matchAdded value: +{ + "additionalProperties": false, + "description": "Where find matched. Absent on a read without find.", + "properties": { + "laterMatches": { + "description": "Non-overlapping occurrences after this one. While above 0, repeat the same find with offset = match.offset + match.length for the next.", + "type": "number" + }, + "length": { + "description": "Characters the match spans in the stored text. Can differ from the length of find, since a whitespace run matches a run of any length.", + "type": "number" + }, + "offset": { + "description": "Start of the match, in the same coordinates as offset and totalChars.", + "type": "number" + } + }, + "required": [ + "offset", + "length", + "laterMatches" + ], + "type": "object" +} - changed
Output schema / properties / offset / descriptionPrevious value: -"Character offset where this chunk begins."New value: +"Character offset where this chunk begins: the match start when find matched."
- Changed
gutenberg_search_books14 fields changed- changed
Input schema / properties / author_year_end / descriptionPrevious value: -"Include only books with at least one author alive on or before this year. Example: author_year_start=1800 with author_year_end=1899 returns books with 19th-century authors."New value: +"Include only books with an author who has a known birth or death year on or before this year. With author_year_start, one author must meet both bounds. Example: author_year_start=1800 with author_year_end=1899 returns books with 19th-century authors." - changed
Input schema / properties / author_year_start / descriptionPrevious value: -"Include only books with at least one author alive on or after this year (positive = CE, negative = BCE). Combine with author_year_end for a range."New value: +"Include only books with an author who has a known birth or death year on or after this year (positive = CE, negative = BCE). With author_year_end, one author must meet both bounds." - changed
Input schema / properties / languages / descriptionPrevious value: -"Filter to books in any of these two-character ISO 639-1 language codes. Example: [\"en\"] for English, [\"fr\", \"de\"] for French or German."New value: +"Filter to books in any of these catalog language codes, exactly as results report them (\"en\", not \"eng\"). Example: [\"en\"] for English, [\"fr\", \"de\"] for French or German, [\"enm\"] for Middle English." - changed
Input schema / properties / languages / items / maxLengthPrevious value: -2New value: +3 - added
Input schema / properties / translatorAdded value: +{ + "description": "Every nonblank whitespace-separated word must match a translator name as a case-insensitive literal substring; words can land on different translators of one book, and accents must match. Requires the local mirror. Example: \"maude\" finds the Aylmer and Louise Maude translations. Result rows omit translators; gutenberg_get_book reports them.", + "type": "string" +} - changed
Output schema / properties / books / items / properties / languages / descriptionPrevious value: -"Two-character language codes for this edition."New value: +"Catalog language codes for this edition." - changed
Output schema / properties / effectiveCriteria / properties / author_year_end / descriptionPrevious value: -"At least one author has a birth or death year on or before this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or before this year (CE positive, BCE negative). With author_year_start, one author must meet both bounds." - changed
Output schema / properties / effectiveCriteria / properties / author_year_start / descriptionPrevious value: -"At least one author has a birth or death year on or after this year (CE positive, BCE negative)."New value: +"An author has a known birth or death year on or after this year (CE positive, BCE negative). With author_year_end, one author must meet both bounds." - changed
Output schema / properties / effectiveCriteria / properties / languages / descriptionPrevious value: -"Any listed two-character ISO 639-1 language code; empty means all languages."New value: +"Any listed two- or three-letter catalog language code; empty means all languages." - changed
Output schema / properties / effectiveCriteria / properties / languages / items / maxLengthPrevious value: -2New value: +3 - added
Output schema / properties / effectiveCriteria / properties / translatorAdded value: +{ + "description": "Every nonblank word must occur in a translator name, case-insensitively, as a literal substring. Requires the local mirror. Whitespace separates words.", + "type": "string" +} - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `query_requires_mirror`: More than four query words were supplied while the local mirror could not answer. `page_out_of_range`: The requested page number is past the last page of results for this query. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one search. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `translator_requires_mirror`: A translator filter was supplied while the local mirror could not answer. `query_requires_mirror`: More than four query words were supplied while the local mirror could not answer. `page_out_of_range`: The requested page number is past the last page of results for this query. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one search. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "query_requires_mirror", - "page_out_of_range", - "catalog_unavailable" -]New value: +[ + "translator_requires_mirror", + "query_requires_mirror", + "page_out_of_range", + "catalog_unavailable" +] - changed
Output schema / properties / notice / descriptionPrevious value: -"Actionable guidance for an empty selection."New value: +"Actionable guidance for an empty selection, or a caveat that the live catalog checked author_year_start and author_year_end separately. The caveat can accompany results."
2 tool updates
- Changed
gutenberg_browse_popular8 fields changed- added
Input schema / properties / copyrightAdded value: +{ + "description": "Any selected source copyright status: \"true\" copyrighted, \"false\" public domain in the USA, \"null\" unknown. Empty means all statuses; this is not worldwide legal clearance.", + "items": { + "enum": [ + "true", + "false", + "null" + ], + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / mime_typeAdded value: +{ + "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.", + "type": "string" +} - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "requestedLimit", - "appliedLimit", - "books", - "totalInCatalog", - "truncated", - "shown", - "cap" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "requestedLimit", + "appliedLimit", + "books", + "totalInCatalog", + "effectiveCriteria", + "truncated", + "shown", + "cap" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / continuationAdded value: +{ + "additionalProperties": false, + "description": "Present only when more matching books exist.", + "properties": { + "arguments": { + "additionalProperties": false, + "description": "Executable search arguments preserving all filters. Page 1 may repeat already shown books when the browse cap cuts a page.", + "properties": { + "author_year_end": { + "description": "At least one author has a birth or death year on or before this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "author_year_start": { + "description": "At least one author has a birth or death year on or after this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "copyright": { + "description": "Any selected source copyright status: \"true\" copyrighted, \"false\" public domain in the USA, \"null\" unknown. Empty means all statuses; this is not worldwide legal clearance.", + "items": { + "enum": [ + "true", + "false", + "null" + ], + "type": "string" + }, + "type": "array" + }, + "ids": { + "description": "Restrict to these Gutenberg IDs, intersected with other filters. An empty list selects nothing; omit for unrestricted IDs.", + "items": { + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "type": "array" + }, + "languages": { + "description": "Any listed two-character ISO 639-1 language code; empty means all languages.", + "items": { + "maxLength": 2, + "minLength": 2, + "type": "string" + }, + "type": "array" + }, + "mime_type": { + "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.", + "type": "string" + }, + "page": { + "default": 1, + "description": "One-indexed page of at most 32 matches. Pages beyond the result range are errors.", + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "query": { + "description": "Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words.", + "type": "string" + }, + "sort": { + "default": "popular", + "description": "Popular orders by source-snapshot downloads in the last 30 days, with ID tie-breaks locally; ascending and descending order by Gutenberg ID.", + "enum": [ + "popular", + "ascending", + "descending" + ], + "type": "string" + }, + "topic": { + "description": "Case-insensitive phrase in a subject or bookshelf; blank means unset.", + "type": "string" + } + }, + "required": [ + "sort", + "page" + ], + "type": "object" + }, + "tool": { + "const": "gutenberg_search_books", + "description": "Tool to call for the remaining matching books.", + "type": "string" + } + }, + "required": [ + "tool", + "arguments" + ], + "type": "object" +} - added
Output schema / properties / effectiveCriteriaAdded value: +{ + "additionalProperties": false, + "description": "Normalized browse criteria, including popular sort and first page.", + "properties": { + "author_year_end": { + "description": "At least one author has a birth or death year on or before this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "author_year_start": { + "description": "At least one author has a birth or death year on or after this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "copyright": { + "description": "Any selected source copyright status: \"true\" copyrighted, \"false\" public domain in the USA, \"null\" unknown. Empty means all statuses; this is not worldwide legal clearance.", + "items": { + "enum": [ + "true", + "false", + "null" + ], + "type": "string" + }, + "type": "array" + }, + "ids": { + "description": "Restrict to these Gutenberg IDs, intersected with other filters. An empty list selects nothing; omit for unrestricted IDs.", + "items": { + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "type": "array" + }, + "languages": { + "description": "Any listed two-character ISO 639-1 language code; empty means all languages.", + "items": { + "maxLength": 2, + "minLength": 2, + "type": "string" + }, + "type": "array" + }, + "mime_type": { + "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.", + "type": "string" + }, + "page": { + "default": 1, + "description": "One-indexed page of at most 32 matches. Pages beyond the result range are errors.", + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "query": { + "description": "Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words.", + "type": "string" + }, + "sort": { + "default": "popular", + "description": "Popular orders by source-snapshot downloads in the last 30 days, with ID tie-breaks locally; ascending and descending order by Gutenberg ID.", + "enum": [ + "popular", + "ascending", + "descending" + ], + "type": "string" + }, + "topic": { + "description": "Case-insensitive phrase in a subject or bookshelf; blank means unset.", + "type": "string" + } + }, + "required": [ + "sort", + "page" + ], + "type": "object" +} - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_results`: No books match the language/topic filter combination. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one browse. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one browse. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "no_results", - "catalog_unavailable" -]New value: +[ + "catalog_unavailable" +] - added
Output schema / properties / noticeAdded value: +{ + "description": "Guidance for empty or capped results.", + "type": "string" +}
- Changed
gutenberg_search_books9 fields changed- added
Input schema / properties / copyrightAdded value: +{ + "description": "Any selected source copyright status: \"true\" copyrighted, \"false\" public domain in the USA, \"null\" unknown. Empty means all statuses; this is not worldwide legal clearance.", + "items": { + "enum": [ + "true", + "false", + "null" + ], + "type": "string" + }, + "type": "array" +} - changed
Input schema / properties / ids / descriptionPrevious value: -"Narrow results to specific Gutenberg ID numbers. Other filters still apply. Useful for batch pre-fetching known IDs; use gutenberg_get_book for single-ID lookups."New value: +"Narrow results to these Gutenberg IDs, intersected with other filters. An empty list selects nothing; omit for unrestricted IDs. Use gutenberg_get_book for full single-ID metadata." - added
Input schema / properties / mime_typeAdded value: +{ + "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.", + "type": "string" +} - changed
Input schema / properties / query / descriptionPrevious value: -"Words to match against book titles and author names (case-insensitive, space-separated). Example: \"dickens expectations\" matches Great Expectations by Charles Dickens."New value: +"Every nonblank whitespace-separated word must match title or author name as a case-insensitive literal substring. More than four words require the local mirror; live fallback rejects longer queries. Example: \"dickens expectations\" matches Great Expectations." - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "books", - "totalCount", - "page", - "hasMore" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "books", + "totalCount", + "page", + "hasMore", + "effectiveCriteria" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / effectiveCriteriaAdded value: +{ + "additionalProperties": false, + "description": "Normalized search criteria, including sort and page defaults.", + "properties": { + "author_year_end": { + "description": "At least one author has a birth or death year on or before this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "author_year_start": { + "description": "At least one author has a birth or death year on or after this year (CE positive, BCE negative).", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "copyright": { + "description": "Any selected source copyright status: \"true\" copyrighted, \"false\" public domain in the USA, \"null\" unknown. Empty means all statuses; this is not worldwide legal clearance.", + "items": { + "enum": [ + "true", + "false", + "null" + ], + "type": "string" + }, + "type": "array" + }, + "ids": { + "description": "Restrict to these Gutenberg IDs, intersected with other filters. An empty list selects nothing; omit for unrestricted IDs.", + "items": { + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "type": "array" + }, + "languages": { + "description": "Any listed two-character ISO 639-1 language code; empty means all languages.", + "items": { + "maxLength": 2, + "minLength": 2, + "type": "string" + }, + "type": "array" + }, + "mime_type": { + "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.", + "type": "string" + }, + "page": { + "default": 1, + "description": "One-indexed page of at most 32 matches. Pages beyond the result range are errors.", + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + "query": { + "description": "Every nonblank word must occur in the title or an author name, case-insensitively, as a literal substring. More than four words require the local mirror; live fallback rejects longer queries. Whitespace separates words.", + "type": "string" + }, + "sort": { + "default": "popular", + "description": "Popular orders by source-snapshot downloads in the last 30 days, with ID tie-breaks locally; ascending and descending order by Gutenberg ID.", + "enum": [ + "popular", + "ascending", + "descending" + ], + "type": "string" + }, + "topic": { + "description": "Case-insensitive phrase in a subject or bookshelf; blank means unset.", + "type": "string" + } + }, + "required": [ + "sort", + "page" + ], + "type": "object" +} - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_results`: The query matched no books in the catalog. `page_out_of_range`: The requested page number is past the last page of results for this query. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one search. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `query_requires_mirror`: More than four query words were supplied while the local mirror could not answer. `page_out_of_range`: The requested page number is past the last page of results for this query. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one search. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "no_results", - "page_out_of_range", - "catalog_unavailable" -]New value: +[ + "query_requires_mirror", + "page_out_of_range", + "catalog_unavailable" +] - added
Output schema / properties / noticeAdded value: +{ + "description": "Actionable guidance for an empty selection.", + "type": "string" +}
4 tool updates
- Changed
gutenberg_browse_popular11 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Number of books to return (1–32). Default 20 gives a useful overview without overwhelming context."New value: +"Requested number of books. Default 20; requests above 32 are capped locally at 32." - changed
Input schema / properties / limit / maximumPrevious value: -32New value: +9007199254740991 - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "books", - "totalInCatalog", - "truncated", - "shown", - "cap" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "requestedLimit", + "appliedLimit", + "books", + "totalInCatalog", + "truncated", + "shown", + "cap" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / appliedLimitAdded value: +{ + "description": "Book limit applied locally, at most 32.", + "type": "number" +} - changed
Output schema / properties / books / descriptionPrevious value: -"Top books by download count, most popular first."New value: +"Top books by downloads in the last 30 days at the source snapshot, most popular first." - changed
Output schema / properties / books / items / properties / download_count / descriptionPrevious value: -"Total downloads — the basis for the popularity ranking."New value: +"Downloads in the last 30 days at the source snapshot — the popularity ranking basis." - changed
Output schema / properties / books / items / properties / has_plain_text / descriptionPrevious value: -"True if media_type is \"Text\" AND a UTF-8 text/plain format is available via gutenberg_get_text."New value: +"True for Text records with UTF-8 plain text; HTML-only editions can still have is_readable=true." - added
Output schema / properties / books / items / properties / is_readableAdded value: +{ + "description": "True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text.", + "type": "boolean" +} - changed
Output schema / properties / books / items / requiredPrevious value: -[ - "id", - "title", - "authors", - "languages", - "download_count", - "has_plain_text" -]New value: +[ + "id", + "title", + "authors", + "languages", + "download_count", + "has_plain_text", + "is_readable" +] - added
Output schema / properties / requestedLimitAdded value: +{ + "description": "Positive integral book limit requested before capping.", + "type": "number" +} - changed
Output schema / properties / truncationCeiling / descriptionPrevious value: -"Download count of the least-popular book shown — omitted books have at most this many downloads."New value: +"Downloads in the last 30 days at the source snapshot for the least-popular book shown; omitted books have at most this count."
- Changed
gutenberg_get_book6 fields changed- changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "id", - "title", - "authors", - "translators", - "editors", - "subjects", - "bookshelves", - "languages", - "copyright", - "media_type", - "download_count", - "summary", - "summaries", - "formats", - "has_plain_text" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "id", + "title", + "authors", + "translators", + "editors", + "subjects", + "bookshelves", + "languages", + "copyright", + "media_type", + "download_count", + "source_notes", + "is_readable", + "summary", + "summaries", + "formats", + "has_plain_text" + ] + }, + { + "required": [ + "error" + ] + } +] - changed
Output schema / properties / download_count / descriptionPrevious value: -"Total downloads — popularity signal."New value: +"Downloads in the last 30 days at the source snapshot, used for popularity ranking." - changed
Output schema / properties / has_plain_text / descriptionPrevious value: -"True if media_type is \"Text\" AND a UTF-8 text/plain format (\"text/plain; charset=utf-8\") is present in formats — prerequisite for gutenberg_get_text."New value: +"True if media_type is \"Text\" and \"text/plain; charset=utf-8\" is present. HTML-only editions can still have is_readable=true." - added
Output schema / properties / is_readableAdded value: +{ + "description": "True for non-Sound records with a supported UTF-8 plain-text or HTML format for gutenberg_get_text.", + "type": "boolean" +} - changed
Output schema / properties / media_type / descriptionPrevious value: -"\"Text\" for readable books, \"Sound\" for audio books. Only \"Text\" books have plain-text content available for gutenberg_get_text."New value: +"Source media type, such as \"Text\" or \"Sound\" (audio). Use is_readable to check reader support." - added
Output schema / properties / source_notesAdded value: +{ + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "description": "Source-provided RDF bibliographic notes in document order, including explicit edition references. [] means inspected with no notes; null means unavailable from this source." +}
- Changed
gutenberg_get_text7 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Maximum number of characters to return in this chunk. Default 20,000 (~4–5 pages of prose). Increase toward 50,000 for large context windows. The actual returned length may be slightly less than limit when a natural paragraph boundary is found within 500 characters of the limit — check the length field in the response for the actual character count returned."New value: +"Requested maximum characters. Default 20,000 (~4–5 pages of prose); requests above 50,000 are capped locally at 50,000. Paragraph-boundary trimming may return less than the applied limit — use length for continuation." - changed
Input schema / properties / limit / maximumPrevious value: -50000New value: +9007199254740991 - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "id", - "title", - "text", - "offset", - "length", - "totalChars", - "remainingChars", - "hasMore", - "provenance", - "sourceFormat" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "id", + "title", + "text", + "offset", + "length", + "requestedLimit", + "appliedLimit", + "totalChars", + "remainingChars", + "hasMore", + "provenance", + "sourceFormat" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / appliedLimitAdded value: +{ + "description": "Character limit applied to this chunk, at most 50,000.", + "type": "number" +} - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg file server returned an error or did not respond within the timeout. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `text_file_not_found`: The catalog entry exists but its mirror text file returned HTTP 404. `text_fetch_rejected`: The mirror permanently rejected this text request. `invalid_text_response`: The mirror returned an empty document, HTML on a plain-text path, or recognizable server failure document. `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg mirror had a transient failure or did not respond within the request budget. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "not_found", - "audio_book", - "no_text_format", - "offset_out_of_range", - "text_fetch_failed", - "catalog_unavailable" -]New value: +[ + "text_file_not_found", + "text_fetch_rejected", + "invalid_text_response", + "not_found", + "audio_book", + "no_text_format", + "offset_out_of_range", + "text_fetch_failed", + "catalog_unavailable" +] - added
Output schema / properties / requestedLimitAdded value: +{ + "description": "Positive integral character limit requested by the caller, before capping.", + "type": "number" +}
- Changed
gutenberg_search_books5 fields changed- changed
Input schema / properties / sort / descriptionPrevious value: -"Result ordering. \"popular\" (default) sorts by download count descending. \"ascending\" and \"descending\" sort by Gutenberg ID number."New value: +"Result ordering. \"popular\" (default) sorts by downloads in the last 30 days at the source snapshot, descending. \"ascending\" and \"descending\" sort by Gutenberg ID number." - changed
Output schema / properties / books / items / properties / download_count / descriptionPrevious value: -"Total downloads from Project Gutenberg — a real popularity signal reflecting actual reader interest."New value: +"Downloads in the last 30 days at the source snapshot." - changed
Output schema / properties / books / items / properties / has_plain_text / descriptionPrevious value: -"True if the book has media_type \"Text\" AND a UTF-8 text/plain format available — prerequisite for gutenberg_get_text."New value: +"True for Text records with UTF-8 plain text; HTML-only editions can still have is_readable=true." - added
Output schema / properties / books / items / properties / is_readableAdded value: +{ + "description": "True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text.", + "type": "boolean" +} - changed
Output schema / properties / books / items / requiredPrevious value: -[ - "id", - "title", - "authors", - "languages", - "subjects", - "download_count", - "has_plain_text" -]New value: +[ + "id", + "title", + "authors", + "languages", + "subjects", + "download_count", + "has_plain_text", + "is_readable" +]
3 tool updates
- Changed
gutenberg_browse_popular4 fields changed- removed
Output schema / properties / books / items / properties / authors / items / properties / birth_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / books / items / properties / authors / items / properties / birth_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / books / items / properties / authors / items / properties / death_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / books / items / properties / authors / items / properties / death_year / typeAdded value: +[ + "number", + "null" +]
- Changed
gutenberg_get_book16 fields changed- removed
Output schema / properties / authors / items / properties / birth_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / authors / items / properties / birth_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / authors / items / properties / death_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / authors / items / properties / death_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / copyright / anyOfRemoved value: -[ - { - "type": "boolean" - }, - { - "type": "null" - } -] - added
Output schema / properties / copyright / typeAdded value: +[ + "boolean", + "null" +] - removed
Output schema / properties / editors / items / properties / birth_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / editors / items / properties / birth_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / editors / items / properties / death_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / editors / items / properties / death_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / summary / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / summary / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / translators / items / properties / birth_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / translators / items / properties / birth_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / translators / items / properties / death_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / translators / items / properties / death_year / typeAdded value: +[ + "number", + "null" +]
- Changed
gutenberg_search_books4 fields changed- removed
Output schema / properties / books / items / properties / authors / items / properties / birth_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / books / items / properties / authors / items / properties / birth_year / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / books / items / properties / authors / items / properties / death_year / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / books / items / properties / authors / items / properties / death_year / typeAdded value: +[ + "number", + "null" +]
4 tool updates
- Changed
gutenberg_browse_popular2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_results`: No books match the language/topic filter combination. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_results`: No books match the language/topic filter combination. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one browse. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "no_results" -]New value: +[ + "no_results", + "catalog_unavailable" +]
- Changed
gutenberg_get_book5 fields changed- changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "id", - "title", - "authors", - "translators", - "editors", - "subjects", - "bookshelves", - "languages", - "copyright", - "media_type", - "download_count", - "summary", - "formats", - "has_plain_text" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "id", + "title", + "authors", + "translators", + "editors", + "subjects", + "bookshelves", + "languages", + "copyright", + "media_type", + "download_count", + "summary", + "summaries", + "formats", + "has_plain_text" + ] + }, + { + "required": [ + "error" + ] + } +] - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one lookup. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "not_found" -]New value: +[ + "not_found", + "catalog_unavailable" +] - added
Output schema / properties / summariesAdded value: +{ + "description": "Every summary Gutendex holds for this work, in upstream order. Usually one; some records carry a long and a short variant. Empty when there are none.", + "items": { + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / summary / descriptionPrevious value: -"Auto-generated summary of the work, when available. Absent on many older records."New value: +"First entry of summaries — the primary auto-generated summary of the work, or null when Gutendex has none."
- Changed
gutenberg_get_text2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg file server returned an error or did not respond within the timeout. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg file server returned an error or did not respond within the timeout. `catalog_unavailable`: The catalog lookup that precedes reading a book did not answer within the time this server allows. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "not_found", - "audio_book", - "no_text_format", - "offset_out_of_range", - "text_fetch_failed" -]New value: +[ + "not_found", + "audio_book", + "no_text_format", + "offset_out_of_range", + "text_fetch_failed", + "catalog_unavailable" +]
- Changed
gutenberg_search_books2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_results`: The query matched no books in the catalog. `page_out_of_range`: The requested page number is past the last page of results for this query. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_results`: The query matched no books in the catalog. `page_out_of_range`: The requested page number is past the last page of results for this query. `catalog_unavailable`: The Project Gutenberg catalog did not answer within the time this server allows for one search. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "no_results", - "page_out_of_range" -]New value: +[ + "no_results", + "page_out_of_range", + "catalog_unavailable" +]
4 tool updates
- Changed
gutenberg_browse_popular6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "books", + "totalInCatalog", + "truncated", + "shown", + "cap" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "additionalProperties": {}, + "description": "Present when the call failed. Absent on success.", + "properties": { + "code": { + "description": "JSON-RPC error code for this failure.", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "data": { + "additionalProperties": {}, + "properties": { + "reason": { + "description": "Machine-readable failure mode. Declared by this tool: `no_results`: No books match the language/topic filter combination. Other values are possible when a failure originates below the handler.", + "examples": [ + "no_results" + ], + "type": "string" + }, + "recovery": { + "additionalProperties": {}, + "description": "Actionable next step for the caller.", + "properties": { + "hint": { + "type": "string" + } + }, + "required": [ + "hint" + ], + "type": "object" + }, + "retryable": { + "description": "Whether retrying may succeed.", + "type": "boolean" + } + }, + "type": "object" + }, + "message": { + "description": "Human-readable description of what went wrong.", + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "type": "object" +} - removed
Output schema / requiredRemoved value: -[ - "books", - "totalInCatalog", - "truncated", - "shown", - "cap" -]
- Changed
gutenberg_get_book6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "id", + "title", + "authors", + "translators", + "editors", + "subjects", + "bookshelves", + "languages", + "copyright", + "media_type", + "download_count", + "summary", + "formats", + "has_plain_text" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "additionalProperties": {}, + "description": "Present when the call failed. Absent on success.", + "properties": { + "code": { + "description": "JSON-RPC error code for this failure.", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "data": { + "additionalProperties": {}, + "properties": { + "reason": { + "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. Other values are possible when a failure originates below the handler.", + "examples": [ + "not_found" + ], + "type": "string" + }, + "recovery": { + "additionalProperties": {}, + "description": "Actionable next step for the caller.", + "properties": { + "hint": { + "type": "string" + } + }, + "required": [ + "hint" + ], + "type": "object" + }, + "retryable": { + "description": "Whether retrying may succeed.", + "type": "boolean" + } + }, + "type": "object" + }, + "message": { + "description": "Human-readable description of what went wrong.", + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "type": "object" +} - removed
Output schema / requiredRemoved value: -[ - "id", - "title", - "authors", - "translators", - "editors", - "subjects", - "bookshelves", - "languages", - "copyright", - "media_type", - "download_count", - "summary", - "formats", - "has_plain_text" -]
- Changed
gutenberg_get_text6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "id", + "title", + "text", + "offset", + "length", + "totalChars", + "remainingChars", + "hasMore", + "provenance", + "sourceFormat" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "additionalProperties": {}, + "description": "Present when the call failed. Absent on success.", + "properties": { + "code": { + "description": "JSON-RPC error code for this failure.", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "data": { + "additionalProperties": {}, + "properties": { + "reason": { + "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No book exists with the given ID. `audio_book`: The book is an audio recording (media_type \"Sound\"), not a text book — no literary plain text is available. `no_text_format`: The book has no UTF-8 plain-text or HTML edition available to read (for example an older ASCII-only entry). `offset_out_of_range`: The offset is greater than or equal to totalChars (past the end of the book). `text_fetch_failed`: The Gutenberg file server returned an error or did not respond within the timeout. Other values are possible when a failure originates below the handler.", + "examples": [ + "not_found", + "audio_book", + "no_text_format", + "offset_out_of_range", + "text_fetch_failed" + ], + "type": "string" + }, + "recovery": { + "additionalProperties": {}, + "description": "Actionable next step for the caller.", + "properties": { + "hint": { + "type": "string" + } + }, + "required": [ + "hint" + ], + "type": "object" + }, + "retryable": { + "description": "Whether retrying may succeed.", + "type": "boolean" + } + }, + "type": "object" + }, + "message": { + "description": "Human-readable description of what went wrong.", + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "type": "object" +} - removed
Output schema / requiredRemoved value: -[ - "id", - "title", - "text", - "offset", - "length", - "totalChars", - "remainingChars", - "hasMore", - "provenance", - "sourceFormat" -]
- Changed
gutenberg_search_books6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "books", + "totalCount", + "page", + "hasMore" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "additionalProperties": {}, + "description": "Present when the call failed. Absent on success.", + "properties": { + "code": { + "description": "JSON-RPC error code for this failure.", + "maximum": 9007199254740991, + "minimum": -9007199254740991, + "type": "integer" + }, + "data": { + "additionalProperties": {}, + "properties": { + "reason": { + "description": "Machine-readable failure mode. Declared by this tool: `no_results`: The query matched no books in the catalog. `page_out_of_range`: The requested page number is past the last page of results for this query. Other values are possible when a failure originates below the handler.", + "examples": [ + "no_results", + "page_out_of_range" + ], + "type": "string" + }, + "recovery": { + "additionalProperties": {}, + "description": "Actionable next step for the caller.", + "properties": { + "hint": { + "type": "string" + } + }, + "required": [ + "hint" + ], + "type": "object" + }, + "retryable": { + "description": "Whether retrying may succeed.", + "type": "boolean" + } + }, + "type": "object" + }, + "message": { + "description": "Human-readable description of what went wrong.", + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "type": "object" +} - removed
Output schema / requiredRemoved value: -[ - "books", - "totalCount", - "page", - "hasMore" -]
3 tool updates
- Changed
gutenberg_browse_popular1 field changed- changed
Output schema / properties / books / items / properties / has_plain_text / descriptionPrevious value: -"True if media_type is \"Text\" AND a text/plain format is available via gutenberg_get_text."New value: +"True if media_type is \"Text\" AND a UTF-8 text/plain format is available via gutenberg_get_text."
- Changed
gutenberg_get_book1 field changed- changed
Output schema / properties / has_plain_text / descriptionPrevious value: -"True if media_type is \"Text\" AND a text/plain format (UTF-8 or ASCII) is present in formats — prerequisite for gutenberg_get_text."New value: +"True if media_type is \"Text\" AND a UTF-8 text/plain format (\"text/plain; charset=utf-8\") is present in formats — prerequisite for gutenberg_get_text."
- Changed
gutenberg_search_books1 field changed- changed
Output schema / properties / books / items / properties / has_plain_text / descriptionPrevious value: -"True if the book has media_type \"Text\" AND a text/plain format available — prerequisite for gutenberg_get_text."New value: +"True if the book has media_type \"Text\" AND a UTF-8 text/plain format available — prerequisite for gutenberg_get_text."
4 tool updates
- First observed
gutenberg_browse_popular - First observed
gutenberg_get_book - First observed
gutenberg_get_text - First observed
gutenberg_search_books
Related MCP Connectors
Gutendex MCP — wraps Gutendex API for Project Gutenberg books (free, no auth)
MCP server for Russian books search, details, and recommendation candidates.
Free, no-key Bible MCP server — 86 translations in 32 languages, from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading books from Project Gutenberg via MCP, with tools to search books, fetch metadata and full text, and retrieve passages by fixed-size keys.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that gives AI agents access to the world's public domain library. Search, read, and navigate books and audiobooks from Project Gutenberg and LibriVox.MIT
- AlicenseNot gradedqualityDmaintenanceA well-documented MCP server that exposes a local SQLite catalog of public-domain books through tools like search, get, filter by genre, top-rated, and catalog stats.MIT
- AlicenseAqualityBmaintenanceAn MCP server for the Internet Archive that enables searching the full text of digitized books, browsing the catalogue, and reading Wayback Machine captures. No API key or configuration required.6572 npm3MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.