@ironbridgefoundation/ironbridge-mcp-server

MCP server for pay-per-call data lanes with a client-verifiable audit trail.

Two live lanes — CLERK (U.S. federal court records) and SOLVR (token & market intel) — metered at $0.10 USDC per call on Base. Every served call settles to the IronBridge treasury Safe and writes a LAW-25 hash-chain seal you can re-walk yourself, on your own machine, without trusting IronBridge.

This client holds no keys and never signs anything. You pay from your own wallet and pass only the resulting transaction hash.

Install

npm install -g @ironbridgefoundation/ironbridge-mcp-server

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ironbridge": {
      "command": "npx",
      "args": ["-y", "@ironbridgefoundation/ironbridge-mcp-server"]
    }
  }
}

How paying works (x402 flow)

1. Call any metered tool with no payment. The lane answers 402 with exact instructions: { price_usdc: 0.1, receiver: 0x5Bb0a8A570F73eE0575043B8A9c33b28D6891680, network: "base" }.
2. Send that USDC amount on Base from your own wallet to the receiver.
3. Call the tool again with payment_tx set to your transaction hash (or set env IB_PAYMENT_TX).
4. You get the result plus a LAW-25 seal. Verify it yourself (below).

The 402 is not an error — it's the price tag.

Tools (16)

Metered via the live pay lane — $0.10 USDC on Base, LAW-25 sealed

| Tool | What it does | |---|---| | clerk_search | Search U.S. federal court records by party, case, or docket | | clerk_parties | Parties + attorneys for a federal case | | clerk_judges | Judge lookup: appointments, courts, activity | | clerk_citations | Citation lookup + cited-by graph for federal opinions | | clerk_oral_arguments | Oral-argument recordings + metadata (appellate) | | solvr_dex_search | Token search by name/symbol/address across DEXes | | solvr_dex_trending | Trending tokens ranked by volume + momentum | | solvr_news | World news headlines from major outlets, filterable | | solvr_worlddata | World Bank country data + US macro via FRED |

Free — verification & liveness

| Tool | What it does | |---|---| | ironbridge_audit_chain | Re-walks the public LAW-25 hash chain locally on your machine; optional receipt cross-check + daily-anchor claim | | ironbridge_status | Live gateway version + public stats | | clerk_health | Lane liveness: confirms the gateway is up and returns the current 402 price quote (nothing is paid) |

Server-side only — requires your own upstream key (IB_SOLVR_KEY_PATH); not yet on the public pay lane

solvr_token_intel · solvr_security_scan · solvr_security_bundles · solvr_ta_analysis

Keyless installs get a clean unavailable_keyless response from these — not a doomed upstream call.

Verify it yourself — the point of all this

Every paid call is sealed into a public, append-only SHA-256 hash chain (LAW-25), and the chain head is committed daily to a contract on Base. None of that requires trusting us:

# in-package: re-walk the chain locally
# (call the ironbridge_audit_chain tool with your receipt id)

# fully independent, outside this package:
curl -O https://ironbridge.foundation/verify.js
node verify.js <your-receipt-id>

verify.js re-walks the ledger with your machine's own SHA-256, reads your payment transaction from Base via public RPCs IronBridge doesn't operate, and reads the daily anchor straight from the contract. Or use the browser version at https://ironbridge.foundation/verify-yourself.

Honesty notes. Row leaf contents are withheld (keyed HMAC per row) — you verify linkage and timestamped commitment, not private leaf data; spot-check any row server-side at /api/law25/verify?row=N. The receipt→ledger binding is currently a tip pointer, not a Merkle inclusion proof (roadmap). Rows before ~seq 1250 (May 13–14, 2026 bring-up) predate the canonical leaf format.

Dog Tag

IronBridge issues a $5 Dog Tag NFT (contract 0x22E51B8D…365e on Base) as an agent identity credential. It is not required to use the pay lanes today; it gates upcoming holder features.

Environment

| Var | Default | Purpose | |---|---|---| | IB_PAY_BASE | https://ironbridge.foundation | Pay-lane gateway | | IB_BASE | https://ironbridge.foundation | Verification/status endpoints | | IB_PAYMENT_TX | — | Default payment tx hash (instead of per-call payment_tx) | | IB_PAY_MODE | lane | lane (published default) or direct (server-side, needs key) | | IB_SOLVR_KEY_PATH | — | Path to upstream key file — server-side installs only |

Live today vs planned

Live: the 9 metered lane tools above · LAW-25 public chain + daily on-chain anchor · receipt API · Dog Tag mint. Planned, not live: pay-lane coverage for the 4 key-gated SOLVR tools · Merkle inclusion proofs for receipts · staking / marketplace features. If it's not in the Live list, this package doesn't claim it.

License

MIT