BotsRated (beta) MCP Server

About BotsRated (beta)

BotsRated (beta) publishes timestamped, signed measurements of paid x402 agent services on Base and of remote MCP servers: unpaid probes (status, valid 402 challenge, latency, quoted vs listed price and payTo; MCP handshake state and tool list). Where we have test-bought a host, those receipts carry the Base tx hash. Facts and signed receipts only; no scores or grades. Free (normal per-IP rate limits): MCP tool `preflight` and GET /v1/preflight. Paid via x402 (USDC on Base, charged only on a 2xx answer): GET /v1/check?host= $0.001, GET /v1/report/{host} $0.002, GET /v1/best?task= $0.01. Over HTTP the first 25 checks and 3 reports per client per UTC day are free (/v1/find uses 1 of the 25; /v1/best has no free quota). Paid MCP tools (check, report, best): an unpaid call returns an x402 v2 PaymentRequired tool error; an x402-aware MCP client retries with the payment in `_meta["x402/payment"]`. Seller alerts and data plans: https://botsrated.com/v1/plans. Sellers can reply or dispute for free at /disputes.

Tags: x402, mcp, a2a, payments, monitoring, base, usdc

BotsRated (beta) tools (9)

Read from the live server on Oct 30, 2026. These are the tools your AI assistant can call once connected.

preflight

FREE. Is this x402 seller or remote MCP server covered, and what did its latest unpaid probe show? For MCP server hosts: last handshake state (ok, auth_required, handshake_failed, unreachable, or blocked = not contacted because the URL, a r

find

FREE (uses 1 of the 25 free checks per client per UTC day, shared with /v1/check). Top matching covered x402 sellers and remote MCP servers for what you need, each with a one-line factual reason (text match, recent valid 402s or handshakes,

coverage

FREE. How many x402 seller hosts and remote MCP servers BotsRated covers (mcp_servers: servers, hosts, probed, last-state counts), from which discovery sources, the probe schedules and when the last probe runs finished.

sample

FREE. Returns a real sample of a paid response (check, report or best) for a fixed example, so you can see exactly what you would buy.

history

FREE. Signed daily aggregates for one seller host, newest first: probes, valid-402 count, status and error counts, latency p50/p90, quoted amounts, payTo/asset/network seen, 402 check counts, the day's receipt ids and where the raw signed r

check

PAID $0.001 USDC on Base mainnet via x402 (the first 25 calls per client per UTC day are free over HTTP GET /v1/check). Measured facts for one host (an x402 seller, or a remote MCP server host: handshake state, protocol version, tools count

report

PAID $0.002 USDC on Base mainnet via x402 (the first 3 calls per client per UTC day are free over HTTP GET /v1/report/{host}). Full receipt history for one host (up to 1000 probes plus all paid test-buys). An unpaid call returns an x402 v2

best

PAID $0.01 USDC on Base mainnet via x402. Top 3 covered providers for a task, sorted by reliability (default), price or latency, with matching routes and the numbers behind the order. An unpaid call returns an x402 v2 PaymentRequired tool e

botsrated_policy_check

FREE, never charged. Your own pass / warn / block rules applied to BotsRated measurements. Private to your plan or org key: until MCP auth ships this tool checks your arguments and answers bearer_required; call POST /v1/policy/check with yo

How to connect BotsRated (beta) to Claude, Cursor or VS Code

BotsRated (beta) runs as a hosted remote MCP server at https://botsrated.com/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "botsrated-beta": {
      "url": "https://botsrated.com/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http botsrated-beta https://botsrated.com/mcp. Servers that require OAuth or an API key will prompt on first use.