Claude Code Auto Mode Readiness Dashboard — Aug 14 Launch

🤖 Claude Code Integration (30-Second Setup)

Connect Claude Code to minia2a so your agent can discover and pay for APIs autonomously.

Step 1: Add the MCP server

Create .mcp.json in your project root (or add to your global ~/.claude/.mcp.json):

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

5 tools: service_discovery, service_call, register_agent, get_receipt, get_stats.

Step 2: Set your agent budget

Add to your project's CLAUDE.md (Claude Code reads this before every session):

# Agent Payment Budget
.agent-budget: {"daily_limit_usdc":5,"max_per_call_usdc":1}
# Payments via minia2a — 5 free trial calls per signed wallet, then USDC (Base)
# Trial: sign any wallet + send X-Wallet-Signature with ?wallet=0x... → 5 free calls

Step 3: Test it

Ask Claude Code: "Check what APIs are available on minia2a and show me the top 3 by trial count." Your agent will use the MCP server to discover services, check stats, and call endpoints — all without leaving the terminal.

🔄 End-to-End: Agent's First Paid API Call

What happens when a Claude Code agent encounters an x402 endpoint for the first time.

1

Discover

MCP service_discovery → 1,703 services, filter by task

2

Trial

GET /x402/gas → 200 + data (wallet-signed trials)

3

Trial exhausted → 402 + accepts[] (amount, asset, network, payTo)

4

Pay

Read .agent-budget → within limit → auto-pay $0.10 USDC

5

Deliver

200 + gas data + _receipt in response body

Key: the agent never leaves the terminal. No browser, no wallet popup, no human approval needed. The 402 response carries machine-readable payment instructions in accepts[] (amount, asset, network, payTo). The agent checks .agent-budget, pays if within limits, and gets the result. This is the full autonomous commerce loop.

✅ Auto-Mode Readiness Checklist

✓

402 Payment Instructions (accepts[] JSON)

accepts[] with amount, asset, network, payTo, scheme — x402 V2 machine-readable instructions. Auto-mode agents can parse payment instructions without human help.
✓

Agent-Ready Handshake (JSON)

GET /api/agent-ready returns JSON (status, facilitator, onchain, paymentRoutes, services). /AGENTS.md has full prose instructions. Agents self-onboard in one request.
✓

Trial — One Command

TS=$(date +%s); curl "https://minia2a.uk/x402/gas?wallet=0xYOUR_WALLET" -H "X-Wallet-Signature: 0x..." -H "X-Trial-Timestamp: $TS" → 5 free trial calls. Self-custody wallet + signature (platform never sees your key). No KYC, no gas, no human.
✓

Trial-First Access (5 free trial calls)

Agents can test any service before committing funds. 960+ endpoints with trials. Sign a wallet for 5 trial calls. Sign a wallet for 5 free trial calls.
✓

.agent-budget Convention

Format: {"daily_limit_usdc":5,"max_per_call_usdc":1}. Agents declare spending limits. Frameworks enforce them before paying 402.
✓

MCP Server (npm: minia2a-mcp)

5 tools: service_discovery, service_call, register_agent, get_receipt, get_stats. npx -y minia2a-mcp
→

API Auto-Mode Validator

Interactive tool that tests any x402 endpoint against 9 readiness signals. Open validator →
→

CLI Readiness Check

curl -s https://minia2a.uk/auto-mode-check | bash -s -- https://your-api.com/endpoint

🌐 Ecosystem Comparison — Who's Auto-Mode Ready?

Platform	402 Payment	Agent-Ready	Trial-First	MCP Server	Health Probes	Endpoints
minia2a	✓ accepts[] V2	✓ /api/agent-ready	✓ 5 trial calls	✓ MCP (5 tools)	✓ auto-deactivate	1,703
Loomal Index	~ x402 native	—	—	~ Index API	—	unknown
a platform directory	~ x402 native	—	—	—	—	31+ skills
xpay (xpaysh)	✓ x402	—	—	✓ 43 tools	—	980+
AgentFeed	✓ 3 chains	—	5 free tools	✓ PulseMCP	—	47
Coinbase Bazaar	✓ x402	—	—	—	—	14,865*
Binance B402 Bazaar	~ B402 (EIP-712)	~ Agent Studio	—	—	—	25 (verified)
Polygon Agentic	~ x402 native	—	—	—	—	unknown

* 96.5% of Coinbase Bazaar listings have zero repeat demand per independent audit. ✓ = verified, ~ = protocol-native (assumed), — = not observed. Binance B402: 25 endpoints (verified via public API Aug 11), gas-sponsored, off-chain EIP-712 auth, BNB Chain only. Polygon Agentic: official Polygon directory. Both launched Aug 2026.

🔧 Troubleshooting Common Auto-Mode Issues

Agent gets 402 but doesn't pay

Check that .agent-budget exists in project root. Format: {"daily_limit_usdc":5,"max_per_call_usdc":1}. The agent reads this file before spending. If the file is missing or malformed, auto-pay is blocked.

"402 has no accepts[]" error

The 402 response must include an accepts[] JSON array with amount, asset, network, and payTo. Test with curl -s 'https://your-api.com/endpoint?probe=1' — the body should carry these fields. If missing, the API is not auto-mode ready.

Trial exhausted immediately (first call returns 402)

Anonymous callers get a 402 challenge, not a trial. If you're behind a corporate proxy or VPN, many users share one IP and exhaust it. Sign your wallet to get 5 trial calls (no registration needed) (~50–5 calls depending on endpoint price).

MCP server not connecting

Ensure Node.js ≥18 is installed. Run npx -y minia2a-mcp manually to test. Check .mcp.json is valid JSON (trailing commas break it). For global install, put the config in ~/.claude/.mcp.json.

Spent credits but got no data

All payments are verified before delivery. If payment settles but the upstream API fails, credits are not consumed. Check the response _receipt field — it includes settlement_status and delivery_status.

🚀 Quick Start for Developers

Three commands to make your API auto-mode ready:

# 1. Test your endpoint's 402 response
curl -sI 'https://your-api.com/endpoint?probe=1'

# 2. Run full readiness check (9 signals)
curl -s https://minia2a.uk/auto-mode-check | bash -s -- https://your-api.com/endpoint

# 3. Verify agent-ready handshake
curl -s https://minia2a.uk/api/agent-ready | python3 -m json.tool

Open Validator Register Your API 15-Minute Guide