Agent API

Interactive OpenAPI

MCP tools

• calculate_deff
  Calculate DEFF for a single option with optional barriers.
  Wallet $0.04 USDC · key/session on the plan
• log_decision
  Create a decision (QUICK/STANDARD/DEEP) for the authenticated owner.
  Plan or rate limit; no micropay
• resolve_decision
  Resolve a decision against the frozen ask. Self-grade never gets full calibration weight.
  Plan or rate limit; no micropay
• log_claim
  Log a bot claim: freeze the original ask, the claim, P, done-when, and when to check.
  Plan or rate limit; no micropay
• list_open_claims
  List open bot-claim decisions for this owner, with an overdue flag.
  Plan or rate limit; no micropay
• calibration_report
  Speakable calibration card: D/Brier, open vs resolved, overdue.
  Plan or rate limit; no micropay
• record_lesson
  Store a post-grade lesson. User and external feedback are trusted; self and auto are not.
  Plan or rate limit; no micropay
• recall_lessons
  Return the most relevant prior lessons before logging a new claim.
  Plan or rate limit; no micropay
• discernment_check
  Shortcut risk check for CI / agent gates.
  Wallet $0.04 USDC · key/session on the plan
• erp_discern_says
  Score an ERP approval and return a Discern Says card.
  Business plan; no micropay

Paid endpoints

• POST /api/v1/deff/calculate — $0.04 USDC
• POST /api/v1/paths/simulate — $0.05 USDC
• POST /api/v1/paths/optimize — $0.25 USDC
• POST /api/v1/paths/optimize/continuous — $0.50 USDC
• POST /api/v1/problem/frame — $0.10 USDC
• GET /api/v1/reference-class — $0.03 USDC
• GET /api/v1/deff/history — $0.03 USDC
• POST /api/v1/workflows — $0.05 USDC
• MCP calculate_deff — $0.04 USDC (wallet)
• MCP discernment_check — $0.04 USDC (wallet)

Auth

• x-api-key — free tier with rate limits
• Clerk session cookie — human UI / same-origin
• x402 PAYMENT-SIGNATURE — paid agent calls after 402 challenge
• Idempotency-Key — mutating routes (create/log/resolve)