Install: `npm install -g @ozma_app/cli` or run via npx. ```bash npx @ozma_app/cli --help ``` Install hub: [https://ozma.app/connect](https://ozma.app/connect) **Package:** `@ozma_app/cli` — in-repo v0.2.0+; published versions may lag. ## Config Path: **`~/.ozma/config.json`** | Field | Purpose | |-------|---------| | `apiKey` | `ozma_live_…` — required for `ozma call` | | `sessionToken` | `sess_…` — control plane; preferred when both set | | `apiUrl` | Default `https://api.ozma.app` | | `gatewayUrl` | Default `https://gateway.ozma.app` | Env overrides: `OZMA_API_URL`, `OZMA_GATEWAY_URL`. All commands support **`--json`**. API failures exit code **1** with `{ ok: false }`. ## Auth | Command | Description | |---------|-------------| | `ozma login [--key] [--email] [--code]` | Browser, paste key, or OTP login | | `ozma logout [--all]` | End session; `--all` clears API key too | | `ozma signup --email [--name]` | Human signup — **Turnstile required in prod; CLI rejected** — use web or `login --email` | | `ozma verify --token` | Email verification token exchange | | `ozma register` | Auto-register key (**0 credits**) | | `ozma whoami` | `GET /v1/me` | ## Profile & providers | Command | Description | |---------|-------------| | `ozma profile show\|update […]` | Own org profile | | `ozma providers [slug] [--q]` | Public provider directory | ## Catalog & market | Command | Description | |---------|-------------| | `ozma categories` | Category list | | `ozma search [--category] [--sort]` | Search | | `ozma inspect [--schema\|--stats\|--history\|--ranks\|--endpoints\|--openapi]` | API detail views | | `ozma leaderboard [--category]` | Merit boards | | `ozma market overview\|activity [--limit]` | Market summary / activity feed | | `ozma request-api --query [--email] [--notes]` | Request missing API | Boards: `top_grossing`, `most_used`, `most_reliable`, `best_value`, `trending`, `new_rising`. ## Consumer — keys, call, usage | Command | Description | |---------|-------------| | `ozma provision [slug]` | Register if no key | | `ozma call …` | Gateway proxy (API key only) | | `ozma terms show\|status\|accept ` | Provider terms (`accept` needs session) | | `ozma usage [--from] [--to]` | Usage history | | `ozma keys list\|create\|revoke\|patch` | Key management | | `ozma budget set [--key] [--budget] [--per-call-max] [--daily-cap] [--approval-mode]` | Spend caps | | `ozma balance` | Credit balance | Key create/patch flags: `--name`, `--scopes`, `--budget`, `--per-call-max`, `--daily-cap`, `--approval-mode`. ## Billing | Command | Maps to | |---------|---------| | `ozma billing status` | `GET /v1/billing/balance` | | `ozma billing packs` | `GET /v1/billing/packs` | | `ozma billing setup` | SetupIntent — human confirms card | | `ozma billing portal` | Billing Portal URL | | `ozma billing checkout [--pack\|--amount]` | Stripe Checkout | | `ozma billing auto-reload --enable\|--disable [--threshold] [--amount]` | Auto-reload | ## Provider | Command | Maps to | |---------|---------| | `ozma provider list\|get ` | List/detail | | `ozma provider create [--rapidapi]` | Import OpenAPI | | `ozma provider patch [--name] [--summary] …` | Metadata | | `ozma provider credentials --secret [--injection] [--injection-name]` | Upstream secret | | `ozma provider pricing [--file\|--endpoint-id --price-cents]` | Pricing | | `ozma provider pricing-cancel ` | Cancel pending increase | | `ozma provider verify ` | Smoke test | | `ozma provider publish [--skip-verify] --accept-terms` | Go live | | `ozma provider unpublish ` | Live → draft | | `ozma provider connect` | Stripe Connect onboard | | `ozma provider analytics` | Provider stats | | `ozma provider documents list\|create\|activate` | Legal documents | Alias: `ozma publish ` = `ozma provider create`. ### Documents examples ```bash ozma provider documents create \ --kind t

Recommended

Manual MCP (Cursor example)

Browser install hub

Recommended

Manual MCP (Cursor example)

Browser install hub