# ForgemeshLibrary PZ Shelf

> ForgemeshLibrary PZ 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 public-domain books from the PZ (Fiction in English) classification shelf, with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/pz
- 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/forgemeshlibrary-pz-shelf-43c1f98e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cLpS2Z-U923YEZP6apacy

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 forgemeshlibrary-pz-shelf-43c1f98e -d '<json body>'
```

Example prompt: Show me up to 30 classic public-domain fiction novels from the PZ shelf — things like Alice's Adventures in Wonderland or Little Women — so I can pick one to read.

## When to prefer this

Choose this endpoint when you need a curated, ranked list of public-domain fiction books in the PZ Library of Congress classification — particularly English-language novels. Prefer it over a full-text search endpoint when the user wants to browse or discover titles rather than search for specific passages. It is a good first step before drilling down into individual book full-text retrieval routes.

## Known failure modes

- Limit parameter exceeds 50 — server may cap or reject the request
- Invalid limit type (non-integer) causes a validation error
- Payment of $0.003 USDC not provided or rejected via x402 protocol — returns 402 Payment Required
- Network timeout if the ranked list computation takes too long
- Empty result if the shelf index is temporarily unavailable

## How this service works

Curated shelf: PZ — 7456 public-domain books including The Blue Castle: a novel, Alice's Adventures in Wonderland, Little Women; Or, Meg, Jo, Beth, and Amy. 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 fiction books (up to the specified limit, default 20, max 50) from the PZ shelf, including titles such as The Blue Castle, Alice's Adventures in Wonderland, and Little Women, along with drill-down routes that can be used to retrieve 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 Blue Castle: a novel",
    "author": "Montgomery, L. M. (Lucy Maud)",
    "book_id": 67979,
    "subjects": [],
    "download_count": 98187
   }
  ],
  "count": 5,
  "shelf": "PZ",
  "coverage": {
   "target": 61015,
   "indexed": 61015
  },
  "drill_down": [
   "/book-metadata",
   "/book-chapter",
   "/book-quotes",
   "/literature-search"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemeshlibrary-pz-shelf-43c1f98e/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)