MCP Server

Source Library

            io.github.Embassy-of-the-Free-Mind/sourcelibrary
        

Knowledge & Documentation Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Provides searchable access to rare pre-modern texts, translations, images, book metadata, page text, canonical references, and citation-ready quotations.

get_book

Get Book

READ PIPELINE step 1 — DISCOVER. START HERE for any named work or author. Returns the book's AI-generated summary, chapter list, edition metadata, DOI, page counts, IIIF manifest, and the cover image (inline, so you and the user can see the book). LANGUAGE: `language` is what is printed on THIS EDITION's leaves, which is frequently not the language the work was written in. Where they differ the response also carries `work_language`, `text_role` (original / period-translation / modern-translation) and a `translation_note` — read them before describing a passage as the author's own words, because an edition can be a translation of a translation (de Slane's 1863 French Muqaddimah, read in English, is English←French←Arabic). Absent `work_language` means the edition is in the work's own language. Use list_editions to find an original-language witness. The summary is typically a multi-paragraph orientation covering the book's argument, structure, and significance — often answering the question without further searching. Then: get_book_text to read a chapter or page range (step 2), get_quote / get_quotes to lock specific pages with full citation apparatus (step 3). search_within_book locates passages inside this book. MULTI-WORK VOLUMES: where the scans carry running heads, contains_works lists the works the volume ACTUALLY holds with their page spans, taken from the heads the printer put on each leaf. Trust it over the title — collected-works titles routinely name works the volume does not contain, and the volume holding a work often does not name it. If contains_works is absent the scans have no heads to read; status "insufficient-heads" means it was examined and could not be decided. EDITIONS: `editions` says which languages this book can be READ in and how many pages each covers ({ en: 357 } on most books, { en: 357, es: 357 } where a localized edition exists). Pass a code as `lang` to get_quote, get_quotes, get_book_text or search_within_book to read that edition; without it you get English.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['book_id'], 'properties': {'book_id': {'type': 'string', 'description': 'The book ID'}}}

get_book_text

Read Book Text

READ PIPELINE step 2 — READ. Read a book's text. Call get_book first (step 1) for the chapter list, then come here. Preferred: use the chapter param to read one chapter at a time (includes [Page N] markers for citation). Alternatively, use from/to for explicit page ranges (e.g. from=1 to=50). When you find passages worth quoting, hand the page numbers to get_quote / get_quotes (step 3) for verbatim text + a citation link. TRUNCATION: the response always includes truncated: true/false. When truncated=true, the truncation_note field gives the exact next from/to values to call — this means content was cut short by a page-budget limit, NOT that the book ended. An AI agent MUST NOT infer end-of-book from pages_returned alone; check truncated first. Daily page budgets apply across get_book_text/get_quote/get_quotes: anonymous 500 pages/24h, signed-in 1,000, free Explorer keys 2,000, paid keys uncapped — sign in at sourcelibrary.org/auth/signin or get a key at sourcelibrary.org/developers. Corpus-scale text belongs on the dataset API (sourcelibrary.org/dataset), not on this tool.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['book_id'], 'properties': {'to': {'type': 'number', 'description': 'End page number (inclusive). Recommended chunk size: 50 pages. If the response has truncated=true, use the next from/to from truncation_note.'}, 'from': {'type': 'number', 'description': 'Start page number (inclusive). Use with to for explicit page ranges.'}, 'lang': {'type': 'string', 'description': 'ISO code of the EDITION to read, e.g. "es". Default "en". Resolved PER PAGE: a page with no text in that language comes back as English, labelled `translation_lang: "en"` (json) or `[Translation — en]` (plain), and the response carries lang_coverage. Chapter text is materialized in English only, so `chapter` with a non-English `lang` is served from the chapter\'s page range instead.'}, 'part': {'type': 'number', 'description': 'Part number (1-based) for large chapters split into multiple parts'}, 'format': {'enum': ['json', 'plain'], 'type': 'string', 'description': 'json (default, structured with per-page fields) or plain (concatenated text with page markers)'}, 'book_id': {'type': 'string', 'description': 'The book ID'}, 'chapter': {'type': 'number', 'description': 'Chapter index (0-based). Preferred over from/to — returns pre-structured chapter text with embedded [Page N] markers.'}, 'content': {'enum': ['ocr', 'translation', 'both'], 'type': 'string', 'description': 'Which text to include: ocr (original language), translation (English), or both (default)'}}}

get_locus

Find a Canonical Reference (Bekker / Stephanus)

Turn a CANONICAL CITATION into the actual leaves that carry it. Aristotle is cited by Bekker number (1094a8, 1447a) and Plato by Stephanus number (Rep. 328b) — the references scholarship has used for centuries, which survive re-typesetting and are shareable in a way a scan page never is. USE THIS FIRST whenever a passage arrives as a canonical reference rather than a page: do not try to derive the page yourself from a book's pagination, which is what produced a wrong guess before this tool existed. Bekker numbers are unique across the whole Aristotelian corpus, so the number alone is enough and it also tells you WHICH WORK you are citing. Stephanus numbers restart in each of the three 1578 volumes, so pass work ("Republic", "Timaeus") — without it the response lists the candidate dialogues instead of choosing one. Returns every witness the library holds: the Greek reference edition and, where we have one, an English translation of the same lines, each with its scan page, a reader URL and a quote_api link — so you can compare the original against a translation at one reference. Then call get_quote with the returned book_id + page for the verbatim text and a citable shortlink. LIMITS, stated plainly: a witness is only returned where the reference is PRINTED on that leaf (or, in the two root editions, where a verified constant offset brackets it) — nothing is interpolated, so an empty result means this library holds no anchored leaf there, NOT that the citation is wrong; editions_searched shows what was consulted and the range each covers. Line numbers (the "8" of 1094a8) are not resolved — you get the right leaf and read the line off it. Two works can share a page where one ends and the next begins (Bekker 184 and 1447 are both such joins), and each leaf is filed by the running head printed on it, so a reference at the very start of a work may come back under its predecessor — always read other_works_at_this_reference before concluding a passage is absent. A bare number that exists in both systems returns Aristotle and Plato leaves together; check the system field on each.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['reference'], 'properties': {'work': {'type': 'string', 'description': 'The work or dialogue, when the reference needs it (Plato always does): "Republic", "Timaeus", "Laws", "Nicomachean Ethics", "Poetics". Greek or Latin titles as printed in the editions also resolve.'}, 'system': {'type': 'string', 'description': 'Optional: "bekker" or "stephanus". Inferred from the work when omitted; do not guess it from the number, since the two ranges overlap.'}, 'reference': {'type': 'string', 'description': 'The canonical reference: "1094a8", "1094a", "1447", "328b". A leading system name is accepted ("Bekker 1094a"), as is a work name ("Rep. 328b").'}}}

get_quote

Get Quote

READ PIPELINE step 3 — CITE. Get the exact verbatim text of a single page plus its citation apparatus. ALWAYS use before putting text in quotation marks. The response headline is citation_link (the stable sourcelibrary.org/q/… shortlink) — present it to the user alongside the quote. Render as: > [exact translation text, verbatim] > — [Author], p. [N]. [citation_link] PAGE BREAKS: this corpus is paginated from physical leaves, and nearly one prose page-boundary in five has a sentence running across it — sometimes a word split by a hyphen ("…our move-" / "movements…"). A page that opens or breaks off mid-sentence still reads as complete prose and still carries a perfectly valid citation, so check the continuity field on every response BEFORE quoting: if continues_on_next or continues_from_previous is true, call again with context: true and quote the whole sentence. Quoting a fragment as though it were the author's complete thought is a misattribution even when the page number is right. NON-LATIN SCRIPTS: where the page is Greek, Hebrew, Arabic, Sanskrit, Cyrillic and so on, the response also carries romanized — the romanization of the original — so the citation can be shown in three layers: original → romanized → translation → citation_link. It is AI-generated reading apparatus, not a transcription; quote the source from original or translation, never from romanized. Absent on Latin-script pages and on non-Latin pages not yet romanized. ENGLISH ORIGINALS: where the leaf is already English there is no translation and none is needed — the response omits `translation`, sets `text_source: "ocr_original"`, and the verbatim text is `original` (with a `transcription_note`). Quote it as the source's own words, never as a translation, and expect period spelling and long-s (ſ) — it is an uncorrected transcription of the scan. `text_source` is on every response (`translation` otherwise), so branch on it rather than guessing from pages_translated, which is 0 for an English-original book by construction. TRANSLATED EDITIONS: `original` means the text printed on this leaf, which on a translated edition is the TRANSLATOR's language, not the author's. When the response carries `translation_note`, the chain is stated there — attribute the wording to the translator and do not offer the passage as evidence of what the author wrote in their own tongue. Call list_editions to find an original-language witness of the same work. For several pages of one book at once, use get_quotes.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['book_id', 'page'], 'properties': {'lang': {'type': 'string', 'description': 'ISO code of the EDITION to quote, e.g. "es". Default "en". `quote.lang` on every response says which edition was actually served — where no such edition exists the English translation comes back with lang: "en" and a lang_note, and it must not be presented as the requested edition. The citation link follows the edition served.'}, 'page': {'type': 'number', 'description': 'Page number'}, 'book_id': {'type': 'string', 'description': 'The book ID'}, 'context': {'type': 'boolean', 'description': 'Also return the full text of the previous and next pages, so a sentence spanning the page break can be read whole. Set this when continuity.continues_from_previous or continues_on_next came back true on an earlier call, or whenever you are about to quote near a page edge.'}, 'include_image': {'type': 'boolean', 'description': 'Also return the scan of the cited leaf as an inline image (display size, ≤1200px). Set this when the user would benefit from SEEING the page — an illustrated leaf, a title page, a diagram, disputed OCR — or asks to see it. The image arrives as an MCP image block you can view and the user sees rendered.'}}}

get_quotes

Get Quotes (batch)

READ PIPELINE step 3 — CITE, in batch. Get verbatim text + citation_link for SEVERAL pages of a single book in one round-trip, to assemble a multi-passage dossier. Specify either pages (an explicit array, e.g. [12, 40, 41]) or an inclusive from/to range. Max 25 pages per call. Each entry carries its own citation_link to present alongside the quote, and — on non-Latin-script pages that have one — a romanized layer to show between the original and the translation (AI apparatus, not a transcription). Every entry also carries `text_source`: `translation` normally, or `ocr_original` on a leaf that is already English, where the verbatim text is `original` and must be attributed as the source's own words rather than as a translation. One batch can mix both — a Latin volume can hold an English preface. Batch pages count toward the shared daily page budget (see get_book_text); this is a citation tool, and corpus-scale extraction belongs on the dataset API (sourcelibrary.org/dataset).

Read only Idempotent

Input schema

{'type': 'object', 'required': ['book_id'], 'properties': {'to': {'type': 'number', 'description': 'End page (inclusive) of a range. Use with from.'}, 'from': {'type': 'number', 'description': 'Start page (inclusive) of a range. Use with to.'}, 'lang': {'type': 'string', 'description': 'ISO code of the EDITION to quote, e.g. "es". Default "en". Resolved per page — one batch can mix editions, so read `quote.lang` on each entry rather than assuming the whole dossier is in one language.'}, 'pages': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Explicit list of page numbers (e.g. [12, 40, 41]). Use this OR from/to.'}, 'book_id': {'type': 'string', 'description': 'The book ID'}, 'include_image': {'type': 'boolean', 'description': 'Also return page scans as inline images (display size). The first 5 pages of the batch get inline image blocks; every entry still carries its page_image_url in the JSON.'}}}

list_books

List Books

BROWSES/FILTERS THE CATALOG by metadata (canonical author via author_id, author/title fragment via search, language, category, year range, translation recency) — no content/topic matching. PICK THIS to see WHAT EXISTS by an author or in a tradition, or to enumerate a date range. Returns books with title, author (string + canonical author_id + author_url), language, year, and translation progress. → For a relevance-ranked topic search use search_library; for passages on a theme use search_translations (exact words) or search_concept (by meaning).

Read only Idempotent

Input schema

{'type': 'object', 'properties': {'sort': {'enum': ['recent-translation', 'recent', 'title-asc', 'title-desc'], 'type': 'string'}, 'limit': {'type': 'number', 'description': 'Max results (default 100, max 200)'}, 'search': {'type': 'string', 'description': "Free-text filter matching title or author (relevance-ranked, may include title matches). For exactly one person's books use author_id instead."}, 'work_id': {'type': 'string', 'description': 'Every witness of one WORK, across editions, languages and centuries — pass the work_id from a result row or from get_book. Use this instead of a title search whenever you already hold the identifier: witnesses of one work are often titled differently in each language, so a title search finds only the subset that happens to share your wording. Unlike list_editions (which returns the whole set), this composes with language, year_from/year_to and sort.'}, 'year_to': {'type': 'number', 'description': 'Latest edition year (inclusive).'}, 'category': {'type': 'string'}, 'language': {'type': 'string'}, 'author_id': {'type': 'string', 'description': 'Canonical author slug, e.g. "jan-hus" — filters to exactly that person\'s books via the author thesaurus (variant slugs resolve to the canonical person). Every book row in results carries its author_id; the response echoes the canonicalized author.'}, 'year_from': {'type': 'number', 'description': 'Earliest edition year (inclusive). Matches only books with a known numeric year — ~60% of the library.'}, 'edition_key': {'type': 'string', 'description': 'Other digitizations of ONE printing — pass the edition_key from a result row. Only full-quality keys match on both sides, so this answers "what other scans of this exact edition do you hold?" and never merges different printings of the same title.'}, 'has_edition': {'type': 'string', 'description': 'ISO code — return only books READABLE in that language, e.g. "es". Different from `language`, which is the language printed on the leaves of the scan: a Latin book with a Spanish edition matches language="Latin" AND has_edition="es". Each result then also carries url_localized.'}}}

list_editions

List Editions of a Work

Every edition of one work that the library holds — the other witnesses to the same text, across languages and centuries. Give it a book_id (easiest: the id of any edition you already found) or a work_id. USE THIS when a quotation needs checking against more than one witness, when you want the original-language text behind a translation, or when comparing how a passage reads across editions — differences between witnesses are often the finding. Returns language, date, page count and translation coverage per edition, so you can pick the right one to read. Note: for multi-volume collected works the identifier names the SET rather than a single text, and the response says so explicitly when that applies.

Read only Idempotent

Input schema

{'type': 'object', 'properties': {'book_id': {'type': 'string', 'description': 'Any edition you already have. Its work is looked up and the siblings returned.'}, 'work_id': {'type': 'string', 'description': 'A work identifier, if you already have one (from get_book).'}}}

propose_collection

Propose a Collection

Propose a themed collection of books to the Source Library team — a title, a rationale (why these books belong together and what thread connects them), and an ordered list of book ids. Get book ids from search_library / list_books / get_book. Like submit_feedback and share_findings, this goes to the team for REVIEW — it does NOT create a public collection instantly; a curator reviews and approves it. Use this when the user has identified a coherent set of books worth grouping and wants to contribute that curation back.

Input schema

{'type': 'object', 'required': ['title', 'rationale', 'book_ids'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Title of the proposed collection (2-200 chars)'}, 'book_ids': {'type': 'array', 'items': {'type': 'string', 'description': 'A book id'}, 'description': 'Ordered list of book ids to include (1-200). Get ids from search_library / list_books / get_book.'}, 'rationale': {'type': 'string', 'description': 'Why these books belong together and what connects them (max 5000 chars)'}, 'suggested_slug': {'type': 'string', 'description': 'Optional URL slug suggestion, e.g. "renaissance-astronomy"'}}}

search_concept

Search by Concept

RETURNS QUOTABLE PASSAGES matched by MEANING (cosine similarity on Gemini embeddings, 768d) — paraphrases and adjacent phrasings match even with zero keyword overlap. PICK THIS when the modern term won't literally appear in historical texts — e.g. "distributed cognition" maps to passages about active intellect, art of memory, wax tablet metaphors; "social contract" maps to pre-Hobbesian discussions of consent and authority. → For exact words/distinctive terms use search_translations (cheaper, more precise); to list which BOOKS cover a topic use search_library; if the user named an author/work, get_book first (semantic search is expensive — reserve it for cross-corpus discovery). Similarity calibration: 0.70+ is a strong match, 0.55–0.70 is worth reading but verify, below 0.55 is mostly conceptual drift. Set max_per_book to diversify results across many books rather than cluster on one source. Each passage carries a snippet_type — quote only "translation" snippets, never "summary". Cross-cultural tip: for pre-modern or non-Western topics, also try source-tradition vocabulary — e.g. for seminal economy try "jing preservation" or "bindu yoga" or "istimnāʾ"; for masturbation try "mollities" (Latin) or "hastamaithuna" (Sanskrit) or "shouyin" (Chinese). The corpus is indexed via period translations that use tradition-internal terminology, so adjacent/euphemistic terms often surface material that modern English keywords miss.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['query'], 'properties': {'lang': {'type': 'string', 'description': 'ISO code of the EDITION to read, e.g. "es". Default "en". Most books have only English — call get_book and read `editions`, or list_books with has_edition, to find the ones that do not. The response always states which edition it served.'}, 'limit': {'type': 'number', 'description': 'Max passages (default 15, max 50)'}, 'query': {'type': 'string', 'description': 'A concept or natural-language description — full sentences are fine (e.g. "tools that extend the mind beyond the body"). Unlike search_translations, this does NOT require words that appear in the corpus.'}, 'year_to': {'type': 'number', 'description': 'Restrict to books published in or before this year.'}, 'language': {'type': 'string', 'description': 'Filter by a single original language'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter to any of these languages, e.g. ["Sanskrit", "Arabic", "Chinese"]. Use instead of language when targeting multiple traditions.'}, 'year_from': {'type': 'number', 'description': 'Restrict to books published in or after this year (filters out modern editions and translations).'}, 'max_per_book': {'type': 'number', 'description': 'Cap on passages from any single book. Useful when one book dominates the conceptual neighborhood; set to 1–2 for diverse author/work coverage.'}, 'exclude_languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exclude these languages, e.g. ["Latin", "French", "German", "English"] to surface non-Western sources.'}}}

search_images

Search Images

Search 200,000+ historical illustrations, emblems, engravings, diagrams, AND 24,000+ artworks (paintings, prints, sculptures). Filter by type, subject, figure, symbol, year. Results interleave two collections: illustrations extracted from book pages (each with a page number and book link) and standalone museum artworks (type: "artwork"). The first few results also return as inline images YOU can see. Hosts that support MCP Apps render an in-chat image gallery for this tool automatically; on other clients images may sit inside the collapsed tool-result view, so never tell the user images are "rendered above" unless the gallery appeared — describe what you see and give each image's url link instead. Every image_url is public and stable — an HTML page that references them directly works in any online browser. If images.length is 0, read the note field — an empty result under a book_id filter means that book has no EXTRACTED images yet, not that the physical book has no plates. A broad query can match tens of thousands (read total): narrow with type/subject/symbol or page with offset instead of raising limit. On museum-artwork results, a title_is_descriptive flag means the title is an AI description of the picture rather than a title the work was published under — cite such a record by its source_record_title, never by the descriptive one (#4288).

Read only Idempotent

Input schema

{'type': 'object', 'properties': {'type': {'type': 'string', 'description': 'Image type (woodcut, engraving, emblem, diagram). Best-effort: the medium metadata on museum artworks is unnormalized, so treat results as ranked rather than strictly filtered.'}, 'limit': {'type': 'number', 'description': 'Max results (default 20, max 50)'}, 'query': {'type': 'string', 'description': 'Text search (e.g., "ouroboros", "tree of life")'}, 'figure': {'type': 'string'}, 'offset': {'type': 'number', 'description': 'Skip this many book-illustration results — page through a large result set instead of raising limit. The response echoes offset and returns next_offset while more remain. Offsets > 0 return the gallery lane only (the museum-artwork lane has no pagination and is included only on the first page).'}, 'symbol': {'type': 'string'}, 'book_id': {'type': 'string', 'description': "Only return images extracted from this book's pages. Excludes the museum-artwork collection (artworks do not belong to books)."}, 'subject': {'type': 'string'}, 'year_to': {'type': 'number', 'description': 'See year_from — same reliability caution applies.'}, 'year_from': {'type': 'number', 'description': 'CAUTION: reliable only for book illustrations (source_type "book_illustration"). On museum-artwork records the year field is dirty — some 17th-century works carry ingest years like 2014, and null years bypass the range check entirely — so never draw a chronological conclusion from a year-filtered artwork result (#4288 tracks the cleanup).'}, 'include_thumbnail_base64': {'type': 'boolean', 'description': "Embed each result's image as a thumbnail_data_uri (data:image/jpeg;base64,…, ~1000px) directly in the JSON. ONLY useful when your harness consumes tool results programmatically (API/SDK agents that can save the bytes without retyping them) — as a chat assistant you CANNOT copy hundreds of KB of base64 into a file, so do not request this for that purpose. To build a self-contained page from chat instead: fetch the public image_url values with your execution sandbox (if egress is blocked, ask the user to allowlist images.sourcelibrary.org in their network settings), or reference the CDN URLs directly — they are public and stable, so the page works in any online browser. First 6 results only; inline image blocks are suppressed in this mode to keep the payload bounded."}}}

search_library

Search Library

RETURNS A LIST OF BOOKS (works on a topic) — NOT passages. PICK THIS to discover which works exist on a subject. → For quotable text use search_translations (exact words) or search_concept (by meaning); if the user already named an author/work, call get_book directly (or list_books to find the ID) — the AI summary + chapter outline is usually the right first answer. Searches titles, authors, subjects, and (as a secondary signal) translated text. Query tips: single distinctive words or short phrases work best ("memory palace", "ouroboros"); quoted phrases match exactly. Each result includes total_matches (full count) + returned (this page) + offset for pagination.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['query'], 'properties': {'sort': {'enum': ['relevance', 'date_asc', 'date_desc', 'title'], 'type': 'string'}, 'limit': {'type': 'number', 'description': 'Max results per page (default 10, max 100)'}, 'query': {'type': 'string', 'description': 'Search query — prefer single distinctive concepts ("alchemy", "tree of life") over long natural-language phrases. Wrap in "double quotes" for exact phrase.'}, 'offset': {'type': 'number', 'description': 'Pagination offset (use with limit to page through total_matches; default 0)'}, 'year_to': {'type': 'number', 'description': 'Publication year range end'}, 'language': {'type': 'string', 'description': 'Filter by original language (e.g., Latin, German, Greek)'}, 'year_from': {'type': 'number', 'description': 'Publication year range start'}, 'has_translation': {'type': 'boolean', 'description': 'Only return books with translations'}}}

search_translations

Search Translations

RETURNS QUOTABLE PASSAGES (page-level snippets + citation URLs), matched by KEYWORD/term. PICK THIS to find a quote or textual evidence on a topic across the whole library. → If the modern word won't literally appear in historical texts, use search_concept (matches by meaning); to list which BOOKS cover a topic use search_library; to dig inside one known book use search_within_book; if the user named an author/work, get_book first (its AI summary is usually the right first read). Query tips: single distinctive terms ("memory palace", "wax tablet") work best; multi-word natural-English queries ("unity of the intellect") may return fewer results because matching is term-based, not phrase-based. Each snippet has a snippet_type — "translation"/"ocr" means it is a verbatim extract from the source text; "summary" means it is AI-generated description (do not quote those as the author's words). Response includes total_matches, returned, and offset for pagination. Cross-cultural tip: for pre-modern or non-Western topics, search source-tradition vocabulary rather than modern English terms — e.g. for seminal economy search "jing" or "bindu" or "istimnāʾ", not "semen retention"; for female homoeroticism search "tribade" or "sahq", not "lesbian". The corpus is indexed via period translations that use tradition-internal terminology.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['query'], 'properties': {'lang': {'type': 'string', 'description': 'ISO code of the EDITION to read, e.g. "es". Default "en". Most books have only English — call get_book and read `editions`, or list_books with has_edition, to find the ones that do not. The response always states which edition it served.'}, 'limit': {'type': 'number', 'description': 'Max results per page (default 20, max 50)'}, 'query': {'type': 'string', 'description': 'Search term — prefer single distinctive concepts ("harmony of the spheres", "active intellect") over long natural-language phrases. Multi-word queries match all terms (not phrase); wrap in "double quotes" for exact phrase.'}, 'offset': {'type': 'number', 'description': 'Pagination offset (use with limit to page through total_matches; default 0)'}, 'book_id': {'type': 'string', 'description': 'Search within a specific book'}, 'year_to': {'type': 'number'}, 'language': {'type': 'string', 'description': 'Filter by a single original language'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter to any of these languages, e.g. ["Sanskrit", "Arabic", "Chinese"]. Use instead of language when targeting multiple traditions.'}, 'year_from': {'type': 'number'}, 'exclude_languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exclude these languages, e.g. ["Latin", "French", "German", "English"] to surface non-Western sources.'}}}

search_within_book

Search Within Book

SEARCHES INSIDE ONE BOOK (requires book_id). PRIMARILY KEYWORD: it runs a lexical search over the book's pages plus a narrow scoped-semantic pass (top ~10), interleaved by relevance. PICK THIS when you know the wording you are looking for, or want every page of one book mentioning a term. → IF YOU ARE SEARCHING FROM A PARAPHRASE, a half-remembered line, or a modern restatement, USE search_concept INSTEAD — it is the meaning-matching tool and it searches the whole corpus, including translations whose vocabulary differs completely from yours (Thomas Taylor writes "energies" for energeia and "felicity" for eudaimonia, so a sensible modern paraphrase can miss his pages entirely while matching semantically). → To find the book first, use search_library or search_concept, then pass its book_id here. Each result carries score (0-1, normalised within this book) and found_by ("keyword", "semantic", or "both" — both is the strongest signal). Results flagged is_front_matter are the translator's or publisher's words rather than the author's, and are ordered last. Returns OCR and translation snippets with page numbers, ready to cite.

Read only Idempotent

Input schema

{'type': 'object', 'required': ['book_id', 'query'], 'properties': {'lang': {'type': 'string', 'description': 'ISO code of the EDITION to read, e.g. "es". Default "en". Most books have only English — call get_book and read `editions`, or list_books with has_edition, to find the ones that do not. The response always states which edition it served.'}, 'query': {'type': 'string', 'description': 'Search query'}, 'book_id': {'type': 'string', 'description': 'The book ID to search within'}}}

share_findings

Share Findings

Share a research dossier back to the Source Library team — a title, an optional summary, and an ordered list of citations (the passages your thesis rests on). Each citation is a reference { book_id, page, note }, NOT copied text: the library re-renders the canonical quote from the reference, so links stay authoritative. Use this when the user has assembled a thesis backed by passages across one or more books and wants to contribute it back. Like submit_feedback, this goes to the team for review (not an instant public page).

Input schema

{'type': 'object', 'required': ['title', 'citations'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Title of the dossier / thesis (2-300 chars)'}, 'summary': {'type': 'string', 'description': 'Optional prose summarizing the argument (max 5000 chars)'}, 'citations': {'type': 'array', 'items': {'type': 'object', 'required': ['book_id', 'page'], 'properties': {'note': {'type': 'string', 'description': 'Optional note on why this passage matters'}, 'page': {'type': 'number', 'description': 'Page number'}, 'book_id': {'type': 'string', 'description': 'The book ID'}}}, 'description': 'Ordered list of supporting passages (1-50). Get book_id + page from get_quote / search_translations.'}}}

submit_feedback

Submit Feedback

Submit feedback, bug reports, or feature requests to the Source Library team. Before proposing NEW functionality, read https://sourcelibrary.org/llms.txt and https://sourcelibrary.org/developers — several past submissions proposed building things that already exist (IIIF manifests, Content Search, DTS), which wastes reviewer time. State in the report which docs you checked. Bug reports with record IDs and reproducing queries are the most actionable kind.

Input schema

{'type': 'object', 'required': ['message'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'message': {'type': 'string', 'description': 'Your feedback (2-20000 chars). Long structured reports are welcome — the limit was raised from 5,000 because agent reports were pressing against it and being split across submissions.'}}}

Changed

                            search_images
                        

Sept. 25, 2026, 2:51 a.m.

Added

                            get_locus
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            propose_collection
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            share_findings
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            submit_feedback
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            search_images
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            get_quotes
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            list_editions
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            get_quote
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            get_book_text
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            get_book
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            list_books
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            search_within_book
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            search_concept
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            search_translations
                        

Sept. 17, 2026, 12:41 p.m.

Added

                            search_library
                        

Sept. 17, 2026, 12:41 p.m.

Server details

Version

4.3.4

Transport

Streamable HTTP

Tools

Latency

2094 ms

Last scan

Oct. 1, 2026, 2:45 a.m.

First seen

Sept. 13, 2026, 2:14 a.m.

Endpoint

https://sourcelibrary.org/api/mcp

Recent scans

Success

Oct. 1, 2026, 2:45 a.m.

Success

Sept. 29, 2026, 2:52 a.m.

Success

Sept. 27, 2026, 2:44 a.m.

Success

Sept. 25, 2026, 2:51 a.m.

Success

Sept. 23, 2026, 2:43 a.m.

Success

Sept. 21, 2026, 2:50 a.m.

Success

Sept. 19, 2026, 2:41 a.m.

Success

Sept. 17, 2026, 12:41 p.m.

Source Library

What this MCP does

Tools

Recent tool changes

Similar MCP servers

concordance

canton-ccpedia

BNM Data Shop

api-evangelist

OpenHelvetia Gateway

website-search

The Ainglish Project

Torah Library