# library.forgemesh.io – Ask Tom Sawyer

> library.forgemesh.io – Ask Tom Sawyer 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-14).

Retrieves the most relevant verbatim passages from The Adventures of Tom Sawyer in response to a natural-language question, with chapter and location citations.

## Facts

- Endpoint: POST https://library.forgemesh.io/ask-tom-sawyer
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/library-forgemesh-io-ask-tom-sawyer-6a59baa2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OhaAO3eUvBm6XHYQvBKpY

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 library-forgemesh-io-ask-tom-sawyer-6a59baa2 -d '<json body>'
```

Example prompt: Search The Adventures of Tom Sawyer for passages about how Tom tricks his friends into painting the fence — give me up to 5 of the most relevant excerpts with their chapter locations.

## When to prefer this

Use this endpoint when you need exact verbatim passages from The Adventures of Tom Sawyer with chapter citations, rather than a generated summary or paraphrase. Prefer it over a general full-corpus search (also on library.forgemesh.io) when you know the source text is Tom Sawyer. It is ideal for citation-accurate literary research, quote extraction, and scene location — not for synthesized answers or cross-book searches.

## Known failure modes

- Question too vague to match meaningful passages — may return loosely related excerpts
- Limit exceeds maximum of 15 — likely clamped or returns an error
- Payment not provided or insufficient — endpoint requires $0.01 USDC via x402 protocol
- Question references characters or events not in Tom Sawyer — low-relevance results returned
- Network or service downtime — HTTP 5xx response

## How this service works

Ask a question about The Adventures of Tom Sawyer 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 ordered list of verbatim text passages from The Adventures of Tom Sawyer, each accompanied by chapter number and in-book location information, ranked by relevance to the question. No generated summaries or AI-composed answers — only raw book text with citations.

## 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. \"how does Tom get the fence painted?\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 3,
  "title": "The Adventures of Tom Sawyer, Complete",
  "author": "Twain, Mark, 1835-1910",
  "method": "full-text retrieval — returns the most relevant passages from the book for your question; no summarization or generation",
  "book_id": 74,
  "passages": [
   {
    "text": "…Tom said to himself that it was not such a hollow world, after all…",
    "chapter": 2,
    "location": "chapter 2, passage #20"
   }
  ],
  "question": "how does Tom get the fence painted"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/library-forgemesh-io-ask-tom-sawyer-6a59baa2/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)