An autonomous agent can buy a BotVisibility report on its own — discover the price, pay in USDC on Solana, and pull the result back as JSON. No sign-up, no API key, no credit card, no human in the loop. It runs on x402 (the open HTTP 402 Payment Required protocol), settled through the self-hosted pay.sh gateway on Solana mainnet.
The agent's wallet only needs a stablecoin (USDC) — network fees are covered server-side, so it doesn't need any SOL.
Three tiers, one URL each
GET https://botvisibility.com/api/scan?url=…&format=jsonLevels 1–4 report (48 web checks). Free up to a daily allowance per caller, then returns 402 to the gateway below.
POST https://botvisibility-pay-gateway.fly.dev/api/v1/scan-basicThe same Levels 1–4 report, unlimited and pay-per-scan — where the free-tier overage lands.
POST https://botvisibility-pay-gateway.fly.dev/api/v1/scan-gatewayAll 55 checks including the Level-5 Agent-Native probes, plus prioritized remediation.
Request, pay, deliver
- 01RequestYour agent POSTs a URL to the gateway. With no payment attached, it answers HTTP 402 with the x402 requirements: pay this many USDC on Solana, to this address.
- 02PayThe agent's wallet signs a USDC payment for the quoted amount and retries the same request with the payment proof attached. No account, no API key, no human.
- 03DeliverThe gateway verifies the payment on-chain, then returns the full scored report as JSON. One round trip from the agent’s point of view.
From zero with the pay CLI
The fastest way to be a paying agent is the pay CLI — it is a ready-made x402 client. Install it from pay.sh, then:
# 1. Create a wallet (one time)
pay setup
# 2. Fund it with a little USDC — no SOL needed, fees are covered server-side
pay topup
# 3. Buy a deep report — pay resolves the 402 and pays automatically
pay curl -X POST \
https://botvisibility-pay-gateway.fly.dev/api/v1/scan-gateway \
-d '{"url":"https://stripe.com"}'The gateway answers 402, pay signs the USDC payment, retries with the proof, and the report prints to stdout. That's the entire purchase — one command.
Connect an MCP client to https://botvisibility.com/api/mcp and call the deep_scan tool — it returns the gateway endpoint and x402 payment instructions for your agent to settle.
Point any x402 / MPP-capable client at the endpoint. It reads the 402 challenge, signs the USDC payment on Solana, and retries — the same flow, your own runtime.
POST the URL; read the 402 + WWW-Authenticate: Payment challenge (amount, USDC mint, recipient); build + sign the Solana payment; retry with the proof header.
A scored JSON report
The response is the full report: per-level pass/fail counts across all five levels, every check with its status and a recommendation, and a top-10 next_actions list with effort estimates. The deep tier adds the Level-5 Agent-Native checks (intent endpoints, agent sessions, scoped tokens, native tool schemas) that the free scan never returns.
{
"url": "https://stripe.com/",
"tier": 4,
"levels": [ { "level": {…}, "passed": 12, "failed": 3, "total": 15 }, … ],
"checks": [ { "id": "1.1", "name": "llms.txt", "status": "pass", … }, … ],
"next_actions": [ { "check_id": "1.2", "summary": "Publish agent-card.json", "effort": "30m" }, … ]
}See the pricing at a glance, how x402 fits inside a request, or the machine-readable OpenAPI spec. Humans can always scan free in the browser — agents pay per scan and get the same report as JSON.