# Quickstart (agent)

## One-command install

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

Detects Cursor, Claude Code, Codex, VS Code, Windsurf, Cline, Gemini, Zed, and Claude Desktop. Install hub: [https://ozma.app/connect](https://ozma.app/connect)

## MCP endpoint

- URL: `https://mcp.ozma.app/mcp`
- Auth: **OAuth 2.1** (recommended) or Bearer `ozma_live_…`
- Echo `Mcp-Session-Id` header for persistent identity

Production rejects unauthenticated MCP requests.

## OAuth vs Bearer

| Mode | When to use |
|------|-------------|
| **OAuth** | Interactive agents — email OTP proves ownership; full scopes on approve |
| **Bearer key** | Scripts/CI — use email-verified key with required scopes |

Auto-register via MCP `ozma_register` gives **0 credits** and consumer scopes until email verify elevates the key.

## Typical agent flow

1. **`discover_tools`** / **`search_apis`** — find listings
2. **`get_schema`** — proxy paths and parameters
3. **`provision_access`** — ensure API key exists
4. **`call_api`** — proxied call through gateway
5. **`get_provider_profile`** — trust context for the seller

CLI parity:

```bash
npx @ozma_app/cli register
npx @ozma_app/cli search "weather" --json
npx @ozma_app/cli call frankfurter /latest --query from=USD --query to=EUR --json
```

## Human billing boundary

Agents autonomously handle discovery, schema inspection, free API calls, keys, and budgets. These require a **human in a browser**:

- First payment method (SetupIntent / Billing Portal)
- Stripe Connect KYC for paid provider payouts
- Accepting **required** provider terms (`428` gate)

See [Billing guide](/docs/guides/billing) and [Authentication](/docs/getting-started/authentication).

## Machine-readable onboarding

Full agent playbook: [https://ozma.app/onboarding.md](https://ozma.app/onboarding.md)

Catalog index: [https://ozma.app/llms.txt](https://ozma.app/llms.txt)

Full docs corpus: [https://ozma.app/llms-full.txt](https://ozma.app/llms-full.txt)

## Next

- [Agent MCP loop example](/docs/examples/agent-mcp-loop)
- [MCP reference](/docs/reference/mcp)
- [CLI reference](/docs/reference/cli)