# Ax402

> Full-stack x402 platform: facilitator, gateway, dashboard, TypeScript/Go/Python SDKs, CLI, MCP, React paywall, and e-commerce plugins.

## Agent entry points
- Agent guide: https://staging.ax402.io/guides/agents
- CLI reference: https://staging.ax402.io/api-reference/cli
- MCP server: https://staging.ax402.io/api-reference/mcp
- OpenAPI contract: https://github.com/AxLabs/ax402-sdk/blob/main/openapi/control-plane.yaml

## Buyer (pay gateway URLs)
- Buyer clients: https://staging.ax402.io/guides/buyers
- Staging echo: https://echo.staging.ax402.io/echo/get?test=1
- TypeScript: @axlabs/ax402-sdk/buyer — buyerClientFromEnv(), client.pay({ url })
- Go: github.com/AxLabs/ax402-sdk/go/buyer — NewFromPrivateKey, Get(ctx, url)
- Python: ax402_sdk.buyer — BuyerClient.from_env().get(url); pip install "ax402-sdk[buyer]"
- CLI: ax402 pay url --url GATEWAY_URL; inspect: ax402 inspect url --url GATEWAY_URL
- MCP: ax402_pay_url (requires AX402_EVM_PRIVATE_KEY)
- Browser SPA: https://staging.ax402.io/guides/react-paywall

## Auth
1. POST /auth/signup or /auth/login → JWT
2. POST /auth/verify-email (required before writes)
3. POST /auth/api-keys with scopes → ax402_live_... key
4. Header: X-API-Key: ax402_live_...

Env: AX402_BASE_URL, AX402_API_KEY (or AX402_JWT for CLI), AX402_EVM_PRIVATE_KEY (buyer)

## Documentation
- Overview: https://staging.ax402.io/guides/overview — Documentation hub and integration paths
- Agent guide: https://staging.ax402.io/guides/agents — Bootstrap, recipes, scope presets
- CLI reference: https://staging.ax402.io/api-reference/cli — Full ax402 command reference
- MCP server: https://staging.ax402.io/api-reference/mcp — Cursor / Claude agent tools
- Control plane API: https://staging.ax402.io/api-reference/control-plane — REST contract, auth
- Buyer clients: https://staging.ax402.io/guides/buyers — Pay gateway URLs from code
- React paywall: https://staging.ax402.io/guides/react-paywall — In-app paywall overlay
- SDK overview: https://staging.ax402.io/guides/sdks — Control plane + buyer across languages
- Gateway & dashboard: https://staging.ax402.io/guides/gateway-wrap — Hosted gateway setup
- Plugins: https://staging.ax402.io/guides/plugins — WordPress, WooCommerce, Shopify

## Seller dashboard
https://docs.staging.ax402.io/dashboard

## Protocol
Payment signing and settlement: https://github.com/x402-foundation/x402
AxLabs testnet facilitator: https://ax402.testnet.app.mf.axlabs.net