Skip to content

graded-x402

by graded.sh · remote · no sign-in to list tools · v1.0.0 · published by sh.graded

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

Changes · 7

10 tools: 7 change things and 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http graded-x402 https://graded.sh/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

10 tools

Changes things 7Claude Code: ask
  • accountYour balance, totals, limits, and recent calls.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Your balance, totals, limits, and recent calls. Requires Authorization: Bearer <gwk_ key>.
  • call_serviceCall a catalog service through the gateway.No findings

    Why it is in this group

    • The name "call_service" says "call": a word for a change.
    Description, as the server wrote it
    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_accountCreate a gateway account.No findings

    Why it is in this group

    • The name "create_account" says "create": a word for a change.
    Description, as the server wrote it
    Create a gateway account. Returns your secret key (gwk_…) - store it; it is shown only once. New accounts start at 0 credits.
  • create_owner_keyOne-time: mint a separate OWNER key (gwo_…) for the human supervisor.No findings

    Why it is in this group

    • The name "create_owner_key" says "create": a word for a change.
    Description, as the server wrote it
    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>.
  • set_limitsConfigure 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…No findings

    Why it is in this group

    • The name "set_limits" says "set": a word for a change.
    Description, as the server wrote it
    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. Requires Authorization: Bearer <gwk_ key>.
  • top_up_infoHow to add credits (x402 USDC, or a card checkout link via create_topup_link).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    How to add credits (x402 USDC, or a card checkout link via create_topup_link).
Only reads 3Claude Code: allow
  • get_serviceFull detail for one catalog service: grade breakdown, live price, our price (incl.No findings

    Why it is in this group

    • The name "get_service" says "get": a word for reading.
    Description, as the server wrote it
    Full detail for one catalog service: grade breakdown, live price, our price (incl. markup), input schema, output example. Free.
  • get_service_historyDaily probe history for one catalog service (UTC days): uptime %, 402/2xx %, p50/p95 latency, grade per day, price changes, probe counts.No findings

    Why it is in this group

    • The name "get_service_history" says "get": a word for reading.
    Description, as the server wrote it
    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.
  • list_servicesSearch the graded catalog of x402 services (the x402 Bazaar + independent indexes), ranked by real 30-day demand and agent-usability grade (A-F).No findings

    Why it is in this group

    • The name "list_services" says "list": a word for reading.
    Description, as the server wrote it
    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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or untrusted-input or outbound.

Reads private data0
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http graded-x402 https://graded.sh/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__graded-x402__list_services",
      "mcp__graded-x402__get_service",
      "mcp__graded-x402__get_service_history"
    ],
    "ask": [
      "mcp__graded-x402__call_service",
      "mcp__graded-x402__create_account",
      "mcp__graded-x402__account",
      "mcp__graded-x402__set_limits",
      "mcp__graded-x402__create_owner_key",
      "mcp__graded-x402__top_up_info",
      "mcp__graded-x402__create_topup_link"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as graded-x402. Review it before you use it.