graded-x402

Working · 1.8 s

sh.graded/graded-x402v1.0.0 Domain verified

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

AI & Agents

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://graded.sh/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

account

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

This tool takes no arguments.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (10)

account

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

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.

Argument	Type	Description
id*	string
body	any	JSON body for POST services
query	object	URL query params

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "body": {
      "description": "JSON body for POST services"
    },
    "query": {
      "type": "object",
      "description": "URL query params",
      "additionalProperties": {}
    }
  },
  "additionalProperties": false
}

create_account

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

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

Argument	Type	Description
pack*	number	USD amount: 5, 10 or 20

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pack"
  ],
  "properties": {
    "pack": {
      "type": "number",
      "description": "USD amount: 5, 10 or 20"
    }
  },
  "additionalProperties": false
}

get_service

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

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
id*	string
days	number	window in days, 1-90 (default 30)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "days": {
      "type": "number",
      "description": "window in days, 1-90 (default 30)"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "grade": {
      "type": "string",
      "description": "comma list of grades, e.g. \"A,B\""
    },
    "limit": {
      "type": "number",
      "description": "max 100 per page"
    },
    "query": {
      "type": "string",
      "description": "substring match on name/description"
    },
    "offset": {
      "type": "number",
      "description": "pagination offset"
    },
    "callable": {
      "type": "boolean",
      "description": "only services callable through the gateway"
    }
  },
  "additionalProperties": false
}

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

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "allow": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 200
        },
        {
          "type": "null"
        }
      ],
      "description": "service-id allowlist; only these are callable"
    },
    "daily_usd": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1000,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "max USD charged per rolling 24h"
    },
    "min_grade": {
      "anyOf": [
        {
          "enum": [
            "A",
            "B",
            "C",
            "D"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "refuse services graded below this"
    },
    "max_call_usd": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "max USD charged per call"
    }
  },
  "additionalProperties": false
}

top_up_info

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}