# info.summary
REST discovery and commerce endpoints for PULL.md

# info.description
REST surface for public catalog discovery and canonical x402 purchase/re-download delivery. MCP transport is exposed separately at /mcp. OAuth/OIDC discovery metadata is intentionally absent in this deployment: protected flows do not use bearer tokens, wallet identity uses SIWE (EIP-4361), and payment/entitlement delivery use x402 plus receipt-bound headers.

# x-pullmd-auth-model.note
Protected flows do not use OAuth bearer tokens in this deployment. Use SIWE for wallet identity/auth and x402 plus receipt-bound headers for payment and re-download.

# x-pullmd-commerce.facilitator_discovery
Paid asset routes declare x402 Bazaar discovery metadata for facilitator-side indexing when the active facilitator supports Bazaar.

# paths./api/assets.get.description
Returns the current public markdown asset catalog. Each item advertises `purchase_endpoint` and `payment_protocol` so agents can transition directly into the canonical x402 flow.

# paths./api/assets/{id}/download.get.description
Canonical x402 endpoint for purchase and receipt-first re-download. First request typically returns 402 with PAYMENT-REQUIRED.

# paths./api/assets/{id}/download.get.responses.200.description
Markdown content returned after purchase or entitlement verification