# 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](/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](/docs/concepts/merit).

## Where are provider profiles?

Public pages at `https://ozma.app/providers/{slug}` with bio, links, trust badges, and live APIs. [Provider profiles guide](/docs/guides/provider-profiles).

## How do I install MCP for Cursor?

```bash
npx @ozma_app/cli connect
```

Or visit [https://ozma.app/connect](https://ozma.app/connect).

## Why does ozma signup fail in the terminal?

Production signup requires Cloudflare Turnstile. Use [web signup](https://ozma.app/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](/docs/reference/errors).

## 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](https://ozma.app/llms.txt) — catalog
- [https://ozma.app/llms-full.txt](https://ozma.app/llms-full.txt) — full docs
- [https://ozma.app/onboarding.md](https://ozma.app/onboarding.md) — agent playbook
- Append `.md` to any `/docs/…` URL for raw markdown

## Where are legal terms?

**Ozma platform:** [Terms](/terms), [Privacy](/privacy), [Legal hub](/legal).

**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](https://ozma.app/contact).

## What take rate do providers pay?

Standard providers: **10%** platform take (**90%** net). Founding providers: **0%** take. See [Pricing & payouts](/docs/guides/pricing-payouts).