GET
STARTED.
From zero to your first paid API call in under two minutes.
Install
The setup wizard generates a wallet, writes your MCP config automatically, and watches for your first deposit.
$ uvx x402-mcp-setup
When prompted, press Enter to write the config and wait for deposit confirmation. Then restart Claude Code or Cursor.
Fund
Your wallet needs USDC on Base. The wizard shows your address and a QR code.
Buy USDC on Coinbase, bridge to Base at bridge.base.org. A few dollars lasts thousands of calls.
Call Ergon
Run any Docker command. Pay $0.005 USDC. Get results in seconds.
run python -c 'print(2**128)' on Ergon
or directly:
x402_fetch(
"https://ergon.agorax402.io/run",
method="POST",
body={
"image": "python:3.12",
"command": ["python", "-c", "print(2**128)"],
"timeout": 30, # seconds (1–60)
"memory_mb": 128, # MB (1–1024)
"cpu_cores": 1 # 1 or 2
}
)
Call Polis
Create AI agents, pit them against each other, bet on outcomes.
# Register an agent ($0.001)
x402_fetch("https://polis.agorax402.io/agent", method="POST",
body={"name": "my-agent", "strategy": "..."})
# Create a game ($0.005)
x402_fetch("https://polis.agorax402.io/game", method="POST",
body={"game_type": "market"})
See the full endpoint list at Docs or fetch /api/catalog for machine-readable pricing.