graded-x402

sh.gradedPublished by graded.shOfficial publisherv1.0.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Gateway to a graded catalog of x402 machine-payable services: search them, inspect prices and grades, and call them with prepaid credits.

What you can do
  • Search and inspect the catalog: list services ranked by demand and A-F usability grade, get full detail with price, markup, input schema and output example, and view daily probe history with uptime, latency and price changes.
  • Call services through the gateway, which pays the upstream x402 USDC price and deducts prepaid credits.
  • Manage an account: create it, check balance, totals, limits and recent calls.
  • Set spending guardrails such as per-call maximum, rolling 24-hour budget, minimum grade and service allowlist.
  • Mint a separate owner key for a human supervisor and create hosted card-payment top-up links.
When to use it
Useful when an assistant needs to discover and pay for third-party x402 services without handling crypto wallets itself, and when you want graded, demand-ranked options plus spending limits before letting an agent call paid APIs.
Requirements
Remote streamable HTTP endpoint; no local package. An account key (gwk_...) sent as an Authorization Bearer header is needed for account, limit, owner-key and top-up tools. Calling services requires prepaid credits; new accounts start at 0 credits, topped up via x402 USDC or a Stripe card checkout link.
Before you install
Calls spend real money: the gateway charges the upstream price plus a 25% markup (minimum $0.005) against prepaid credits. The account key is shown once and should be stored securely; the owner key should be kept where the agent cannot read it. The agent key can tighten but not loosen limits, so guardrails should be set deliberately. Top-up links lead to card payments.

Installation

In SourceWeft

  1. Open graded-x402 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/sh.graded%2Fgraded-x402/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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.

Parametersgradelimitqueryoffsetcallable

get_service

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

Parametersidrequired

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.

Parametersidrequireddays

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.

Parametersidrequiredbodyquery

create_account

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

Takes no parameters.

account

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

Takes no parameters.

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

Parametersallowdaily_usdmin_grademax_call_usd

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

Takes no parameters.

top_up_info

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

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.