Quotes

liveBooksReference

Citation-grade quote API with provenance and attribution checking. Curated public-domain corpus (Shakespeare, Twain, Wilde) plus full-text search across plays and novels — every quote returns work, year, speaker, and location (act/scene/chapter).

9tools
0msauth
free tier50 calls/day

Tools

random_quote

Return a random quote from the corpus, optionally filtered by author, fame, verification status, or tag. Each result includes citation: work, year, speaker, and source URL.

Parameters
NameTypeDescription
author_idoptstring—
famous_onlyoptboolean—
verified_onlyoptboolean—
tagoptstring—
▶Try it
search_quotesrequired: query

Search quotes by substring across canonical text and known popular paraphrases.

Parameters
NameTypeDescription
queryreqstring—
author_idoptstring—
limitoptnumber—
▶Try it
check_attributionrequired: text

Check whether a quote is genuinely attributed to a claimed author. Catches commonly misattributed quotes.

Parameters
NameTypeDescription
textreqstring—
claimed_authoroptstring—
▶Try it
quote_by_locationrequired: author_id, work_title

Look up quotes from a specific work and location (act/scene for plays, chapter for novels).

Parameters
NameTypeDescription
author_idreqstring—
work_titlereqstring—
actoptnumber—
sceneoptnumber—
chapteroptnumber—
▶Try it
list_authors

List authors available in the curated quote corpus with their work counts.

No parameters required.

▶Try it
list_full_text_works

List complete works available for full-text browsing (plays by act/scene, novels by chapter).

No parameters required.

▶Try it
get_scenerequired: author_id, work_slug, act, scene

Fetch a single scene from a play (e.g., Hamlet act 3, scene 1). Returns all speeches in order with speaker labels.

Parameters
NameTypeDescription
author_idreqstring—
work_slugreqstring—
actreqnumber—
scenereqnumber—
▶Try it
get_actrequired: author_id, work_slug, act

Fetch all scenes from one act of a play.

Parameters
NameTypeDescription
author_idreqstring—
work_slugreqstring—
actreqnumber—
▶Try it
get_chapterrequired: author_id, work_slug, chapter

Fetch a chapter from a novel (e.g., Huck Finn chapter 14). Returns all paragraphs in order.

Parameters
NameTypeDescription
author_idreqstring—
work_slugreqstring—
chapterreqnumber—
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/quotes/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/quotes/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"random_quote","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("random_quote", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("citation-grade quote api with provenance and attribution checking");