# ForgeMesh Library – Christmas Stories Shelf

> ForgeMesh Library – Christmas Stories 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 Christmas-themed books with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/christmas-stories
- 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-christmas-stories-shelf-0d7b249c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YbyxH4emyYcOLaccMqdt8

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-christmas-stories-shelf-0d7b249c -d '<json body>'
```

Example prompt: Can you pull up the full list of Christmas stories available in the ForgeMesh library — I want to browse all the classic public-domain holiday books they have?

## When to prefer this

Choose this endpoint when you need a curated, ranked list of public-domain Christmas or holiday-themed books with links for full-text retrieval, especially when no API key or license is required. Prefer it over generic book search APIs when you specifically want classic Christmas literature (Dickens, O. Henry, etc.) with drill-down routes ready for further reading or text extraction.

## Known failure modes

- Invalid limit value (e.g. above 50 or non-integer) may return a validation error
- Network timeout if the library index is temporarily unavailable
- Empty result set is unlikely given the curated 13-book shelf but possible if filters are applied
- x402 payment failure if USDC balance is insufficient or payment protocol handshake fails

## How this service works

Curated shelf: Christmas stories — 210 public-domain books including A Christmas Carol in Prose; Being a Ghost Story of Christmas, A Budget of Christmas Tales by Charles Dickens and Others, Patty's Success. 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 50 public-domain Christmas-themed books, including titles (e.g. A Christmas Carol in Prose, The Gift of the Magi), author information, and drill-down route URLs for full-text retrieval of each book. Results are ordered by historical popularity or relevance.

## 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": "A Christmas Carol in Prose; Being a Ghost Story of Christmas",
    "author": "Dickens, Charles",
    "book_id": 46,
    "subjects": [],
    "download_count": 14246
   }
  ],
  "count": 5,
  "shelf": "Christmas stories",
  "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/forgemesh-library-christmas-stories-shelf-0d7b249c/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)