← ToolOracle x402 Protocol v2.0

x402 Payment Protocol

How AI agents pay for ToolOracle MCP tool calls with USDC on Base. No accounts, no API keys, no human checkout.

How it works

When an agent calls a paid tool without payment, the server returns HTTP 402 with payment instructions. The agent sends USDC on Base, includes the transaction hash, and retries.

1. Agent → POST /x402/flight/mcp/     (no payment)
2. Server → 402 Payment Required      (with payment details)
3. Agent → Send USDC to wallet on Base
4. Agent → POST /x402/flight/mcp/     (X-PAYMENT: 0xtxhash...)
5. Server → 200 + tool response       (units credited + deducted)

Payment details

Field	Value
Network	Base (Chain ID 8453)
Token	USDC
Token Address	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
Pay-to Wallet	`0x4a4B1F45a00892542ac62562D1F2C62F579E4945`
Unit Price	$0.01 per unit (10,000 atomic USDC)
Header	`X-PAYMENT: 0x<transaction_hash>`

Unit pricing per tool

Tier	Units	Example tools
Light (1 unit)	$0.01	health_check, airport_hub, check_ranking
Medium (3-5 units)	$0.03–0.05	flight_search, hotel_search, product_search
Heavy (8-15 units)	$0.08–0.15	keyword_research, competitor_gap, multi_city

402 Response format

{
  "x402Version": 2,
  "status": "payment_required",
  "denial": {
    "tool": "flight_search",
    "reason": "no_payment",
    "required_units": 5,
    "required_amount_usd": "$0.05"
  },
  "payment": {
    "network": "base",
    "currency": "USDC",
    "payTo": "0x4a4B1F45a00892542ac62562D1F2C62F579E4945",
    "unit_value": "$0.01"
  },
  "how_to_pay": {
    "step1": "Send USDC on Base to wallet",
    "step2": "Include tx hash in X-PAYMENT header",
    "step3": "Retry request — units auto-credited"
  }
}

Available x402 endpoints — 35 products

All endpoints follow the pattern POST /x402/{product}/mcp/. 35 products with 275+ paid tools.

Agent Infrastructure

/x402/guard/mcp/        AgentGuard          20 tools  — KYA, policies, kill-switch, audit
/x402/memory/mcp/       MemoryOracle         9 tools  — persistent agent memory
/x402/scheduler/mcp/    SchedulerOracle      8 tools  — cron-style task scheduling
/x402/preflight/mcp/    PreflightOracle      5 tools  — decision preflight, claim verify

Blockchain & DeFi

/x402/meme/mcp/         MemeOracle           8 tools  — rug check, momentum, whale watch
/x402/smart/mcp/        SmartMoneyOracle     7 tools  — whale tracking, flow scan
/x402/yield/mcp/        YieldOracle          7 tools  — DeFi yields, RWA yields
/x402/crypto/mcp/       CryptoOracle         coming soon

Business Intelligence

/x402/rank/mcp/         RankOracle          12 tools  — SEO, keywords, SERP, backlinks
/x402/shop/mcp/         ShopOracle          10 tools  — product search, price compare
/x402/news/mcp/         NewsOracle           8 tools  — trending, deep dive, coverage
/x402/lead/mcp/         LeadOracle           4 tools  — lead search, enrich, score
/x402/review/mcp/       ReviewOracle         coming soon
/x402/seo/mcp/          SEOOracle            coming soon
/x402/research/mcp/     ResearchOracle      10 tools  — papers, arxiv, citations

Travel & Lifestyle

/x402/flight/mcp/       FlightOracle         7 tools  — flights, price calendar
/x402/hotel/mcp/        HotelOracle          7 tools  — hotel search, price compare
/x402/jobs/mcp/         JobOracle            7 tools  — job search, salary insights
/x402/weather/mcp/      WeatherOracle        coming soon
/x402/sport/mcp/        SportOracle          coming soon
/x402/movie/mcp/        MovieOracle          coming soon
/x402/map/mcp/          MapOracle            coming soon

Finance & Macro

/x402/macro/mcp/        MacroOracle          7 tools  — Fed, ECB, inflation, GDP
/x402/cfo/mcp/          CFOCoPilot          12 tools  — VAT, IBAN, invoice, cashflow
/x402/tax/mcp/          TaxOracle           12 tools  — DAC6, Pillar Two, transfer pricing
/x402/insurance/mcp/    InsuranceOracle     11 tools  — NatCat, solvency, regulation

Compliance & Security

/x402/conductor/mcp/    DORA Conductor      13 tools  — multi-oracle orchestration
/x402/ampel/mcp/        AmpelOracle          8 tools  — DORA traffic-light system
/x402/drift/mcp/        DriftOracle         12 tools  — compliance drift detection
/x402/aml/mcp/          AMLOracle           11 tools  — sanctions, PEP, KYC
/x402/cybershield/mcp/  CyberShield         12 tools  — NIS2, ISO 27001, DORA ICT

Enterprise Operations

/x402/hr/mcp/           HROracle            12 tools  — payroll, leave, contracts
/x402/health/mcp/       HealthGuard         12 tools  — MDR, IVDR, GMP, GDPR health
/x402/supplychain/mcp/  SupplyChainOracle   12 tools  — LKSG, CBAM, scope 3
/x402/legal/mcp/        LegalTechOracle     12 tools  — contract draft, NDA, DPA

Check your balance

GET /x402/balance/{wallet_address}

Discovery

Machine-readable x402 spec: /.well-known/x402

Gateway health: /x402/health