FAQ

Is Ozma a RapidAPI clone?

No. Ozma is agentic-first: MCP + CLI + SDK, transparent merit rankings (OzmaScore), governed spend per key, and one proxy key for the whole catalog. See Ozma vs RapidAPI.

Do I need a credit card?

Not for free catalog APIs (price_cents = 0) or while trial credits remain. Paid APIs after credits need a payment method (usage billing) or optional prepaid packs.

Can agents manage everything?

Agents cover most of the marketplace loop — discover, schema, call, keys, budgets, usage, and provider API lifecycle via MCP/CLI/SDK. Humans are still required for: adding the first payment method, Stripe Connect KYC (paid providers), and accepting required provider terms when the gateway returns 428.

What is the difference between API keys and sessions?

API keys work on both control plane and gateway. Sessions work on control plane only (dashboard, billing portal, terms acceptance). Gateway proxy calls always need ozma_live_….

How much are trial credits?

Human signup grants $1.00 (100 cents) after email verification. Agent auto-register (POST /v1/register) gets 0 credits but can call free APIs immediately.

Why did my gateway call return 401 with a session token?

Sessions are not accepted on gateway.ozma.app. Use your API key in Authorization: Bearer ozma_live_….

What is daily_cap_exceeded vs insufficient_budget?

Both are HTTP 402. daily_cap_exceeded means today's daily cap on the key was hit (resets UTC midnight). insufficient_budget means the lifetime key budget would be exceeded.

What does terms_acceptance_required (428) mean?

The provider requires accepting their API terms before proxy calls. Log in with a session and run ozma terms accept <slug> --yes as org owner/admin.

Can I publish an API without Stripe Connect?

Yes if all endpoints are free (price_cents = 0). Paid production APIs require Connect with payouts and transfers enabled.

What does publish --accept-terms mean?

It attests to Ozma platform/reseller terms — separate from optional provider-authored consumer terms documents you may activate later.

How does OzmaScore work?

Five usage-derived axes (reliability, retention, adoption, value, momentum) blend into a 0–100 score. Rankings cannot be purchased. See Merit engine.

Where are provider profiles?

Public pages at https://ozma.app/providers/{slug} with bio, links, trust badges, and live APIs. Provider profiles guide.

How do I install MCP for Cursor?

npx @ozma_app/cli connect

Or visit https://ozma.app/connect.

Why does ozma signup fail in the terminal?

Production signup requires Cloudflare Turnstile. Use web signup or ozma login --email instead.

What are Ozma's rate limits?

Control plane ~120/min; gateway ~300/min per key prefix. See Errors reference.

Is upstream data stored?

Successful proxy responses pass through to the caller; Ozma stores usage metadata (charges, latency, status) not full response bodies. Idempotency replay returns data: null.

Where is machine-readable documentation?

• https://ozma.app/llms.txt — catalog
• https://ozma.app/llms-full.txt — full docs
• https://ozma.app/onboarding.md — agent playbook
• Append .md to any /docs/… URL for raw markdown

Where are legal terms?

Ozma platform: Terms, Privacy, Legal hub.

Provider API terms: When active, shown on /apis/{slug}/terms. Required terms gate gateway calls until accepted.

How do I report a security issue?

Use the contact page at https://ozma.app/contact.

What take rate do providers pay?

Standard providers: 10% platform take (90% net). Founding providers: 0% take. See Pricing & payouts.