# ForgeMesh Library – Fantasy Shelf

> ForgeMesh Library – Fantasy Shelf is a paid API for AI agents from library.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Returns a ranked list of up to 50 curated public-domain fantasy books with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/fantasy
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-library-fantasy-shelf-eb981c9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OEcPRpLhap-K2BkKlMPQv

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 forgemesh-library-fantasy-shelf-eb981c9c -d '<json body>'
```

Example prompt: Can you show me the top 10 public-domain fantasy books available — I'm especially interested in classic titles like The Wizard of Oz or Arthurian legends?

## When to prefer this

Choose this endpoint when you need a curated, pre-ranked list of public-domain fantasy books without any authentication or licensing overhead. It is ideal for discovery and browsing use cases where the user wants classic fantasy titles (e.g. Oz, Arthurian legend) with paths to full-text retrieval, rather than searching a general-purpose book database.

## Known failure modes

- Limit parameter exceeds 50 — request may be capped or rejected
- Non-integer value for limit — schema validation error
- Network timeout or service unavailability — no results returned
- Payment not processed (x402) — access denied without valid USDC payment

## How this service works

Curated shelf: Fantasy — 8 public-domain books including The Wonderful Wizard of Oz, Le Morte d'Arthur: Volume 1, The Legends of King Arthur and His Knights. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of public-domain fantasy books (up to the requested limit, default 20, max 50), including title, author, rank, and drill-down route URLs for accessing the full text of each book.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max books to return (default 20, max 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": [
   {
    "year": null,
    "title": "The Wonderful Wizard of Oz",
    "author": "Baum, L. Frank (Lyman Frank), 1856-1919",
    "book_id": 55,
    "subjects": [],
    "download_count": 10380
   }
  ],
  "count": 5,
  "shelf": "Fantasy",
  "coverage": {
   "target": 860,
   "indexed": 860
  },
  "drill_down": [
   "/book-metadata",
   "/book-chapter",
   "/book-quotes",
   "/literature-search"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-library-fantasy-shelf-eb981c9c/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)