Circle Agent Readiness API logo Circle Agent Readiness API
Machine-native trust infrastructure

Readiness checks for autonomous finance agents

Validate wallet configuration, spending limits, delegated permissions, x402 compatibility, and marketplace readiness before an agent is allowed to transact.

Circle Agent Stack x402 / USDC Bazaar-indexed MCP-compatible Deterministic checks
Input Agent config Wallet, policy, permissions
Output Readiness verdict Readable by agents and humans
Use case Preflight Before spend, delegate, connect
Payment x402-native USDC micropayments per call
What the API inspects

Guardrails agents can verify before they act

Circle Agent Readiness API turns a raw agent manifest into a fast, deterministic hygiene signal. No chatbot layer, no compliance theater — just the checks another machine needs in order to decide whether to proceed.

Developer hygiene signal, not a security audit.
Wallet Configuration

Wallet presence, supported networks, and USDC capability.

Policy Spending limits

Per-transaction caps, daily budgets, and allowlist posture.

Delegation Permissions

Whether delegated workers stay scoped instead of becoming ambient spenders.

Protocol x402 readiness

Buyer compatibility and payment-path readiness for autonomous calls.

Discovery Marketplace fit

Whether metadata is ready for agent marketplaces and discovery surfaces.

Tooling MCP exposure

Whether the agent can expose declared tools cleanly to connected workflows.

API first

One endpoint, one compact verdict

Autonomous callers do not need a dashboard. They need a response they can branch on in the same transaction flow.

POST /inspect/circle-agent-readiness
{
  "wallet": {
    "configured": true,
    "supportedNetworks": ["eip155:8453"],
    "supportedAssets": ["USDC"]
  },
  "spendingPolicy": {
    "perTransactionLimitUsd": 25,
    "dailyLimitUsd": 100,
    "recipientAllowlistEnabled": true,
    "contractAllowlistEnabled": true
  },
  "delegations": [{
    "name": "payment_worker",
    "canTransfer": true,
    "canCallContracts": false,
    "maxSpendUsd": 25
  }],
  "x402": { "buyerCompatible": true },
  "marketplace": { "listingMetadataReady": true },
  "mcp": { "serverExposed": true, "toolsDeclared": true }
}
200 · machine-readable response
{
  "readinessScore": 100,
  "status": "agent_ready",
  "riskLevel": "low",
  "checks": {
    "walletConfigured": true,
    "spendingLimits": true,
    "delegatedPermissionsBounded": true,
    "x402Compatible": true,
    "mcpCompatible": true
  },
  "riskFlags": [],
  "recommendations": []
}
Response shape JSON Stable branchable fields
Decision Deterministic No opinion layer
Best moment Preflight Before spend or delegation
Before an agent acts

The readiness path is deliberately short

The strongest trust primitive is one agents will actually call. This one is designed to fit directly into the hot path.

01

Inspect

Read wallet, policy, and delegated scope.

02

Bound

Check budgets and allowed actions.

03

Score

Produce readiness, risk, and flags.

04

Publish

Expose a verdict other systems can read.

05

Transact

Proceed only when guardrails are real.

Why agents call it automatically

Useful at the exact moment trust matters

Before spend

Wallet risk preflight

Check whether a finance agent is bounded before it sends USDC through an x402 flow.

Before delegation

Permission review

Reject broad delegated capabilities before an autonomous worker receives control.

Before listing

Marketplace readiness

Let marketplaces consume a compact verdict before exposing an agent to others.

Trust other agents can consume

A readiness signal that travels with the agent

Built for the emerging machine economy: Circle Agent Stack for wallet orchestration, x402 for paid HTTP requests, MCP for tool exposure, and marketplaces that need a fast trust primitive before discovery or execution.

Circle Agent Stack x402 MCP Agent marketplaces
Micropayment-native

Priced like infrastructure, not software seats

x402 lets autonomous callers pay only when they need a verdict. No account ceremony, no API-key ritual, no dashboard dependency.

$0.01 per readiness check

USDC micropayments via x402.

Developer quickstart
curl -s https://circle-agent-readiness-api.vercel.app/inspect/circle-agent-readiness \
  -H 'content-type: application/json' \
  --data @agent-manifest.json
Fast enough for autonomous preflight paths