graded-x402 MCP Server

by graded Your server? Claim it

answering

graded-x402 is answering right now. Last checked 14 min ago. It exposes 9 tools.

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

Uptime history 48 days of history · worst day 98%

48 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

519 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check graded-x402 every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.graded-x402]
url = "https://graded.sh/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 9

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

account

account

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

create_account

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

call

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.

limits

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

owner

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

service

get_service

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

services

list_services

Search the graded catalog of x402 services (ours + the Bazaar), ranked by real 30-day demand and agent-usability grade (A-F). Free.

top

top_up_info

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

topup

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

Endpoints

URL	Transport	State	Latency	Checked
https://graded.sh/mcp	streamable-http	answering	422 ms	14 min ago

Alternatives to graded-x402

same job, measured the same way

Mercury X402 MCP

by mercuryx402

Agent-payable web data over x402: 18 keyless services an agent pays per call.

38 installs/wk 18 tools answering

Code402

by 89rat

Discover machine-payable APIs, probe x402 payment terms, and run seller operations. Non-custodial.

10 tools answering

Agentictrade

by miranttie

AI service marketplace — agents discover, call, and pay for API services automatically.

5 tools answering

Satring MCP

by toadlybroodle

Discover and compare L402 + x402 paid API services from satring.com

39 installs/wk local only

Kx402

by kali123411

Kaspa x402 agent payer — pay x402 v2 services on Kaspa (KAS) per call, no account or API key

33 installs/wk local only

HPP x402 MCP Bridge

by hpp-io

MCP bridge for autonomous x402 payments in HPP USDC.e — discover and pay for services per call.

93 installs/wk local only

ForgeMesh Utility Grid MCP

by forgemeshlabs

Discover and call 400+ practical APIs through six MCP tools with free search and x402 payments.

62 installs/wk local only

Working Machines MCP Server

by klei30

Connect to 1,400+ apps and 15,000+ actions through one OAuth-protected MCP server.

answering

graded-x402 — questions

Answers built from our own checks of this server.

What can graded-x402 do?

It exposes 9 tools, read directly from the server on our last check. Among them: account, call_service, create_account, create_owner_key, create_topup_link, get_service and 3 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is graded-x402 working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 519 ms. The bar chart above shows every period we have measured.

How do I connect graded-x402?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does graded-x402 need an API key?

No. graded-x402 completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 9 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is graded-x402?

It answers our handshake in 519 ms on average, which is faster than 27% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.