Examples

August 4, 2026 ยท View on GitHub

This directory contains public-safe runnable examples for agent and API workflows.

Current examples:

  • PubFi Route Tools MCP: dependency-free stdio bridge and Registry v2 smoke for the hosted MCP endpoint. It has a no-secret smoke mode.
  • Registry Catalog Curl: no-auth inspection of the current Registry v2 catalog.
  • Accountless x402 on Base Sepolia: Staging-only challenge inspection plus bounded official-client HTTP and MCP paid examples with signed offer, signed receipt, and replay verification.
  • Accountless x402 on Base mainnet: Production-only HTTP and MCP examples pinned to the 2026-07-27 accepted route, canonical Base USDC, exact amount, and payee, with signed offer, signed receipt, and replay verification. Current catalog and challenge checks are required before use. These commands spend real USDC when the route is available.

Public examples must not include upstream provider keys, PubFi API keys, account identifiers, private wallet data, raw production payloads, or unredacted readbacks.

Recommended example pattern:

  1. explain the agent task;
  2. inspect the current Registry catalog or tool schema;
  3. identify whether the example uses public inspection, API-key execution, or accountless x402;
  4. load any required API key or wallet key from a local secret store;
  5. show a redacted response shape;
  6. link to the canonical docs page for deeper context.