# tryx402 — Payment & Spending Governance for AI Agents
Parental controls for AI spending built on x402 and Stripe fiat bridging.

## Core Capabilities
- 650+ verified pay-per-call tools across 5 providers (Locus, BlockRun, Claw402, StableEnrich, FetchX402).
- Zero-cost discovery: gateway_search (semantic TF-IDF), gateway_discover, gateway_plan.
- Managed fiat bridge: users fund via Stripe Checkout in USD/EUR; the gateway settles downstream x402 on Base.
- Deterministic wallet binding & recovery: gateway_recharge returns customer_id; gateway_reattach_request/verify recover by email (OTP-verified).
- Zero-cost on failure: non-2xx responses (400, 401, 404, 500) are automatically refunded (0 cents charged).

## Quickstart MCP Setup
Add to agent MCP configuration (.mcp.json or Claude Desktop):
{
  "mcpServers": {
    "tryx402": {
      "command": "python3",
      "args": ["-m", "tryx402.mcp_server"],
      "env": { "TRYX402_MAX_BUDGET_USD": "2.00" }
    }
  }
}

## Tools (13 total)
- gateway_search(query, limit): Semantic search across verified tools. Free.
- gateway_discover(origin): Full endpoint manifest with input schemas. Free.
- gateway_plan(steps): Pre-calculate workflow cost before spending. Free.
- gateway_check_balance(customer_id): Check hosted fiat balance in cents. Free.
- gateway_recharge(amount_cents, currency, customer_email): Generate Stripe checkout session. Free.
- gateway_reattach_request(email): Email a one-time code to recover a wallet. Free.
- gateway_reattach_verify(email, code): Verify the code and switch to the paying wallet. Free.
- gateway_proxy_call(url, body, method): Execute tool through fiat balance (+10% commission).
- gateway_call(url, body, method, price): Execute tool on-chain via USDC on Base.
- gateway_spent(): Session cumulative spend ledger. Free.
- gateway_session(cap_usd, ttl_s): Sub-session token with isolated hard ceiling. Free.
- gateway_receipt(endpoint, origin, price_usd): Offline-verifiable Ed25519 payment proof. Free.