# Ax402

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

## Agent entry points
- Agent guide: https://docs.ax402.io/guides/agents
- CLI reference: https://docs.ax402.io/api-reference/cli
- MCP server: https://docs.ax402.io/api-reference/mcp
- OpenAPI contract: https://github.com/AxLabs/ax402-clients/blob/main/openapi/openapi.json
- SDKs repository: https://github.com/AxLabs/ax402-sdks

## npm packages
- @ax402/sdk — https://www.npmjs.com/package/@ax402/sdk
- @ax402/cli — https://www.npmjs.com/package/@ax402/cli
- @ax402/mcp-server — https://www.npmjs.com/package/@ax402/mcp-server
- @ax402/react-paywall — https://www.npmjs.com/package/@ax402/react-paywall

## Buyer (pay gateway URLs)
- Buyer clients: https://docs.ax402.io/guides/buyers
- Example gateway URL: https://my-api.ax402.io/v1/foo
- TypeScript: @ax402/sdk/buyer — buyerClientFromEnv(), client.pay({ url })
- Go: github.com/AxLabs/ax402-sdks/go/buyer — NewFromPrivateKey, Get(ctx, url)
- Python: ax402_sdk.buyer — BuyerClient.from_env().get(url); install from github.com/AxLabs/ax402-sdks/packages/python
- 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://docs.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://docs.ax402.io/guides/overview — Documentation hub and integration paths
- Agent guide: https://docs.ax402.io/guides/agents — Bootstrap, recipes, scope presets
- CLI reference: https://docs.ax402.io/api-reference/cli — Full ax402 command reference
- MCP server: https://docs.ax402.io/api-reference/mcp — Cursor / Claude agent tools
- Control plane API: https://docs.ax402.io/api-reference/control-plane — REST contract, auth
- Buyer clients: https://docs.ax402.io/guides/buyers — Pay gateway URLs from code
- React paywall: https://docs.ax402.io/guides/react-paywall — In-app paywall overlay
- SDK overview: https://docs.ax402.io/guides/sdks — Control plane + buyer across languages
- Gateway & dashboard: https://docs.ax402.io/guides/gateway-wrap — Hosted gateway setup

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

## Protocol
Payment signing and settlement: https://github.com/x402-foundation/x402