Quickstart (agent)

Connect MCP or CLI, discover APIs, and call with governed spend.

One-command install

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

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

discover_tools / search_apis — find listings
get_schema — proxy paths and parameters
provision_access — ensure API key exists
call_api — proxied call through gateway
get_provider_profile — trust context for the seller

CLI parity:

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 and Authentication.

Machine-readable onboarding

Full agent playbook: https://ozma.app/onboarding.md

Catalog index: https://ozma.app/llms.txt

Full docs corpus: https://ozma.app/llms-full.txt