How do I install BotsRated (beta)?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does BotsRated (beta) need an API key?

No required environment variable is listed on this record.

What transport does BotsRated (beta) use?

BotsRated (beta) is reached over HTTP.

When was BotsRated (beta) last checked?

Last checked 2026-11-08. Signed checks of x402 sellers on Base and remote MCP servers, before your agent pays.

BotsRated (beta) MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://botsrated.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.botsrated-botsrated https://botsrated.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.botsrated-botsrated": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://botsrated.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.4.0-beta
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

BotsRated: MCP server

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 only. No grade or index is shown until a host has 3 paid test-buys on 3 different days.

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	[email protected]

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. No score and no grade. 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
`history`	free	Signed daily aggregates for one host, newest first
`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=<host>) returns measurements and receipt links. You set your own thresholds. The response has no score and no grade.

Field	What you get back
`found`, `host`	Whether this host is in the probe record, and the host name
`latest_probe`	Latest unpaid probe: `ts`, `status`, `valid_402`, `latency_ms`, observed amount (`live_amount`), observed payTo (`live_payTo`), `live_network`
`latest_probe.receipt_url`	Link to the signed receipt for that probe (`https://botsrated.com/receipt/...`). The receipt is the record
`freshness`	`last_probe_at`, `age_seconds`, `stale` (older than 24 h)
`listing`	Directory price and payTo. Directory data is not a probe observation
`recent_window`	Probe count, how many returned a valid 402, latency. A count in a window, not a grade
`note`	Facts only

check (paid, after the free daily quota) adds measured facts for one host and the last receipts. Those are still measurements and receipt links, not a score.

The payment guard in @botsrated/x402-preflight and botsrated keeps a smaller local bundle from this response (covered, host, knownPayTos / known_pay_tos, listingPayTo / listing_pay_to, observedNetwork / observed_network, observedAmount / observed_amount, stale, receiptUrl / receipt_url). Pick a named preset (warn, carefulBuyer, or dry-run-only) there. The guard does not invent a score from these fields.

The paid tools return the x402 URL to call. Any x402 client can pay them, for example @x402/fetch or the Coinbase Agentic Wallet. All three paid routes are also listed in the Coinbase x402 Bazaar.

Free daily quota: the first 25 checks and 3 reports per client IP (IPv6 per /48) per UTC day are answered without payment; after that the normal x402 402 applies. /v1/find spends one check from that same quota. /v1/best has no free quota. Preflight stays free, no key, rate limits. No accounts, prepaid balances or stored credit. The badge is free and earned, never sold. Details: https://botsrated.com/pricing

Free HTTP endpoints and pages


`GET https://botsrated.com/v1/find?q=<need>`	Top matches for a need with a reason (uses 1 of the 25 free checks per client IP per UTC day, shared with `/v1/check`)
`GET https://botsrated.com/v1/pulse`	Live totals (cached 60 s): services watched, working in the last 24 h, down or failed in 7 days, checks run in 7 days. Never names a seller
`GET https://botsrated.com/v1/savings-rates`	Measured rates (offline, payTo changes, price vs listing) with sample size, dates and source
https://botsrated.com/sellers	Browse and filter every covered seller and MCP server
`https://botsrated.com/s/<host>`	One page per seller or MCP server: status, 30-day chart, price, payTo, test purchases, receipts, alternatives
https://botsrated.com/savings	What we check for, with the rates we measured
https://botsrated.com/leaderboard	Data table of the top 300 covered x402 sellers

Plans (seller alerts and data plans)

One x402 USDC payment on Base buys one 30-day period. There is no balance and no auto-renewal. Cancelling stops delivery. The dataset stays free.

Plan	Price per 30 days	What you get
`alerts-free`	free	1 host; one signed webhook digest per UTC day when its facts change
`alerts-10`	$9	Up to 10 hosts; a signed webhook within one probe cycle of a change (payTo, quoted price, valid 402, listing, freshness)
`alerts-50`	$29	Up to 50 hosts; same events
`data-starter`	$49	Bearer token for `/v1/check`, `/v1/report`, `/v1/best` without per-call payment (60 requests/min)
`data-pro`	$199	Same, 600 requests/min
custom	from $499/month	Volume, SLA or bulk delivery: [email protected]

Subscribe with POST https://botsrated.com/v1/alerts/subscribe (free) or POST https://botsrated.com/v1/subscribe/{plan} (x402). The body and the webhook are checked before any 402. The webhook must answer the verification POST with the challenge; it must be https on a public DNS name, and redirects are not followed. Alerts are webhooks only, never email, signed with Ed25519 (botsrated-prober-1, see below) over {"m":"<timestamp>.<raw body>"}. Manage a subscription with GET /v1/subscription and POST /v1/subscription/{cancel,update} plus Authorization: Bearer <token>. Full details: https://botsrated.com/v1/plans

Install

Claude Code:

claude mcp add --transport http botsrated https://botsrated.com/mcp

Cursor / Windsurf / Cline / any client that takes a JSON config:

{
  "mcpServers": {
    "botsrated": { "type": "streamableHttp", "url": "https://botsrated.com/mcp" }
  }
}

VS Code (.vscode/mcp.json):

{ "servers": { "botsrated": { "type": "http", "url": "https://botsrated.com/mcp" } } }

Changelog

See CHANGELOG.md. Catalog listing copy (not submitted from this file): SUBMISSIONS.md.

Security

Report security issues privately: see SECURITY.md ([email protected], subject "Security"). Contributing: CONTRIBUTING.md.

Methodology, replies

Methodology: https://botsrated.com/methodology
A seller can send a reply about a measurement for free: https://botsrated.com/disputes (POST /v1/dispute). The measurement is re-checked and the reply is published next to the data. A measurement is a signed record, not a finding about the seller.
Dataset signature: https://botsrated.com/dataset.sig.json. Key set: https://botsrated.com/.well-known/botsrated-key
Receipt format v0.2.1 (draft; mcp_probe receipts for remote MCP servers; v0.2.1 updates reference schedules and MCP retention) and verifier: spec/SPEC.md, node spec/verify.mjs <receipt.json|url>

Signing keys (Ed25519)

Raw 32-byte public keys, base64. Fingerprint = sha256 of the raw key bytes. A signature is valid for an object whose own timestamp (ts, or generated_at for snapshots) lies in [valid from, valid until). The live key set at /.well-known/botsrated-key is authoritative; this table is an out-of-band copy to compare against.

key_id	Status	Valid from (UTC)	Valid until (UTC)	Signs	Public key	sha256 fingerprint
`botsrated-prod-1`	active	2026-10-23T15:00:00Z	2027-10-23T00:00:00Z	dataset snapshots, paid test-buy receipts	`oTK25Dq3wU2+apPYddiv4T+8is2s3hL1k6ozjMAbEWQ=`	`ac58fa77b9f6a26805efb65d331d6d77da3dfbdbbe981cc7510692852a50e74a`
`botsrated-prober-1`	active	2026-10-23T12:00:00Z	(none)	cron probe receipts, daily aggregates, archive manifests	`G5aD8mz2rkbpLPQuEC2t50AaJpMjGcflTXuRmeJETsE=`	`805e75f8795ff38c4805653962ba75991fc8bdcaef3f80441e0775e405a3a628`
`botsrated-staging-1`	retired (verify only)	2026-10-22T00:00:00Z	2026-10-23T15:00:00Z	dataset snapshots generated before 2026-10-23T15:00:00Z	`OfGrLtyJYCC1K9jjhvq0Zduwgqq68DvzR1StOo5ZpO0=`	`71db9690ef765ce6b923d63fc71e1a65474e87ee1073532eafb9099b1e6f0288`

Payments are USDC on Base mainnet.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install BotsRated (beta)?

Does BotsRated (beta) need an API key?

What transport does BotsRated (beta) use?

When was BotsRated (beta) last checked?

Documentation

BotsRated: MCP server

Tools

Facts bundle (preflight and check)

Free HTTP endpoints and pages

Plans (seller alerts and data plans)

Install

Changelog

Security

Methodology, replies

Signing keys (Ed25519)

Facts bundle (`preflight` and `check`)