Seven stable resource URLs expose bounded request and response contracts without a gateway session.
Website release evidence and offline tools, under one Agent402 catalog.
Three featured products live under this umbrella: a 5-USDC AI Discovery Site Audit, a 5.99-USDC printable fantasy quest-card deck, and a 5.99-USDC bulk QR campaign pack. Their separate methods, prices, and delivery formats are explicit below; four auxiliary developer resources remain available in the same catalog.
The umbrella exposes three featured contracts: POST /site-release-audit for 5.00 USDC, GET /download for 5.99 USDC, and GET /qr-campaign-pack for 5.99 USDC. Read /openapi.json and /.well-known/x402 before choosing one; four auxiliary resources remain discoverable.
Per-resource pricing is explicit in the OpenAPI contract, x402 manifest, and each unpaid 402 challenge.
Canonical machine surfaces are stable and public: /openapi.json, /.well-known/x402, and /meta.json.
Read /openapi.json for schemas, then confirm authoritative payment terms in /.well-known/x402.
Select a resource, send its documented HTTP request, handle a 402 challenge, and retry the identical request with proof.
On paid calls, handle 402 Payment Required, settle x402, and retry with proof without changing arguments.
Why Direct HTTP
Human mode is optimized for product and infra decisions. Each paid product has its own stable HTTP contract and exact Base-USDC terms.
- Seven direct resources instead of a session-oriented gateway.
- Explicit x402 billing semantics for every paid operation.
- OpenAPI and x402 v2 metadata for agents, API clients, and indexers.
- Stable URLs plus all-time settlement proof at
/metrics.
Direct Call Flow
- GET
/openapi.jsonfor direct request and response schemas. - GET
/.well-known/x402for resource URLs, prices, network, asset, and payee. - Call the selected resource with its documented method and input.
- On
402 Payment Required, complete payment and retry the identical request with proof.
curl -sS https://agent402.dev/openapi.json
curl -sS https://agent402.dev/.well-known/x402
curl -sS https://agent402.dev/health
For robust clients, cache and refresh /openapi.json and /.well-known/x402; use /metrics for independently inspectable settlement history.
Key Endpoints
Endpoint Reference
| Path | Methods | Purpose | URL |
|---|---|---|---|
/openapi.json |
GET | OpenAPI 3.1 contract for all seven direct paid resources. | https://agent402.dev/openapi.json |
/.well-known/x402 |
GET | x402 v2 resource manifest with direct URLs, methods, prices, network, and payee. | https://agent402.dev/.well-known/x402 |
/meta.json |
GET | Machine-friendly site metadata and endpoint map. | https://agent402.dev/meta.json |
/metrics |
GET | Operational and business metrics snapshot. | https://agent402.dev/metrics |
/pmf/scorecard |
GET | Weekly PMF adoption scorecard (paid usage validation). | https://agent402.dev/pmf/scorecard |
Resource Catalog
POST /task-day-plan
Deterministic dependency-safe priority ranking and day schedule for up to 50 tasks.
0.01 USDC per callPOST /x402-health
Bounded x402 GET-endpoint challenge, resource-binding, and canonical Base-USDC health snapshot.
0.01 USDC per callPOST /website-preflight
Seven-check HTTPS, TLS, and security-header preflight.
0.05 USDC per callPOST /site-release-audit
Twenty-two release checks plus AEO, GEO, and agent-discovery findings in five fixed remediation slots; copy-paste code is included only when evidence permits.
5.00 USDC per callPOST /audit-x402
Full x402 launch evidence and remediation dossier.
5.99 USDC per callGET /download
Offline quest-card mini kit download.
5.99 USDC per callGET /qr-campaign-pack
Offline QR campaign pack download.
5.99 USDC per callAgent Quickstart
This mode is concise and protocol-oriented. Use this exact order: /openapi.json -> /.well-known/x402 -> direct resource URL.
- Read method and schemas from the OpenAPI contract.
- Confirm price, network, asset, and payee from the x402 manifest.
- Call the direct resource URL.
- If 402 is returned, pay and retry the identical HTTP request.
OpenAPI 3.1: https://agent402.dev/openapi.json
x402 resource manifest: https://agent402.dev/.well-known/x402
Settlement metrics: https://agent402.dev/metrics
Health: https://agent402.dev/health
Direct HTTP Flow
# 1) Confirm the URL is eligible for the audit (free)
curl -sS -X POST https://agent402.dev/site-release-audit/eligibility -H 'content-type: application/json' -d '{"url":"https://example.com/"}'
# 2) Read product metadata and authoritative x402 payment terms
curl -sS https://agent402.dev/api/product
curl -sS https://agent402.dev/.well-known/x402
# 3) Call the audit without payment to receive its 5-USDC challenge
curl -i -X POST https://agent402.dev/site-release-audit -H 'content-type: application/json' -d '{"url":"https://example.com/"}'
# 4) Settle the exact Base-USDC terms, then retry the identical request
# with the PAYMENT-SIGNATURE header.
402 Retry Flow
If a standalone resource returns HTTP 402:
1) Read x402 payment requirements from response.
2) Pay requested amount to requested pay target.
3) Retry the same HTTP request with x402 payment proof.
Do not mutate method, URL, body, or arguments between attempt #1 and paid retry.
Connect This Page In Cursor @docs
This page is intentionally agent-readable. You can connect it directly in Cursor docs index.
In Cursor:
1) Open @docs in chat
2) Choose "Add docs"
3) Add one of these URLs:
- https://agent402.dev/
- https://agent402.dev/meta.json
- https://agent402.dev/llms.txt
Recommended primary source: https://agent402.dev/
Agent Endpoint Map
| Path | Methods | Purpose | URL |
|---|---|---|---|
/openapi.json |
GET | OpenAPI 3.1 contract for all seven direct paid resources. | https://agent402.dev/openapi.json |
/.well-known/x402 |
GET | x402 v2 resource manifest with direct URLs, methods, prices, network, and payee. | https://agent402.dev/.well-known/x402 |
/meta.json |
GET | Machine-friendly site metadata and endpoint map. | https://agent402.dev/meta.json |
/metrics |
GET | Operational and business metrics snapshot. | https://agent402.dev/metrics |
/pmf/scorecard |
GET | Weekly PMF adoption scorecard (paid usage validation). | https://agent402.dev/pmf/scorecard |
Bootstrap JSON
{
"version": "1",
"server": "agent402",
"mode": "direct-only",
"endpoints": {
"homepage": "https://agent402.dev/",
"openApi": "https://agent402.dev/openapi.json",
"x402Manifest": "https://agent402.dev/.well-known/x402",
"health": "https://agent402.dev/health",
"metrics": "https://agent402.dev/metrics",
"pmfScorecard": "https://agent402.dev/pmf/scorecard",
"meta": "https://agent402.dev/meta.json",
"llms": "https://agent402.dev/llms.txt",
"robots": "https://agent402.dev/robots.txt",
"sitemap": "https://agent402.dev/sitemap.xml",
"primaryProduct": "https://agent402.dev/api/product"
},
"primaryProduct": {
"sku": "site-release-audit",
"name": "AI Discovery Site Audit — AEO/GEO Fix Pack",
"version": "1.1",
"description": "Twenty-two served-HTML release checks plus AEO, GEO, and agent-discovery findings in five fixed remediation slots, with copy-paste code only when evidence permits.",
"price": {
"amount": "5.00",
"currency": "USDC",
"network": "Base mainnet",
"networkId": "eip155:8453"
},
"delivery": {
"method": "POST",
"url": "https://agent402.dev/site-release-audit",
"input": {
"contentType": "application/json",
"example": {
"url": "https://example.com/"
}
}
},
"eligibility": {
"price": "free",
"method": "POST",
"url": "https://agent402.dev/site-release-audit/eligibility",
"input": {
"contentType": "application/json",
"example": {
"url": "https://example.com/"
}
}
},
"discovery": {
"product": "https://agent402.dev/api/product",
"sample": "https://agent402.dev/site-release-audit/sample.json",
"methodology": "https://agent402.dev/site-release-audit/methodology.json"
},
"proof": {
"url": "https://agent402.dev/site-release-audit/proof/v1/case-study.json",
"evidenceKind": "seller-controlled deterministic case study",
"customerResult": false,
"note": "Seller-controlled proof of method and artifact shape; not a customer result."
}
},
"resources": [
{
"path": "/task-day-plan",
"methods": "POST",
"url": "https://agent402.dev/task-day-plan",
"price": "0.01 USDC",
"role": "Deterministic dependency-safe priority ranking and day schedule for up to 50 tasks."
},
{
"path": "/x402-health",
"methods": "POST",
"url": "https://agent402.dev/x402-health",
"price": "0.01 USDC",
"role": "Bounded x402 GET-endpoint challenge, resource-binding, and canonical Base-USDC health snapshot."
},
{
"path": "/website-preflight",
"methods": "POST",
"url": "https://agent402.dev/website-preflight",
"price": "0.05 USDC",
"role": "Seven-check HTTPS, TLS, and security-header preflight."
},
{
"path": "/site-release-audit",
"methods": "POST",
"url": "https://agent402.dev/site-release-audit",
"price": "5.00 USDC",
"role": "Twenty-two release checks plus AEO, GEO, and agent-discovery findings in five fixed remediation slots; copy-paste code is included only when evidence permits."
},
{
"path": "/audit-x402",
"methods": "POST",
"url": "https://agent402.dev/audit-x402",
"price": "5.99 USDC",
"role": "Full x402 launch evidence and remediation dossier."
},
{
"path": "/download",
"methods": "GET",
"url": "https://agent402.dev/download",
"price": "5.99 USDC",
"role": "Offline quest-card mini kit download."
},
{
"path": "/qr-campaign-pack",
"methods": "GET",
"url": "https://agent402.dev/qr-campaign-pack",
"price": "5.99 USDC",
"role": "Offline QR campaign pack download."
}
],
"settlement": {
"metrics": "https://agent402.dev/metrics",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xb0BbF890375B2ea1C2812887aE0331DD82eee92c"
}
}