# library.forgemesh.io Humor Shelf

> library.forgemesh.io Humor 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 161 public-domain humor books with drill-down routes for full-text retrieval

## Facts

- Endpoint: POST https://library.forgemesh.io/humor
- 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/library-forgemesh-io-humor-shelf-2c3df056
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FpSMtihEBWp9G576NWeOo

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-humor-shelf-2c3df056 -d '<json body>'
```

Example prompt: Can you pull up a list of classic humor books from the public domain library — give me the top 30 titles with links to read the full text?

## When to prefer this

Choose this endpoint when you need a curated, ranked list of public-domain humor and comedy books with navigation routes for full-text access. Prefer it over a general full-text search when the user wants to browse or discover humor titles rather than search for a specific passage or topic. It is especially useful for building reading lists, populating catalogs, or exploring the humor genre in public-domain literature.

## Known failure modes

- limit parameter exceeds 50 — likely returns an error or is clamped
- payment not processed (x402) — request blocked without valid USDC payment
- server unavailable — no results returned
- empty response if shelf index is temporarily unavailable

## How this service works

Curated shelf: Humor — 161 public-domain books including The Man Upstairs and Other Stories, Miss Mapp, Comic History of the United States. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of up to 161 public-domain humor books (default 20, max 50 per call), each with metadata and drill-down routes that can be used to retrieve the full text of individual titles. Titles include works like The Man Upstairs and Other Stories, Miss Mapp, and Comic History of the United States.

## 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 Man Upstairs and Other Stories",
    "author": "Wodehouse, P. G. (Pelham Grenville)",
    "book_id": 6768,
    "subjects": [],
    "download_count": 26011
   }
  ],
  "count": 5,
  "shelf": "Humor",
  "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/library-forgemesh-io-humor-shelf-2c3df056/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)