graded-x402

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "graded-x402": {
      "url": "https://graded.sh/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• 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.

  Parameters:

  • grade — string — comma list of grades, e.g. "A,B"
  • limit — number — max 100 per page
  • query — string — substring match on name/description
  • offset — number — pagination offset
  • callable — boolean — only services callable through the gateway

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_service

  Full detail for one catalog service: grade breakdown, live price, our price (incl. markup), input schema, output example. Free.

  Parameters:

  • id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • id (required) — string
  • days — number — window in days, 1-90 (default 30)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • id (required) — string
  • body — JSON body for POST services
  • query — object — URL query params

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_account

  Create a gateway account. Returns your secret key (gwk_…) - store it; it is shown only once. New accounts start at 0 credits.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• account

  Your balance, totals, limits, and recent calls. Requires Authorization: Bearer <gwk_ key>.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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. Requires Authorization: Bearer <gwk_ key>.

  Parameters:

  • allow — service-id allowlist; only these are callable
  • daily_usd — max USD charged per rolling 24h
  • min_grade — refuse services graded below this
  • max_call_usd — max USD charged per call

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• top_up_info

  How to add credits (x402 USDC, or a card checkout link via create_topup_link).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • pack (required) — number — USD amount: 5, 10 or 20

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.