Three ways to start calling

1 · MCP server (easiest)

Add every endpoint as a tool in Claude, Cursor or any MCP client. Published on npm and in the official MCP Registry.

npx genesis402-mcp

Registry name: io.github.FTHTrading/genesis402-mcp · npm page

2 · x402 client SDK

Use Coinbase's x402 fetch wrapper; it handles the 402 and payment for you.

import { wrapFetchWithPayment } from "x402-fetch";
const pay = wrapFetchWithPayment(fetch, wallet);
const r = await pay("https://twin.unykorn.org/evm-balance", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ address: "0x…" })
});

3 · Plain HTTP

POST with your parameters, read the 402 accepts list, sign one lane, resend with X-PAYMENT.

curl -i -X POST https://twin.unykorn.org/hash \
  -H 'content-type: application/json' \
  -d '{"text":"hello"}'

Discovery & status

Machine-readable catalog, live health and public receipts.

/.well-known/x402 — full catalog (JSON)
/status — live health, checked every 5 minutes
/receipts — signed payment receipts
x402scan — every payment on-chain

Listed on

Coinbase x402 Bazaar · MCP Registry · mcpservers.org · Smithery

Payment lanes