io.github.cyanheads/gutenberg-mcp-server
REMOTE · GUTENBERG.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3
MCP server for Project Gutenberg — 75,000+ public-domain ebooks with full plain-text retrieval.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 4 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability66
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1176 tokens (~294/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · gutenberg.caseyjhand.com
claude mcp add --transport http cyanheads-gutenberg-mcp-server https://gutenberg.caseyjhand.com/mcp
[mcp_servers.cyanheads-gutenberg-mcp-server] url = "https://gutenberg.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-gutenberg-mcp-server": {
"type": "remote",
"url": "https://gutenberg.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-gutenberg-mcp-server --url https://gutenberg.caseyjhand.com/mcp --transport streamable-http
mcp_servers:
cyanheads-gutenberg-mcp-server:
url: "https://gutenberg.caseyjhand.com/mcp" {
"mcpServers": {
"cyanheads-gutenberg-mcp-server": {
"type": "http",
"url": "https://gutenberg.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 63
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://gutenberg.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 7 Jul 2026 | 5 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | 5aad900eb2055a0b0ea55912ec19680c |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC secure
Validation of gutenberg.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| gutenberg.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://gutenberg.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://gutenberg.caseyjhand.com/mcp | HTTPS enforced | 301 | https://gutenberg.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
gutenberg_browse_popular Browse Popular Gutenberg Books ~200
Browse the most-downloaded Project Gutenberg books, ordered by popularity. Returns up to 32 titles with their Gutenberg IDs, authors, languages, and download counts. Optionally filter by language or topic. Use this as a discovery entry point — "what are the most popular classics in French?" — or as a heartbeat check that the catalog is reachable.
| Name | Type | Req | Description |
|---|---|---|---|
| languages | array | — | 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. |
| limit | integer | — | Number of books to return (1–32). Default 20 gives a useful overview without overwhelming context. |
| topic | string | — | Filter by a subject or bookshelf keyword (case-insensitive phrase match). Example: "science fiction", "adventure", "detective". Applies on top of the language filter. |
| Name | Type | Req | Description |
|---|---|---|---|
| books | array | yes | Top books by download count, most popular first. |
| cap | number | yes | The limit that was applied. |
| shown | number | yes | Number of books returned in this response. |
| totalInCatalog | number | yes | Total books matching the filter in the full catalog (useful for context — "top 20 of 60,000"). |
| truncated | boolean | yes | True when the catalog held more matches than were returned. |
| truncationCeiling | number | — | Download count of the least-popular book shown — omitted books have at most this many downloads. |
No examples provided.
gutenberg_get_book Get Gutenberg Book ~155
Fetch complete metadata for a Project Gutenberg book by ID — title, authors (with birth/death years), translators, editors, subjects, bookshelves, languages, copyright status, and the full formats map with download URLs for each available format (plain text, HTML, EPUB, cover image, etc.). Use this before gutenberg_get_text to confirm a plain-text format is available and to get the direct download URL.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | 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… |
| Name | Type | Req | Description |
|---|---|---|---|
| authors | array | yes | Primary author(s). |
| bookshelves | array | yes | Project Gutenberg bookshelf categories (e.g., "Best Books Ever Listings", "Category: Classics of Literature"). |
| copyright | — | yes | Copyright status: false = public domain in the USA, true = under copyright, null = unknown. |
| download_count | number | yes | Total downloads — popularity signal. |
| editors | array | yes | Editors, if any. |
| formats | object | yes | 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… |
| has_plain_text | boolean | yes | 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. |
| id | number | yes | Gutenberg ID. |
| languages | array | yes | Two-character language codes for this edition. |
| media_type | string | yes | "Text" for readable books, "Sound" for audio books. Only "Text" books have plain-text content available for gutenberg_get_text. |
| subjects | array | yes | Library of Congress subject headings. |
| summary | — | yes | Auto-generated summary of the work, when available. Absent on many older records. |
| title | string | yes | Book title. |
| translators | array | yes | Translators, if this is a translated work. |
No examples provided.
gutenberg_get_text Get Gutenberg Book Text ~319
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 so the caller can page through without guessing. 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 | Type | Req | Description |
|---|---|---|---|
| id | integer | 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. |
| limit | integer | — | 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 limi… |
| offset | integer | — | 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… |
| Name | Type | Req | Description |
|---|---|---|---|
| hasMore | boolean | yes | True if there is more text after this chunk. When true, call again with offset = offset + length. |
| id | number | yes | Gutenberg book ID. |
| length | number | yes | Number of characters in this chunk. |
| offset | number | yes | Character offset where this chunk begins. |
| provenance | string | yes | One-line source note with Project Gutenberg ID, title, and license URL. |
| remainingChars | number | yes | Characters remaining after this chunk (totalChars - offset - length). 0 means this chunk includes the end of the book. |
| sourceFormat | string | yes | The format that was fetched. "text/html" indicates HTML-to-text conversion was applied because no plain-text format was available. |
| text | string | yes | The requested chunk of literary text, stripped of Gutenberg license boilerplate. Encoding: UTF-8. Line endings: normalized to LF. |
| title | string | yes | Book title, from the catalog record. |
| totalChars | number | yes | Total characters in the stripped literary text. Use with offset and length to determine progress and plan subsequent calls. |
No examples provided.
gutenberg_search_books Search Gutenberg Books ~424
Search the Project Gutenberg catalog of 78,000+ public-domain books. Matches title and author name with query words; filters by topic (subject or bookshelf keyword), language, author lifespan, or a specific list of Gutenberg IDs. Results are ordered by popularity (download count) by default. Returns book ID, title, authors, languages, subjects, and download count — use gutenberg_get_book for the full formats map before fetching text.
| Name | Type | Req | Description |
|---|---|---|---|
| author_year_end | integer | — | 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. |
| author_year_start | integer | — | 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. |
| ids | array | — | 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. |
| languages | array | — | Filter to books in any of these two-character ISO 639-1 language codes. Example: ["en"] for English, ["fr", "de"] for French or German. |
| page | integer | — | Page number for paginated results (1-indexed). Each page returns up to 32 books. Use totalCount to determine total pages. |
| query | string | — | Words to match against book titles and author names (case-insensitive, space-separated). Example: "dickens expectations" matches Great Expectations by Charles Dickens. |
| sort | string | — | Result ordering. "popular" (default) sorts by download count descending. "ascending" and "descending" sort by Gutenberg ID number. |
| topic | string | — | 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 categoriza… |
| Name | Type | Req | Description |
|---|---|---|---|
| books | array | yes | Matching books, ordered by the sort parameter. |
| hasMore | boolean | yes | True if there are additional pages of results. |
| page | number | yes | Current page number. |
| totalCount | number | yes | Total number of books matching the query across all pages. |
No examples provided.