x402-toolslisted
Install: claude install-skill underscoredone/x402-tools-skill
# x402 Tools
Read-only inspection of x402 endpoints. Two things it does:
1. **Inspect a live endpoint** — call it without paying, decode the payment challenge,
and report the price in real money, the accepted networks and tokens, where the money
goes, and how to call it.
2. **Read an OpenAPI spec** — find it, check it parses, lay out its contents, and show
where it differs from the live endpoint.
**It never pays, signs, or needs a wallet.** It also never grades an endpoint: it reports
what is there and leaves the conclusions to the reader.
## When to use this
- Someone asks what an x402 or paid API costs, or which chains and tokens it takes
- A paid API call failed and the 402 response is opaque
- Someone wants to know how to call an endpoint before spending anything on it
- Someone is shipping an x402 API and wants to see what it actually emits
- Any request to read, find, or check an `openapi.json`
Do **not** use it to pay for anything — it has no wallet and cannot. If the user wants to
actually call a paid endpoint, that is a different tool.
## How to run it
```bash
node scripts/x402.mjs inspect <url> [--method POST] [--body '{}'] [--json]
node scripts/x402.mjs openapi <url> [--no-compare] [--spec-url <url>] [--json]
node scripts/x402.mjs decode <base64-value>
```
Requires only Node 18+. Nothing to install — the engine is bundled in `lib/`.
### Run both, by default
When someone points at an endpoint — "what does X cost?", "inspect X", "/x402-tools for
X