# Launa

> Launa makes a business ready for agents. Connect once, from discovery to settlement. Dashboard, gateway, payments, SDKs, CLI, MCP, and React paywall. Payment protocol: x402.

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

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

## Buyer (pay gateway URLs)
- Buyer clients: https://docs.staging.launa.io/guides/buyers
- Example gateway URL: https://my-api.launa.io/v1/foo
- TypeScript: @launa/sdk/buyer — buyerClientFromEnv(), client.pay({ url })
- Go: github.com/AxLabs/launa-sdks/go/buyer — NewFromPrivateKey, Get(ctx, url)
- Python: launa_sdk.buyer — BuyerClient.from_env().get(url); install from github.com/AxLabs/launa-sdks/packages/python
- CLI: launa pay url --url GATEWAY_URL; inspect: launa inspect url --url GATEWAY_URL
- MCP: launa_pay_url (requires LAUNA_EVM_PRIVATE_KEY)
- Browser SPA: https://docs.staging.launa.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 → launa_live_... (production) or launa_sandbox_... (Sandbox)
4. Header: X-API-Key: launa_live_... | launa_sandbox_...  (JWT: X-Launa-Environment: development for Sandbox)

Pairing (API keys): launa_sandbox_... → https://api.staging.launa.io; launa_live_... → https://api.launa.io (CLI/MCP default). Mismatch → 401 invalid token (not insufficient scope).

Env: LAUNA_BASE_URL, LAUNA_API_KEY (or LAUNA_JWT for CLI), LAUNA_ENVIRONMENT / LAUNA_SANDBOX, LAUNA_EVM_PRIVATE_KEY (buyer)

## Sandbox (Test mode)
- Guide: https://docs.staging.launa.io/guides/sandbox
- Network: eip155:845320402 (Anvil Base mainnet fork)
- RPC: https://rpc-dev.launa.io
- Wallet: GET /sandbox-wallet (JWT + development) or launa --sandbox sandbox-wallet get --json --wait
- Create APIs with launa_sandbox_... key or --sandbox; accepts must use eip155:845320402

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

## Seller dashboard
https://staging.launa.io/dashboard

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