# Prepper's Paradise — Agent / LLM entrypoint

> Your post-apocalyptic library for rebuilding society.
> Agent-native digital books with free discovery and x402 USDC micropayments on Base.

Site: https://preppers-paradise.com/
Human browse (by category): https://preppers-paradise.com/
Human + agent guide: https://preppers-paradise.com/agents/
Agent guide (Markdown): https://preppers-paradise.com/agents.md
Service map: https://preppers-paradise.com/discover

## Free machine catalog (start here — never paywalled)

- Service catalog: https://preppers-paradise.com/discover
- Compact catalog by category: https://preppers-paradise.com/api/v1/catalog
- Stats: https://preppers-paradise.com/api/v1/stats
- Categories: https://preppers-paradise.com/api/v1/categories
- OpenAPI (x402scan canonical): https://preppers-paradise.com/openapi.json
- Full rich catalog JSON: https://preppers-paradise.com/library/discovery.json
- REST twin: https://preppers-paradise.com/wp-json/x402-library/v1/discovery
- Per-book: https://preppers-paradise.com/library/{book-slug}/discovery.json
- Well-known x402: https://preppers-paradise.com/.well-known/x402
- A2A agent card: https://preppers-paradise.com/.well-known/agent.json
- MCP tools: https://preppers-paradise.com/.well-known/mcp.json
- HTML library (category shelves): https://preppers-paradise.com/
- Library Markdown twin: https://preppers-paradise.com/index.md
- Optional catalog filters: ?q=&category=&limit= ; discovery: ?tag=&category=&include_chapters=0|1

## Payment protocol

- Protocol: x402 (HTTP 402 Payment Required)
- Asset: USDC on Base (eip155:8453)
- Facilitator: Coinbase CDP
- Merchant payTo: 0x3BF4F4914F78C3C2B2F2801f8EA717135B7D3BDF
- No accounts, no API keys, no subscriptions

## Recommended agent flow

1. GET https://preppers-paradise.com/discover (or /openapi.json) — free
2. GET https://preppers-paradise.com/api/v1/catalog — free compact shelf by category
3. Sample free overview /library/{slug}/ or free teaser chapter markdown_url
4. GET full_book_markdown_url or a paid chapter url → HTTP 402
5. Pay exact maxAmountRequired USDC on Base; retry with PAYMENT-SIGNATURE / X-PAYMENT
6. Prefer full_book_price_usd when you need many chapters

## Smoke tests (loss-leaders · $0.01 each)

Programming:
https://preppers-paradise.com/library/automatetheboringstuffwithpythonnew/02-what-is-programming.md

DIY:
https://preppers-paradise.com/library/carpentrymadesimple/02-knockdown-workbench.md

Expect HTTP 402 for $0.01 USDC (maxAmountRequired 10000).

## URL layout

- /library/{book}/ — FREE overview + chapter list
- /library/{book}/{chapter}/ — free teaser or paid chapter
- /library/complete/{book}/ — PAID full manuscript
- Same paths + .md — Markdown + YAML front matter for agents

## Pricing (current)

- Loss-leader sample chapters: **$0.01** USDC (programming + DIY smoke tests above)
- Other chapters: **$0.10** USDC
- Full books: **$0.99** USDC
- Free: discover, catalog APIs, discovery.json, overviews, teaser chapters, homepage, OpenAPI free ops

Live amounts are always in discovery / the HTTP 402 body (`maxAmountRequired`, USDC 6 decimals).

## Topics / browse categories

- diy-home-improvement
- programming-development
- ai-machine-learning
- electronics-embedded

See https://preppers-paradise.com/api/v1/categories and the HTML shelves on /.

## Contact / operator

Operator: Solution Engine IT
Site brand: Prepper's Paradise
Public agent docs: https://preppers-paradise.com/agents/