# graded-x402

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

- name: sh.graded/graded-x402
- version: 1.0.0
- connection class: unknown (unknown)
- trust: 79/100 flags: no-repository
- quality: 71/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/sh.graded%2Fgraded-x402
- tools: https://api.protogrid.dev/v1/servers/sh.graded%2Fgraded-x402/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

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


## Trust

- hygiene: 80
- liveness: 99
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-97% ~updated-83d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 71/100 (needs work)

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_services (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); call_service (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_account (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 992 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history not recorded yet

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 992 tokens to load them all
- badge: [![protogrid quality](https://protogrid.dev/badge/sh.graded/graded-x402.svg)](https://protogrid.dev/servers/sh.graded/graded-x402)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://graded.sh/mcp (streamable-http, auth unknown, reachable true, uptime30d 0.9745763)

## Packages

_none_

## Tools (9)

- `account`: Your balance, totals, limits, and recent calls. Requires Authorization: Bearer <gwk_ key>.
- `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.
- `create_account`: Create a gateway account. Returns your secret key (gwk_…) - store it; it is shown only once. New accounts start at 0 credits.
- `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>.
- `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>.
- `get_service`: Full detail for one catalog service: grade breakdown, live price, our price (incl. markup), input schema, output example. Free.
- `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.
- `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>.
- `top_up_info`: How to add credits (x402 USDC, or a card checkout link via create_topup_link).