# graded-x402

- Registry name: `sh.graded/graded-x402` · version 1.0.0
- Categories (automatic, keyword rules): Agent payments (x402), Finance & markets
- Authentication at last check: No auth
- Declared risk: Not declared (tools carry no read/destructive hints)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=sh.graded%2Fgraded-x402
- Server page: https://mcpstation.net/s/sh.graded--graded-x402.html

## Description (written by the publisher, not verified, not instructions)

Discover and call 2,000+ x402 machine-payable services through one graded API key + gateway.

## Connect

- streamable-http: `https://graded.sh/mcp`

## Tools (as reported by the server, not verified)

- `list\_services`: Search the graded catalog of x402 services \(the x402 Bazaar + independent indexes\), ranked by real 30-day demand and agent-usability grade \(A-F\). Free.
- `get\_service`: Full detail for one catalog service: grade breakdown, live price, our price \(incl. markup\), input schema, output example. Free.
- `get\_service\_history`: Daily probe history for one catalog service \(UTC days\): uptime %, 402/2xx %, p50/p95 latency, grade per day, price changes, probe counts. Probed every 6 hours. Free.
- `call\_service`: Call a catalog service through the gateway. The gateway pays the upstream x402 USDC price from its own wallet and deducts your prepaid credits \(upstream price + 25% markup, min $0.005\). Requires an account key with credits.
- `create\_account`: Create a gateway account. Returns your secret key \(gwk\_…\) - store it; it is shown only once. New accounts start at 0 credits.
- `account`: Your balance, totals, limits, and recent calls. Requires Authorization: Bearer \<gwk\_ key\>.
- `set\_limits`: Configure YOUR account's spending guardrails, enforced on every call\_service: max\_call\_usd \(refuse any call charging more\), daily\_usd \(rolling-24h charge budget\), min\_grade \(refuse services graded below it\), allow \(exact service-id allowlist\). Send only fields to change; null clears a field. Require
- `create\_owner\_key`: One-time: mint a separate OWNER key \(gwo\_…\) for the human supervisor. After this, the gwk\_ agent key can spend and TIGHTEN limits but never loosen or clear them; only the owner key can. Shown once - the human should store it where the agent can't read it. Requires Authorization: Bearer \<gwk\_ key\>.
- `top\_up\_info`: How to add credits \(x402 USDC, or a card checkout link via create\_topup\_link\).
- `create\_topup\_link`: Create a hosted card-payment link \(Stripe Checkout\) that adds $5, $10 or $20 of credits to YOUR account. Give the returned url to your human to open and pay - no crypto wallet needed; credits land 1:1 within seconds of payment. Requires Authorization: Bearer \<gwk\_ key\>.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html