{ "openapi": "3.1.0", "info": { "title": "Preppers Paradise x402 Library", "version": "1.4.0", "description": "98 practical DIY/electronics/programming/AI books. Free catalog + teaser chapters. Full manuscripts via x402 USDC on Base (Coinbase CDP). No accounts, no API keys. Start: GET /discover or GET /api/v1/catalog. Smoke test: $0.01 chapter.", "x-guidance": "Preppers Paradise is an agent-native digital library (98 practical books: DIY, electronics, programming, AI, self-reliance) sold via x402 micropayments in USDC on Base.\n\nAgent flow:\n1) GET /discover (free service map) or GET /openapi.json (this document).\n2) GET /api/v1/catalog (free compact catalog by category) or GET /library/discovery.json (full rich catalog).\n3) Sample free overviews at /library/{slug}/ and free teaser chapters (access=free in discovery).\n4) GET a paid *.md path → HTTP 402 with x402 requirements (body + PAYMENT-REQUIRED header).\n5) Pay exact USDC on Base to payTo, retry with payment proof header → 200 Markdown.\n\nPayment:\n- Protocol: x402 exact\n- Network: Base (eip155:8453)\n- Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\n- payTo: 0x3BF4F4914F78C3C2B2F2801f8EA717135B7D3BDF\n- Facilitator: Coinbase CDP\n- OpenAPI x-payment-info.price.amount is decimal USD; runtime accepts[].amount / maxAmountRequired is USDC atomic units (1 USDC = 1000000).\n\nThis OpenAPI is intentionally LEAN so discovery/registration probes finish quickly. It lists free catalog APIs, a $0.01 loss-leader chapter, and a few representative complete-book SKUs. For every title and chapter, use /library/discovery.json or /api/v1/catalog. Add ?full=1 to /openapi.json only if you need every complete-book path (slower probes).\n\nDocs: /agents/ /agents.md /llms.txt /discover /.well-known/x402 /.well-known/agent.json /.well-known/mcp.json", "guidance": "Preppers Paradise is an agent-native digital library (98 practical books: DIY, electronics, programming, AI, self-reliance) sold via x402 micropayments in USDC on Base.\n\nAgent flow:\n1) GET /discover (free service map) or GET /openapi.json (this document).\n2) GET /api/v1/catalog (free compact catalog by category) or GET /library/discovery.json (full rich catalog).\n3) Sample free overviews at /library/{slug}/ and free teaser chapters (access=free in discovery).\n4) GET a paid *.md path → HTTP 402 with x402 requirements (body + PAYMENT-REQUIRED header).\n5) Pay exact USDC on Base to payTo, retry with payment proof header → 200 Markdown.\n\nPayment:\n- Protocol: x402 exact\n- Network: Base (eip155:8453)\n- Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\n- payTo: 0x3BF4F4914F78C3C2B2F2801f8EA717135B7D3BDF\n- Facilitator: Coinbase CDP\n- OpenAPI x-payment-info.price.amount is decimal USD; runtime accepts[].amount / maxAmountRequired is USDC atomic units (1 USDC = 1000000).\n\nThis OpenAPI is intentionally LEAN so discovery/registration probes finish quickly. It lists free catalog APIs, a $0.01 loss-leader chapter, and a few representative complete-book SKUs. For every title and chapter, use /library/discovery.json or /api/v1/catalog. Add ?full=1 to /openapi.json only if you need every complete-book path (slower probes).\n\nDocs: /agents/ /agents.md /llms.txt /discover /.well-known/x402 /.well-known/agent.json /.well-known/mcp.json", "contact": { "name": "Preppers Paradise / Solution Engine IT", "email": "jermaine@solution-engine.com", "url": "https://preppers-paradise.com/" } }, "servers": [ { "url": "https://preppers-paradise.com", "description": "Production" } ], "tags": [ { "name": "Discovery", "description": "Free machine catalogs" }, { "name": "Free", "description": "No payment required" }, { "name": "Paid", "description": "Returns HTTP 402 until x402 payment settles" }, { "name": "CompleteBook", "description": "Full manuscript SKUs" }, { "name": "Chapter", "description": "Single chapter SKUs" }, { "name": "Guidance", "description": "Human/agent documentation" } ], "paths": { "/.well-known/agent.json": { "get": { "operationId": "getAgentCard", "summary": "A2A agent card (free)", "description": "Agent identity, skills (browse catalog, sample free content, buy chapter/book), and x402 auth metadata.", "tags": [ "Discovery", "Free", "Guidance" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "A2A-style agent card JSON" } } } } } } }, "/.well-known/mcp.json": { "get": { "operationId": "getMcpManifest", "summary": "MCP tool discovery manifest (free)", "description": "Tools for stats, categories, catalog, samples, and full-book purchase with x402 pricing metadata.", "tags": [ "Discovery", "Free", "Guidance" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "MCP tools JSON" } } } } } } }, "/agents.md": { "get": { "operationId": "getAgentGuideMarkdown", "summary": "Agent commerce guide (Markdown, free)", "description": "How agents discover, sample free content, and pay via x402. Also see GET /discover (includes price_menu) and GET /api/v1/catalog (free). Paid smoke tests: $0.01 sample chapters across categories.", "tags": [ "Guidance", "Free" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "text/markdown": { "schema": { "type": "string", "description": "Markdown guide" } } } } } } }, "/api/v1/catalog": { "get": { "operationId": "getCatalog", "summary": "Compact library catalog sorted by category (free)", "description": "Free forever. Returns books[] and by_category{} with titles, prices, free overview URLs, and paid full_book_markdown_url. Query: q (search), category (slug), limit (default 500). Richer chapter matrix: GET /library/discovery.json?include_chapters=1.", "tags": [ "Discovery", "Free" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional case-insensitive search over title/slug/tags/description" }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional category slug filter" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 500 }, "description": "Max books in books[] (1-500)" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "Compact catalog JSON" } } } } } } }, "/api/v1/categories": { "get": { "operationId": "getCategories", "summary": "List categories with book counts (free)", "description": "Each category includes a catalog deep-link: /api/v1/catalog?category={slug}.", "tags": [ "Discovery", "Free" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "Categories JSON" } } } } } } }, "/api/v1/stats": { "get": { "operationId": "getStats", "summary": "Collection statistics (free)", "description": "Total books, category counts, price_range_usd, payment block, loss_leaders, price_menu.", "tags": [ "Discovery", "Free" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "Stats JSON" } } } } } } }, "/discover": { "get": { "operationId": "getDiscover", "summary": "Service catalog (free) — endpoints, pricing, payment", "description": "JSON service map: free vs paid endpoints, price_menu, stats, payTo, loss-leaders, hero SKUs. Best first fetch for agents.", "tags": [ "Discovery", "Free" ], "security": [], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body required. Use HTTP GET with optional query parameters listed on this operation." } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "description": "Service catalog JSON" } } } } } } }, "/library/automatetheboringstuffwithpythonnew/02-what-is-programming.md": { "get": { "operationId": "getChapterMd_loss_leader_automatetheboringstuffwithpythonnew_what_is_programming", "summary": "Chapter Markdown — What Is Programming (loss-leader $0.01)", "description": "Cheapest paid chapter (programming sample) for agent onboarding and smoke tests. Example: GET /library/automatetheboringstuffwithpythonnew/02-what-is-programming.md → HTTP 402 → pay $0.01 USDC on Base → retry → Markdown. Category: programming-development. Prefer complete books for depth — free catalog: GET /api/v1/catalog.", "tags": [ "Chapter", "Paid", "Markdown", "loss-leader", "programming-development" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"book_chapter\",\"book_slug\":\"automatetheboringstuffwithpythonnew\",\"title\":\"What Is Programming\",\"price_usd\":\"0.01\",\"category\":\"programming-development\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } }, "/library/carpentrymadesimple/02-knockdown-workbench.md": { "get": { "operationId": "getChapterMd_loss_leader_carpentrymadesimple_knockdown_workbench", "summary": "Chapter Markdown — Knockdown Workbench (loss-leader $0.01)", "description": "Cheapest paid chapter (DIY sample) for agent onboarding and smoke tests. Example: GET /library/carpentrymadesimple/02-knockdown-workbench.md → HTTP 402 → pay $0.01 USDC on Base → retry → Markdown. Category: diy-home-improvement. Prefer complete books for depth — free catalog: GET /api/v1/catalog.", "tags": [ "Chapter", "Paid", "Markdown", "loss-leader", "diy-home-improvement" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"book_chapter\",\"book_slug\":\"carpentrymadesimple\",\"title\":\"Knockdown Workbench\",\"price_usd\":\"0.01\",\"category\":\"diy-home-improvement\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } }, "/library/complete/anywhereanytimesignalsandsystemslaboratorysecondedition.md": { "get": { "operationId": "getCompleteBookMd_anywhereanytimesignalsandsystemslaboratorysecondedition", "summary": "Complete book Markdown — Anywhere-Anytime Signals and Systems Laboratory", "description": "This book introduces an innovative method for conducting signals and systems laboratory experiments, shifting from traditional MATLAB-only environments to a mobile, smartphone-based platform. It guid… Full Markdown after x402 payment on Base. Free overview: /library/anywhereanytimesignalsandsystemslaboratorysecondedition/. Catalog: /api/v1/catalog. Full list: /library/discovery.json.", "tags": [ "CompleteBook", "Paid", "Markdown", "electronics-embedded" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.990000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"complete_book\",\"book_slug\":\"anywhereanytimesignalsandsystemslaboratorysecondedition\",\"title\":\"Anywhere-Anytime Signals and Systems Laboratory\",\"price_usd\":\"0.99\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } }, "/library/complete/arduinoigettingstarted.md": { "get": { "operationId": "getCompleteBookMd_arduinoigettingstarted", "summary": "Complete book Markdown — Arduino I: Getting Started", "description": "This collection offers a comprehensive guide to electronics, from fundamental concepts and circuit analysis to advanced digital system design and embedded programming. Readers will learn about electr… Full Markdown after x402 payment on Base. Free overview: /library/arduinoigettingstarted/. Catalog: /api/v1/catalog. Full list: /library/discovery.json.", "tags": [ "CompleteBook", "Paid", "Markdown", "electronics-embedded" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.990000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"complete_book\",\"book_slug\":\"arduinoigettingstarted\",\"title\":\"Arduino I: Getting Started\",\"price_usd\":\"0.99\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } }, "/library/complete/automatetheboringstuffwithpythonnew.md": { "get": { "operationId": "getCompleteBookMd_automatetheboringstuffwithpythonnew", "summary": "Complete book Markdown — Automate the Boring Stuff with Python", "description": "A practical, beginner-friendly introduction to Python focused on automating everyday computer tasks. Covers core programming basics while walking through real projects such as file and folder automat… Full Markdown after x402 payment on Base. Free overview: /library/automatetheboringstuffwithpythonnew/. Catalog: /api/v1/catalog. Full list: /library/discovery.json.", "tags": [ "CompleteBook", "Paid", "Markdown", "programming-development" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.990000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"complete_book\",\"book_slug\":\"automatetheboringstuffwithpythonnew\",\"title\":\"Automate the Boring Stuff with Python\",\"price_usd\":\"0.99\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } }, "/library/complete/carpentrymadesimple.md": { "get": { "operationId": "getCompleteBookMd_carpentrymadesimple", "summary": "Complete book Markdown — Carpentry Made Simple", "description": "This guide provides a comprehensive introduction to carpentry through 23 practical, stylish woodworking projects. Readers will progressively learn essential skills, techniques, and tool usage as they… Full Markdown after x402 payment on Base. Free overview: /library/carpentrymadesimple/. Catalog: /api/v1/catalog. Full list: /library/discovery.json.", "tags": [ "CompleteBook", "Paid", "Markdown", "diy-home-improvement" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.990000" }, "protocols": [ { "x402": {} } ] }, "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No JSON body. GET the path. On 402, complete x402 payment and retry with payment proof headers." } } } }, "responses": { "200": { "description": "Paid content after x402 settlement", "content": { "text/markdown": { "schema": { "type": "string", "description": "Paid content body (text/markdown) after successful x402 settlement." }, "example": "{\"format\":\"markdown\",\"kind\":\"complete_book\",\"book_slug\":\"carpentrymadesimple\",\"title\":\"Carpentry Made Simple\",\"price_usd\":\"0.99\"}" } } }, "402": { "description": "Payment Required — x402 challenge (see body + PAYMENT-REQUIRED header)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PaymentRequired" } } } } } } } }, "components": { "schemas": { "MarkdownDocument": { "type": "string", "description": "UTF-8 Markdown body of the purchased resource" }, "X402PaymentRequired": { "type": "object", "description": "x402 payment challenge. Prefer PAYMENT-REQUIRED response header (v2); body may also include v1 accepts.", "properties": { "x402Version": { "type": "integer", "example": 1 }, "accepts": { "type": "array", "items": { "type": "object" } }, "error": { "type": "string" } } } } }, "x-preppers-paradise": { "discovery_url": "https://preppers-paradise.com/library/discovery.json", "discover_url": "https://preppers-paradise.com/discover", "catalog_url": "https://preppers-paradise.com/api/v1/catalog", "openapi_url": "https://preppers-paradise.com/openapi.json", "openapi_full_url": "https://preppers-paradise.com/openapi.json?full=1", "well_known_x402": "https://preppers-paradise.com/.well-known/x402", "agent_entry_url": "https://preppers-paradise.com/agents/", "llms_txt_url": "https://preppers-paradise.com/llms.txt", "mode": "lean", "paid_operations_listed": 6, "total_books": 98, "note": "Default OpenAPI is lean for x402scan registration timeouts. Full book inventory is always in /api/v1/catalog and /library/discovery.json.", "pay_to": "0x3BF4F4914F78C3C2B2F2801f8EA717135B7D3BDF", "network": "base", "asset_usdc": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "loss_leader_price_usd": "0.01" } }