{"description":"Parallel API gateway with dual-rail machine payments: MPP/Tempo (pathUSD) + x402/Base (USDC)","wallet_setup":"npx mppx account create","refund_policy":{"notice":"All payments are final. No refunds are available once a transaction is confirmed on-chain.","details":"Payments are settled immediately via Tempo and cannot be reversed. Please verify your request parameters before submitting paid endpoints."},"payment_methods":{"mppx":{"header":"Authorization: Payment <credential>","client":"npx mppx","currency":"pathUSD on Tempo","always_active":true},"stripe_x402":{"header":"X-Payment: <base64-proof>","client":"purl","currency":"USDC on Base (mainnet)","enabled":true,"network":"eip155:8453","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}},"protocol":{"summary":"HTTP 402 Payment Required — dual-rail: mppx/Tempo (pathUSD) or x402/Base (USDC).","routing":["Authorization: Payment <credential> → verify Tempo payment","X-Payment: <base64-proof>             → verify Base USDC via CDP facilitator","No payment header                   → 402 challenge (use npx mppx or purl to pay)"],"steps_mppx":["1. Client sends request → 402 with WWW-Authenticate: Payment (challenge)","2. mppx signs challenge → Authorization: Payment <credential>","3. Server verifies → 200 + Payment-Receipt header"],"steps_x402":["1. Client sends request → 402 with x402 accepts body (USDC deposit address on Base)","2. purl signs + sends USDC on Base → X-Payment: <proof>","3. CDP facilitator verifies on-chain → 200"]},"wallet_setup_steps":[{"step":1,"action":"Create mppx account","command":"npx mppx account create"},{"step":2,"action":"Fund wallet with pathUSD (via exchange or bridge)","note":"Fund your wallet with pathUSD on Tempo."},{"step":3,"action":"Use -J for request body (not --body)","example_summary":"npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI funding 2026\",\"mode\":\"one-shot\"}'","example_fast":"npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI funding 2026\",\"mode\":\"fast\"}'"}],"endpoints":{"POST /api/search":{"price":"$0.01","body":"objective + search_queries, or query (mapped to objective). Optional mode: one-shot | fast. mppx: -J","note":"Search API (parallel-beta)"},"POST /api/extract":{"price":"$0.01/url","body":{"urls":"string[]","objective":"string?"},"note":"$0.01 per URL provided (minimum $0.01)"},"POST /api/task":{"price":"$0.30 (ultra) / $0.10 (pro)","body":"input + processor (ultra|pro), or query + processor. Poll GET /api/task/:runId","note":"Task API — ultra: $0.30, pro: $0.10"},"GET /api/task/:runId":{"price":"free"},"GET /api/wallet/balance/:address":{"price":"free","description":"Check pathUSD balance on Tempo"},"GET /api/x402/status":{"price":"free","description":"x402/Base payment rail status (enabled, network, facilitator)"}},"usage":[{"method":"POST","path":"/api/search","price":"$0.01","request_body":{"query":"string (or objective: string, search_queries: string[])","mode":"one-shot | fast (optional)"},"example_curl":"curl -X POST \"https://parallelmpp.dev/api/search\" -H \"Content-Type: application/json\" -d '{\"query\":\"AI funding 2026\"}'","example_mppx_summary":"npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI funding 2026\",\"mode\":\"one-shot\"}'","example_mppx_fast":"npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI funding 2026\",\"mode\":\"fast\"}'","example_purl":"purl https://parallelmpp.dev/api/search -X POST --json '{\"query\":\"AI funding 2026\",\"mode\":\"one-shot\"}'","note":"Without payment you get 402; npx mppx (Tempo) or purl (x402/Base) handles challenge and retry. Use mode: \"one-shot\" for comprehensive results or \"fast\" for lower latency."},{"method":"POST","path":"/api/extract","price":"$0.01/url","request_body":{"urls":"string[]","objective":"string (optional)"},"example_curl":"curl -X POST \"https://parallelmpp.dev/api/extract\" -H \"Content-Type: application/json\" -d '{\"urls\":[\"https://example.com\"]}'","example_mppx":"npx mppx https://parallelmpp.dev/api/extract --method POST -J '{\"urls\":[\"https://example.com\"]}'","example_purl":"purl https://parallelmpp.dev/api/extract -X POST --json '{\"urls\":[\"https://example.com\"]}'"},{"method":"POST","path":"/api/task","price":"$0.30 (ultra) / $0.10 (pro)","request_body":{"input":"string (or query)","processor":"ultra | pro"},"example_curl":"curl -X POST \"https://parallelmpp.dev/api/task\" -H \"Content-Type: application/json\" -d '{\"input\":\"Brief HVAC market overview USA\",\"processor\":\"ultra\"}'","example_mppx":"npx mppx https://parallelmpp.dev/api/task --method POST -J '{\"input\":\"Brief HVAC market overview USA\",\"processor\":\"ultra\"}'","example_purl":"purl https://parallelmpp.dev/api/task -X POST --json '{\"input\":\"Brief HVAC market overview USA\",\"processor\":\"ultra\"}'","note":"Returns run_id; poll GET /api/task/:runId until status === \"completed\"."},{"method":"GET","path":"/api/task/:runId","price":"free","request_body":null,"example_curl":"curl \"https://parallelmpp.dev/api/task/trun_xxxxx\"","example_mppx":null,"note":"Poll until status is \"completed\"; then response includes result."},{"method":"GET","path":"/api/wallet/balance/:address","price":"free","request_body":null,"example_curl":"curl \"https://parallelmpp.dev/api/wallet/balance/0xYourAddress\"","example_mppx":null,"note":"pathUSD balance on Tempo. Address: 0x + 40 hex chars."}],"agent_integration":{"description":"AI agents can call paid endpoints from the CLI using npx mppx (Tempo) or purl (x402/Base). Both auto-handle 402 payment challenges.","mppx_setup":["npx mppx account create"],"mppx_usage":["npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI payments 2026\",\"mode\":\"one-shot\"}'","npx mppx https://parallelmpp.dev/api/search --method POST -J '{\"query\":\"AI payments 2026\",\"mode\":\"fast\"}'","npx mppx https://parallelmpp.dev/api/extract --method POST -J '{\"urls\":[\"https://example.com\"]}'","npx mppx https://parallelmpp.dev/api/task --method POST -J '{\"input\":\"HVAC market overview\",\"processor\":\"ultra\"}'"],"purl_setup":["brew install stripe/purl/purl","purl wallet add   # creates a Base wallet"],"purl_usage":["purl https://parallelmpp.dev/api/search -X POST --json '{\"query\":\"AI payments 2026\",\"mode\":\"one-shot\"}'","purl https://parallelmpp.dev/api/extract -X POST --json '{\"urls\":[\"https://example.com\"]}'","purl https://parallelmpp.dev/api/task -X POST --json '{\"input\":\"HVAC market overview\",\"processor\":\"ultra\"}'"],"note":"npx mppx pays on Tempo via MPP; purl pays USDC on Base via x402. Both intercept 402, sign, and retry."},"docs":[{"name":"MPP Overview","url":"https://mpp.dev/overview"},{"name":"Accept one-time payments","url":"https://mpp.dev/guides/one-time-payments"},{"name":"Tempo charge","url":"https://mpp.dev/payment-methods/tempo/charge"},{"name":"mppx CLI","url":"https://mpp.dev/sdk/typescript/cli"},{"name":"x402 protocol","url":"https://x402.org"},{"name":"Stripe x402 guide","url":"https://docs.stripe.com/payments/machine/x402"},{"name":"CDP facilitator","url":"https://docs.cdp.coinbase.com/x402/quickstart-for-sellers"},{"name":"purl CLI","url":"https://github.com/stripe/purl"}]}