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=jsonAll 58 checks across 5 levels — five scans a day per caller to evaluate. Returns 402 with the payment requirements when the allowance is reached.
POST https://pay.botvisibility.com/api/v1/scan-gatewayThe same 58-check scan, pay-per-scan at $0.10 USDC — for agents that need volume with no daily cap. No sign-up, no API key; payment proves identity.
POST https://pay.botvisibility.com/api/v1/answer-gatewayThe Answer Gateway: a grounded, excerpt-verified answer from any site, pay-per-answer at $0.01 USDC. Only `answered` bills — a question the source can’t answer costs nothing. Prefer a key? $5.00 once at /api/v1/answer-keys buys a 1,000-answer Bearer key.
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 the scan report — pay resolves the 402 and pays automatically
pay curl -X POST \
https://pay.botvisibility.com/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. All 58 checks — including Level-5 Agent-Native probes — are included in every scan.
{
"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. Every caller pays per scan past the daily allowance and gets the full report as JSON.
