> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axon402.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AXON Docs

> Safe access to paid services for AI agents — x402 discovery, trust signals, and governed execution

AXON gives AI agents safe access to paid services over x402. Operators get a live catalog of services, trust signals, and a governed runtime for `402 Payment Required` spending.

You can start on the hosted path with [`npx @axon402/init`](https://docs.axon402.com/docs/getting-started/quickstart), or you can self-host the Decision API and dashboard with [Live Onboarding](https://docs.axon402.com/docs/getting-started/live-onboarding.md).

## The Problem

Autonomous agents now need to find, evaluate, and pay for real services using protocols like x402. Two things break the loop today:

* **Discovery is fragmented** — no canonical place to browse paid x402 services with fresh prices, schemas, and trust signals.
* **Execution is unsafe** — an agent with raw wallet access can drain its budget in minutes, pay unvetted endpoints, or sign transactions nobody reviewed until the bill arrives.

## What AXON Does

Before every payment, AXON checks the agent's **mandate** — daily budget, per-transaction cap, allowed hosts, blocked hosts, purpose alignment. If the request is safe, AXON signs the EIP-3009 payment on Base. If not, it denies, throttles, or escalates to a human.

Every decision and receipt is stored. Every denial is explainable. Every approval flow has replay protection and expiry.

> **[Hosted Runtime Quickstart](https://docs.axon402.com/docs/getting-started/quickstart.md)**
>
> Bootstrap a governed agent on the hosted path with `npx @axon402/init`.

> **[Self-Hosted Live Onboarding](https://docs.axon402.com/docs/getting-started/live-onboarding.md)**
>
> Bring up Supabase, the Decision API, and the dashboard on your own infrastructure.

> **[Operations](https://docs.axon402.com/docs/operations/deployment.md)**
>
> Deployment, auth, security, runbook, and webhook guidance for launch and ongoing operations.

## Launch Posture

* **Hosted path** is the fastest way to go live with governed agent spending.
* **Self-hosted path** is for teams that need their own infra, secrets boundary, and operational control.
* **Runtime and operator are separate surfaces.** Runtime keys are wallet-scoped. Operator work lives in the dashboard, `axon-op`, or the operator MCP surface.

> **[Core Concepts](https://docs.axon402.com/docs/concepts/overview.md)**
>
> Organizations, wallets, mandates, and spend lifecycle.

> **[Integrations](https://docs.axon402.com/docs/integrations/mcp-server.md)**
>
> Runtime MCP, REST integration, OpenClaw, and two-surface IDE setup.

> **[API Reference](https://docs.axon402.com/docs/api-reference/overview.md)**
>
> Decision API endpoints, MCP tools, and error codes.

> **[CLI](https://docs.axon402.com/docs/cli/installation.md)**
>
> `@axon402/init` for hosted runtime bootstrap and `axon-op` for control-plane operations.

## What This Repo Ships

| Directory | What it does |
| :- | :- |
| `axon-402-mcp/` | Decision API daemon, runtime/operator MCP surfaces, and doctor/bootstrap/demo CLIs |
| `platform/` | React dashboard for approvals, mandates, providers, ledger, and vault |
| `axon-openclaw-plugin/` | OpenClaw integration backed by the Decision API |
| `platform/supabase/` | Migrations and setup SQL for the live path |

## When You'd Use This

* **Research agent** buys $0.35 market snapshots from a paid x402 API — AXON enforces a $25/day cap and blocks unknown providers
* **Coding agent** needs premium LLM inference — AXON checks the mandate allows `api.openai.com` and the request stays under the per-transaction limit
* **Autonomous workflow** runs overnight — AXON requires human approval for anything above \$1.50, and the approval token expires in 5 minutes
* **Multi-agent org** with 10 agents — each has its own wallet, its own mandate, and the treasury vault funds them via auditable transfers

## The x402 Payment Flow

```
Agent                    Provider                AXON                 Facilitator
  │                         │                      │                       │
  │── GET /resource ───────►│                      │                       │
  │◄── 402 + PAYMENT-REQ ──│                      │                       │
  │                         │                      │                       │
  │── governed_fetch(url, intent) ────────────────►│                       │
  │                         │  Validate Mandate    │                       │
  │                         │  Check Balance       │                       │
  │                         │  Sign Payment        │                       │
  │◄───────────────────── Response ────────────────│                       │
  │                         │                      │                       │
  │── GET + PAYMENT-SIG ───►│                      │                       │
  │                         │── Verify + Settle ──────────────────────────►│
  │                         │◄── Settlement Proof ────────────────────────│
  │◄── 200 + PAYMENT-RESP ─│                      │                       │
```

**Total AXON latency:** \< 200ms (policy + signing)

## Supported Networks

| Network | Chain ID | Status | Asset |
| :- | :- | :- | :- |
| Base Mainnet | `eip155:8453` | Production | USDC |
| Base Sepolia | `eip155:84532` | Testnet | USDC |

> [!NOTE]
>
> Public launch docs only describe the current GA payment path: USDC on Base. Do not plan mainnet Ethereum or Arbitrum production rollouts from this site yet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.