Skip to main content
Glama

gutenberg-mcp-server

by io.github.cyanheads
OverviewDiscussionsAdmin

Server Details

MCP server for Project Gutenberg: 78,000+ public-domain ebooks with full plain-text retrieval.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over 62 days
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
cyanheads/gutenberg-mcp-server
GitHub Stars
3
Server Listing
gutenberg-mcp-server

TDQS

A4/5.0

Scored across 4 tools

Disambiguation4/5

The four tools split cleanly into discovery (browse_popular, search_books) and retrieval (get_book, get_text), and get_book vs get_text is unambiguous. However, browse_popular is essentially a popularity-ordered subset of search_books, so an agent could hesitate between them when looking for popular titles matching a query; descriptions mitigate this but don't fully eliminate it.

Naming Consistency4/5

All names share the gutenberg_ prefix and snake_case, with a clear verb_object shape (get_book, get_text, search_books). browse_popular deviates slightly by using a verb_adjective/modifier form rather than verb_noun, but the pattern remains predictable.

Tool Count5/5

Four tools is well within a healthy range and each maps to a distinct stage of the read-only book workflow: discover popular, query catalog, fetch metadata, fetch full text. No tool feels redundant or padded.

Completeness4/5

The core read-only lifecycle (find a book, inspect metadata, read its text) is fully covered, including pagination for long works and format fallbacks. Minor gaps remain: no browsing by bookshelf/topic listing, no author-centric view, and no explicit random/curated discovery beyond popularity.

Available Tools

4 tools
gutenberg_get_bookGet Gutenberg BookA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesProject 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

ParametersJSON Schema
NameRequiredDescription
idNoGutenberg ID.
errorNoPresent when the call failed. Absent on success.
titleNoBook title.
authorsNoPrimary author(s).
editorsNoEditors, if any.
formatsNoMap 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.
summaryNoFirst entry of summaries — the primary auto-generated summary of the work, or null when Gutendex has none.
subjectsNoLibrary of Congress subject headings.
copyrightNoCopyright status: false = public domain in the USA, true = under copyright, null = unknown.
languagesNoTwo-character language codes for this edition.
summariesNoEvery 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.
media_typeNoSource media type, such as "Text" or "Sound" (audio). Use is_readable to check reader support.
bookshelvesNoProject Gutenberg bookshelf categories (e.g., "Best Books Ever Listings", "Category: Classics of Literature").
is_readableNoTrue for non-Sound records with a supported UTF-8 plain-text or HTML format for gutenberg_get_text.
translatorsNoTranslators, if this is a translated work.
source_notesNoSource-provided RDF bibliographic notes in document order, including explicit edition references. [] means inspected with no notes; null means unavailable from this source.
download_countNoDownloads in the last 30 days at the source snapshot, used for popularity ranking.
has_plain_textNoTrue if media_type is "Text" and "text/plain; charset=utf-8" is present. HTML-only editions can still have is_readable=true.

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, openWorldHint and idempotentHint, so the safety profile is covered. The description adds useful context about source bibliographic notes and the formats map containing download URLs, but says nothing about error behavior, missing/deleted IDs, or rate limits that a fetch tool might need.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The verb and resource lead the description, followed by a dense but well-organized field enumeration, then a short follow-up sentence. It is efficient, though the long field list partially duplicates what the output schema already conveys.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter fetch tool with an output schema covering return values and annotations covering safety, the description supplies enough context to invoke it correctly. It is missing only the sibling-routing detail that would make the picture fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With a single parameter and 100% schema description coverage (including URL and example IDs like 1342/2600), the schema already fully documents the input. The description adds nothing beyond the schema for the id parameter, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Fetch complete metadata for a Project Gutenberg book by ID') and enumerates the returned fields, so the agent knows exactly what it retrieves. The 'by ID' scope implicitly separates it from gutenberg_search_books and gutenberg_browse_popular, but those siblings are never named as alternatives, so differentiation is left partly to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description offers workflow context ('Use is_readable before gutenberg_get_text; source_notes may identify specific editions'), which tells the agent how this tool fits a pipeline but not when to choose it over its siblings. There is no explicit when-to-use or exclusion guidance for gutenberg_get_book itself.

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 TextA
Read-onlyIdempotent
Inspect

Retrieve the plain-text content of a Project Gutenberg book, stripped of the standard license header and footer so the response contains only the literary work. For long works — novels routinely run 500KB–2MB — use offset and limit to read in chunks rather than fetching the whole book at once. 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesProject 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.
limitNoRequested 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.
offsetNoCharacter 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).

Output Schema

ParametersJSON Schema
NameRequiredDescription
idNoGutenberg book ID.
textNoThe requested chunk of literary text, stripped of Gutenberg license boilerplate. Encoding: UTF-8. Line endings: normalized to LF.
errorNoPresent when the call failed. Absent on success.
titleNoBook title, from the catalog record.
lengthNoNumber of characters in this chunk.
offsetNoCharacter offset where this chunk begins.
hasMoreNoTrue if there is more text after this chunk. When true, call again with offset = offset + length.
provenanceNoOne-line source note with Project Gutenberg ID, title, and license URL.
totalCharsNoTotal characters in the stripped literary text. Use with offset and length to determine progress and plan subsequent calls.
appliedLimitNoCharacter limit applied to this chunk, at most 50,000.
sourceFormatNoThe format that was fetched. "text/html" indicates HTML-to-text conversion was applied because no plain-text format was available.
remainingCharsNoCharacters remaining after this chunk (totalChars - offset - length). 0 means this chunk includes the end of the book.
requestedLimitNoPositive integral character limit requested by the caller, before capping.

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover the safety profile (readOnly, openWorld, idempotent), but the description adds substantial behavior beyond them: license header/footer stripping, the 500KB–2MB size reality, chunked reading, the UTF-8→HTML fallback chain, audio-book refusal with a clear error, and pagination counters (totalChars/remainingChars). This is unusually rich disclosure for a read tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tightly packed sentences with the core purpose front-loaded, followed by the chunking constraint and the format/fallback policy. Every sentence carries distinct information; nothing is redundant with the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, yet the description still surfaces totalChars/remainingChars for pagination. Combined with fallback and refusal behavior, an agent has everything needed to call this correctly without trial and error.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, and the schema already documents offset/limit mechanics in detail. The description adds the 'why' behind the parameters — that novels routinely run 500KB–2MB and should be read in chunks via offset and limit — which is strategy-level context the schema does not supply.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Retrieve the plain-text content of a Project Gutenberg book') and immediately scopes it: license header/footer are stripped, so only the literary work is returned. This cleanly distinguishes it from gutenberg_get_book (metadata) and gutenberg_search_books (discovery).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear operational context: chunk long works with offset/limit instead of fetching whole books, and notes the media fallback order (UTF-8 text, then HTML edition) plus the refusal of audio books. It does not explicitly name sibling tools or state when to prefer them (e.g. 'use gutenberg_get_book for metadata'), so it stops short of full when/when-not routing.

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 BooksA
Read-onlyIdempotent
Inspect

Search the Project Gutenberg catalog of 78,000+ books. Every query word matches a title or author substring; filter by topic, language, author lifespan, IDs, MIME prefix or copyright status. More than four query words 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idsNoNarrow 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.
pageNoPage number for paginated results (1-indexed). Each page returns up to 32 books. Use totalCount to determine total pages.
sortNoResult 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
queryNoEvery 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.
topicNoCase-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.
copyrightNoAny selected source copyright status: "true" copyrighted, "false" public domain in the USA, "null" unknown. Empty means all statuses; this is not worldwide legal clearance.
languagesNoFilter to books in any of these two-character ISO 639-1 language codes. Example: ["en"] for English, ["fr", "de"] for French or German.
mime_typeNoLiteral prefix of a format MIME key, such as "text/plain" or "text/html". Blank means unset.
author_year_endNoInclude 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.
author_year_startNoInclude 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.

Output Schema

ParametersJSON Schema
NameRequiredDescription
pageNoCurrent page number.
booksNoMatching books, ordered by the sort parameter.
errorNoPresent when the call failed. Absent on success.
noticeNoActionable guidance for an empty selection.
hasMoreNoTrue if there are additional pages of results.
totalCountNoTotal number of books matching the query across all pages.
effectiveCriteriaNoNormalized search criteria, including sort and page defaults.

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, openWorld), but the description adds genuinely non-obvious behavior: the four-word query ceiling with live-fallback rejection, that empty matches still succeed with criteria and a notice, and that 'popular' reflects 30-day downloads at the source snapshot. That is real value beyond the structured fields, though pagination/rate behavior is left to the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Information-dense and front-loaded: purpose first, then matching semantics, constraints, defaults, and return shape. Every sentence carries signal, though the return-value sentence is somewhat redundant given an output schema exists.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter, all-optional search tool with an output schema and full annotation coverage, the description supplies everything an agent needs: scope, matching semantics, the mirror constraint, empty-result behavior, sort default, and the handoff to gutenberg_get_book.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every parameter is already documented in the schema with examples and defaults. The description only summarizes the filter families (topic, language, author lifespan, IDs, MIME prefix, copyright) without adding syntax or format meaning beyond that. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Search the Project Gutenberg catalog of 78,000+ books') and quantifies scope. It explicitly distinguishes itself from the sibling gutenberg_get_book, so an agent can route between catalog search and single-book metadata without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names an alternative and its condition ('use gutenberg_get_book for full metadata') and flags an operational constraint ('More than four query words require the local mirror'). It stops short of explaining when to prefer gutenberg_browse_popular or gutenberg_get_text, so it is clear context rather than a full when/when-not map.

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.

  1. 2 tool updates
    • Changedgutenberg_browse_popular8 fields changed
      • addedInput schema / properties / copyright
        Added 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"
+}
      • addedInput schema / properties / mime_type
        Added value: +{
+  "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.",
+  "type": "string"
+}
      • changedOutput schema / anyOf
        Previous 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"
+    ]
+  }
+]
      • addedOutput schema / properties / continuation
        Added 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"
+}
      • addedOutput schema / properties / effectiveCriteria
        Added 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"
+}
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous value: -[
-  "no_results",
-  "catalog_unavailable"
-]New value: +[
+  "catalog_unavailable"
+]
      • addedOutput schema / properties / notice
        Added value: +{
+  "description": "Guidance for empty or capped results.",
+  "type": "string"
+}
    • Changedgutenberg_search_books9 fields changed
      • addedInput schema / properties / copyright
        Added 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"
+}
      • changedInput schema / properties / ids / description
        Previous 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."
      • addedInput schema / properties / mime_type
        Added value: +{
+  "description": "Literal prefix of a format MIME key, such as \"text/plain\" or \"text/html\". Blank means unset.",
+  "type": "string"
+}
      • changedInput schema / properties / query / description
        Previous 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."
      • changedOutput schema / anyOf
        Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "books",
-      "totalCount",
-      "page",
-      "hasMore"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "books",
+      "totalCount",
+      "page",
+      "hasMore",
+      "effectiveCriteria"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
      • addedOutput schema / properties / effectiveCriteria
        Added 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"
+}
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous value: -[
-  "no_results",
-  "page_out_of_range",
-  "catalog_unavailable"
-]New value: +[
+  "query_requires_mirror",
+  "page_out_of_range",
+  "catalog_unavailable"
+]
      • addedOutput schema / properties / notice
        Added value: +{
+  "description": "Actionable guidance for an empty selection.",
+  "type": "string"
+}
  2. 4 tool updates
    • Changedgutenberg_browse_popular11 fields changed
      • changedInput schema / properties / limit / description
        Previous 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."
      • changedInput schema / properties / limit / maximum
        Previous value: -32New value: +9007199254740991
      • changedOutput schema / anyOf
        Previous 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"
+    ]
+  }
+]
      • addedOutput schema / properties / appliedLimit
        Added value: +{
+  "description": "Book limit applied locally, at most 32.",
+  "type": "number"
+}
      • changedOutput schema / properties / books / description
        Previous 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."
      • changedOutput schema / properties / books / items / properties / download_count / description
        Previous 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."
      • changedOutput schema / properties / books / items / properties / has_plain_text / description
        Previous 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."
      • addedOutput schema / properties / books / items / properties / is_readable
        Added value: +{
+  "description": "True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text.",
+  "type": "boolean"
+}
      • changedOutput schema / properties / books / items / required
        Previous value: -[
-  "id",
-  "title",
-  "authors",
-  "languages",
-  "download_count",
-  "has_plain_text"
-]New value: +[
+  "id",
+  "title",
+  "authors",
+  "languages",
+  "download_count",
+  "has_plain_text",
+  "is_readable"
+]
      • addedOutput schema / properties / requestedLimit
        Added value: +{
+  "description": "Positive integral book limit requested before capping.",
+  "type": "number"
+}
      • changedOutput schema / properties / truncationCeiling / description
        Previous 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."
    • Changedgutenberg_get_book6 fields changed
      • changedOutput schema / anyOf
        Previous 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"
+    ]
+  }
+]
      • changedOutput schema / properties / download_count / description
        Previous value: -"Total downloads — popularity signal."New value: +"Downloads in the last 30 days at the source snapshot, used for popularity ranking."
      • changedOutput schema / properties / has_plain_text / description
        Previous 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."
      • addedOutput schema / properties / is_readable
        Added value: +{
+  "description": "True for non-Sound records with a supported UTF-8 plain-text or HTML format for gutenberg_get_text.",
+  "type": "boolean"
+}
      • changedOutput schema / properties / media_type / description
        Previous 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."
      • addedOutput schema / properties / source_notes
        Added 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."
+}
    • Changedgutenberg_get_text7 fields changed
      • changedInput schema / properties / limit / description
        Previous 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."
      • changedInput schema / properties / limit / maximum
        Previous value: -50000New value: +9007199254740991
      • changedOutput schema / anyOf
        Previous 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"
+    ]
+  }
+]
      • addedOutput schema / properties / appliedLimit
        Added value: +{
+  "description": "Character limit applied to this chunk, at most 50,000.",
+  "type": "number"
+}
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous 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"
+]
      • addedOutput schema / properties / requestedLimit
        Added value: +{
+  "description": "Positive integral character limit requested by the caller, before capping.",
+  "type": "number"
+}
    • Changedgutenberg_search_books5 fields changed
      • changedInput schema / properties / sort / description
        Previous 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."
      • changedOutput schema / properties / books / items / properties / download_count / description
        Previous 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."
      • changedOutput schema / properties / books / items / properties / has_plain_text / description
        Previous 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."
      • addedOutput schema / properties / books / items / properties / is_readable
        Added value: +{
+  "description": "True for non-Sound records with UTF-8 plain text or HTML supported by gutenberg_get_text.",
+  "type": "boolean"
+}
      • changedOutput schema / properties / books / items / required
        Previous 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. 3 tool updates
    • Changedgutenberg_browse_popular4 fields changed
      • removedOutput schema / properties / books / items / properties / authors / items / properties / birth_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / books / items / properties / authors / items / properties / birth_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / books / items / properties / authors / items / properties / death_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / books / items / properties / authors / items / properties / death_year / type
        Added value: +[
+  "number",
+  "null"
+]
    • Changedgutenberg_get_book16 fields changed
      • removedOutput schema / properties / authors / items / properties / birth_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / authors / items / properties / birth_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / authors / items / properties / death_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / authors / items / properties / death_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / copyright / anyOf
        Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / copyright / type
        Added value: +[
+  "boolean",
+  "null"
+]
      • removedOutput schema / properties / editors / items / properties / birth_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / editors / items / properties / birth_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / editors / items / properties / death_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / editors / items / properties / death_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / summary / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / summary / type
        Added value: +[
+  "string",
+  "null"
+]
      • removedOutput schema / properties / translators / items / properties / birth_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / translators / items / properties / birth_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / translators / items / properties / death_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / translators / items / properties / death_year / type
        Added value: +[
+  "number",
+  "null"
+]
    • Changedgutenberg_search_books4 fields changed
      • removedOutput schema / properties / books / items / properties / authors / items / properties / birth_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / books / items / properties / authors / items / properties / birth_year / type
        Added value: +[
+  "number",
+  "null"
+]
      • removedOutput schema / properties / books / items / properties / authors / items / properties / death_year / anyOf
        Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedOutput schema / properties / books / items / properties / authors / items / properties / death_year / type
        Added value: +[
+  "number",
+  "null"
+]
  4. 4 tool updates
    • Changedgutenberg_browse_popular2 fields changed
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous value: -[
-  "no_results"
-]New value: +[
+  "no_results",
+  "catalog_unavailable"
+]
    • Changedgutenberg_get_book5 fields changed
      • changedOutput schema / anyOf
        Previous 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"
+    ]
+  }
+]
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous value: -[
-  "not_found"
-]New value: +[
+  "not_found",
+  "catalog_unavailable"
+]
      • addedOutput schema / properties / summaries
        Added 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"
+}
      • changedOutput schema / properties / summary / description
        Previous 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."
    • Changedgutenberg_get_text2 fields changed
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous 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"
+]
    • Changedgutenberg_search_books2 fields changed
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous 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."
      • changedOutput schema / properties / error / properties / data / properties / reason / examples
        Previous value: -[
-  "no_results",
-  "page_out_of_range"
-]New value: +[
+  "no_results",
+  "page_out_of_range",
+  "catalog_unavailable"
+]
  5. 4 tool updates
    • Changedgutenberg_browse_popular6 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedInput schema / additionalProperties
        Added value: +false
      • changedOutput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedOutput schema / anyOf
        Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "books",
+      "totalInCatalog",
+      "truncated",
+      "shown",
+      "cap"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
      • addedOutput schema / properties / error
        Added 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"
+}
      • removedOutput schema / required
        Removed value: -[
-  "books",
-  "totalInCatalog",
-  "truncated",
-  "shown",
-  "cap"
-]
    • Changedgutenberg_get_book6 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedInput schema / additionalProperties
        Added value: +false
      • changedOutput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedOutput schema / anyOf
        Added 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"
+    ]
+  }
+]
      • addedOutput schema / properties / error
        Added 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"
+}
      • removedOutput schema / required
        Removed value: -[
-  "id",
-  "title",
-  "authors",
-  "translators",
-  "editors",
-  "subjects",
-  "bookshelves",
-  "languages",
-  "copyright",
-  "media_type",
-  "download_count",
-  "summary",
-  "formats",
-  "has_plain_text"
-]
    • Changedgutenberg_get_text6 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedInput schema / additionalProperties
        Added value: +false
      • changedOutput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedOutput schema / anyOf
        Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "id",
+      "title",
+      "text",
+      "offset",
+      "length",
+      "totalChars",
+      "remainingChars",
+      "hasMore",
+      "provenance",
+      "sourceFormat"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
      • addedOutput schema / properties / error
        Added 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"
+}
      • removedOutput schema / required
        Removed value: -[
-  "id",
-  "title",
-  "text",
-  "offset",
-  "length",
-  "totalChars",
-  "remainingChars",
-  "hasMore",
-  "provenance",
-  "sourceFormat"
-]
    • Changedgutenberg_search_books6 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedInput schema / additionalProperties
        Added value: +false
      • changedOutput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • addedOutput schema / anyOf
        Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "books",
+      "totalCount",
+      "page",
+      "hasMore"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
      • addedOutput schema / properties / error
        Added 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"
+}
      • removedOutput schema / required
        Removed value: -[
-  "books",
-  "totalCount",
-  "page",
-  "hasMore"
-]
  6. 3 tool updates
    • Changedgutenberg_browse_popular1 field changed
      • changedOutput schema / properties / books / items / properties / has_plain_text / description
        Previous 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."
    • Changedgutenberg_get_book1 field changed
      • changedOutput schema / properties / has_plain_text / description
        Previous 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."
    • Changedgutenberg_search_books1 field changed
      • changedOutput schema / properties / books / items / properties / has_plain_text / description
        Previous 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."
  7. 4 tool updates
    • First observedgutenberg_browse_popular
    • First observedgutenberg_get_book
    • First observedgutenberg_get_text
    • First observedgutenberg_search_books

Related MCP Connectors

Related MCP Servers

  • books-catalog

    cggazca
    A
    license
    Not graded
    quality
    D
    maintenance
    A 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

  • mcp-archiveorg

    smeet666
    A
    license
    A
    quality
    A
    maintenance
    An 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.
    6
    135 npm
    1
    MIT
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources