Guide · 2026
How to List an x402 Endpoint (Free) (2026)
By Cleared Index · Updated 2026 · 7 min read
Agents don't browse homepages. They read manifests, cleared.txt, and Gateway. If you want spend, you need to be findable and trustworthy.
Listing on Cleared is free. Preference is paid. That's the whole operator story.
Five steps
- Ship a valid
/.well-known/x402.json(V2 schema, real endpoints, honest pricing). - Submit at /submit — or wait for found-operator outreach if we indexed you first.
- Claim the listing so you can correct metadata and opt paths.
- Run Cleared Check until you PASS. Fix manifest / uptime / disclosure gaps.
- When agents already route your category, upgrade to Cleared for +12 preference, full manifest, 6h recheck.
Listed vs Cleared
| Face | Price | What you get |
|---|---|---|
| Listed | Free | Board, cleared.txt, Gateway inventory, MCP |
| Cleared | $49/mo | Attested + preferred · full manifest · 6h recheck · +12 boost |
What not to do
Don't buy fog SKUs. Don't wait for a directory to “feature” you. Don't ship a fake manifest. Agents settle USDC — honesty is the product.
List free. Get preferred when agents route.
Submit your origin. Claim when ready. Cleared $49 when you want preference — not before.
Integrate in a few lines
# 1. Manifesthttps://your-api.com/.well-known/x402.json# 2. Submithttps://clearedindex.com/submit# 3. VerifyGET https://clearedindex.com/api/cleared/check?origin=https://your-api.comFrequently Asked Questions
How do I list an x402 endpoint on Cleared?+
Serve a valid /.well-known/x402.json, then submit at clearedindex.com/submit — or we may find you via offshore discovery. Listing is free.
Do I need Cleared tier ($49) to be discoverable?+
No. Listed is free and puts you on cleared.txt, Gateway inventory, and MCP. Cleared tier adds attestation preference, full manifest indexing, and 6h recheck.
What is claim?+
Claim proves you control the origin (email / token). Claimed operators get upgrade paths and corrections. Unclaimed found listings stay public but operator tools stay locked.
Is Cleared a directory?+
No. Cleared is a trust gateway — attested inventory, pay decision, witness. Directories list. We score before agents pay.
Where do agents find my listing?+
cleared.txt, /.well-known/cleared.json, Gateway route_gateway, MCP, and the public board. Machine surfaces beat homepage SEO for agents.
Related
Sibling rail: Ape Gate Check on Entropy Index. Regime context before size — Cleared before spend.