botsrated/botsrated

Signed checks of paid AI services, before your agent pays.
BotsRated measures paid AI-agent services with signed receipts. BotPulse is a separate digest and alerts product; these measurements do not claim coverage of every delivery outcome.
BotsRated publishes timestamped, receipt-backed measurements of paid x402 agent services on Base:
unpaid probes: status, whether the 402 challenge is valid, latency, quoted vs listed price, and payTo;
paid test-buys, each with its on-chain tx hash.
It reports facts and signed receipts only.
This repository documents the remote MCP server. There is nothing to install or run locally.
| MCP endpoint | https://botsrated.com/mcp (Streamable HTTP, JSON responses, no auth) |
| Official MCP Registry | com.botsrated/botsrated |
| Website | https://botsrated.com |
| OpenAPI | https://botsrated.com/openapi.json |
| A2A agent card | https://botsrated.com/.well-known/agent-card.json |
| llms.txt | https://botsrated.com/llms.txt |
| Contact | botsrated@gmail.com |
## Tools
| Tool | Price | What it returns |
| preflight | free, no key, rate limits | Facts bundle for an x402 seller (host or URL): latest unpaid probe, freshness, directory listing, receipt link. Measurements and a receipt link. See below |
| find | free (uses 1 of the 25 free checks per client IP per UTC day) | Top matching x402 sellers and remote MCP servers for a need (q, e.g. weather), each with a one-line factual reason and its page URL. Same filters as best, without the full ranking. HTTP: GET https://botsrated.com/v1/find?q= |
| coverage | free | How many x402 sellers and MCP servers are covered, from which sources, and when the last probe ran |
| sample | free | A real sample of a paid answer (check, report or best) for a fixed example |
| check | $0.001 (x402, USDC on Base); first 25 per client IP per UTC day free | Measured facts and the last 5 receipts for one host. Paid at GET https://botsrated.com/v1/check?host= |
| report | $0.002 (x402); first 3 per client IP per UTC day free | Full receipt history for one host. Paid at GET https://botsrated.com/v1/report/{host} |
| best | $0.01 (x402) | Top 3 measured providers for a task (sort=reliability\|price\|latency). Paid at GET https://botsrated.com/v1/best?task= |
## Facts bundle (preflight and check)
preflight (the MCP tool and GET /v1/preflight?url= ) returns measurements and receipt links. You set your own
thresholds. The response is measurements and a receipt link.
| Field | What you get back |
| found, host | Whether this host is in the probe record, and the host name |
| latestprobe | Latest unpaid probe: ts, status, valid402, latencyms, observed amount (liveamount), observed payTo (livepayTo), livenetwork |
| latestprobe.receipturl | Link to the signed receipt for that probe (https://botsrated.com/receipt/...). The receipt is the record |
| freshness | lastprobeat, ageseconds, stale (older than 24 h) |
| listing | Directory price and payTo. Directory data is not a probe observation |
| recentwindow | Probe count, how many returned a valid 402, latency. A count in a window |
| note | Facts only |
check (paid, after the free daily quota) adds measured facts for one host and the last receipts. Those are still