# Great Expectations Passage Retrieval

> Great Expectations Passage Retrieval is a paid API for AI agents from library.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves the most relevant verbatim passages from Great Expectations by Charles Dickens in response to a natural-language question, with chapter and location citations.

## Facts

- Endpoint: POST https://library.forgemesh.io/ask-great-expectations
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/great-expectations-passage-retrieval-86f37e7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n-GsJ9JDsBXFOKosT0Zum

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability great-expectations-passage-retrieval-86f37e7b -d '<json body>'
```

Example prompt: Search Great Expectations for passages about Pip's secret benefactor and return up to 8 of the most relevant excerpts with their chapter citations.

## When to prefer this

Use this endpoint when you need verbatim, cited passages from Great Expectations specifically — not a summary or AI-generated answer. Ideal for literary research, essay writing, fact-checking plot details, or locating exact quotes with chapter references. Prefer this over general web search when you need authoritative, primary-source text from the novel itself.

## Known failure modes

- Question string is empty or missing — returns validation error
- Limit parameter exceeds 15 — likely capped or returns error
- Highly abstract or off-topic question yields low-relevance passages
- Payment of $0.01 USDC not fulfilled — returns 402 Payment Required
- Network timeout on retrieval backend

## How this service works

Ask a question about Great Expectations and get back the most relevant passages from the book itself, with chapter and location citations. Retrieval only — full-text search, not a generated summary or answer. No license, no API key required.

## Output

An array of verbatim passage excerpts from Great Expectations, each accompanied by chapter number and location citation within the book, ranked by relevance to the submitted question. Up to 15 passages returned (default 5).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max passages (default 5, max 15)"
  },
  "question": {
   "type": "string",
   "description": "Your question about the book, e.g. \"who is Pip's secret benefactor?\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 3,
  "title": "Great Expectations",
  "author": "Dickens, Charles",
  "method": "full-text retrieval — returns the most relevant passages from the book for your question; no summarization or generation",
  "book_id": 1400,
  "passages": [
   {
    "text": "…\"Yes, Pip, dear boy, I've made a gentleman on you! It's me wot has done it!\"…",
    "chapter": 39,
    "location": "chapter 39, passage #310"
   }
  ],
  "question": "who is Pip's secret benefactor"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/great-expectations-passage-retrieval-86f37e7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from library.forgemesh.io](https://www.zero.xyz/host/library.forgemesh.io/llms.txt)