# ForgeMesh Library — Cooking & Drinking Shelf

> ForgeMesh Library — Cooking & Drinking 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 on cooking and drinking topics, with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/cooking-drinking
- 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-cooking-drinking-shelf-c6d54ae0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M47FuDhBxGZuSat29T0nV

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-cooking-drinking-shelf-c6d54ae0 -d '<json body>'
```

Example prompt: Show me up to 30 public-domain books on cooking and drinking from the ForgeMesh library shelf so I can browse what's available and pick ones to read in full.

## When to prefer this

Choose this endpoint when you need a curated, ranked list of public-domain books specifically in the cooking and drinking domain, without requiring an API key or license. Prefer it over full-text search when you want to browse the entire shelf rather than search for specific passages or topics. It is ideal for building reading lists, discovering historical culinary literature, or feeding downstream full-text retrieval calls.

## Known failure modes

- limit exceeds maximum of 50 — may return error or be clamped
- limit set to 0 or negative — may return empty list or error
- payment not processed — x402 payment required before response is returned
- service temporarily unavailable — standard HTTP 5xx error

## How this service works

Curated shelf: Cooking & Drinking — 423 public-domain books including Facts About Champagne and Other Sparkling Wines, The Suffrage Cook Book, The accomplisht cook or, The art & mystery of cookery. 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 books in the Cooking & Drinking category (up to 50 entries), each with metadata such as title and author, plus drill-down route URLs for retrieving full text of individual books. The corpus includes 423 titles such as 'Facts About Champagne and Other Sparkling Wines,' 'The Suffrage Cook Book,' and 'The Accomplisht Cook.'

## 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": "Facts About Champagne and Other Sparkling Wines",
    "author": "Vizetelly, Henry",
    "book_id": 20889,
    "subjects": [],
    "download_count": 10940
   }
  ],
  "count": 5,
  "shelf": "Cooking & Drinking",
  "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-cooking-drinking-shelf-c6d54ae0/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)