MCP tools
Remote MCP server tools, auth, and agent workflows.
View as Markdown →Endpoint: https://mcp.ozma.app/mcp
Install: npx @ozma_app/cli connect — https://ozma.app/connect
Connection
POST /mcp
Authorization: Bearer ozma_live_…
Mcp-Session-Id: <uuid>
Production requires OAuth 2.1 or Bearer API key. Unauthenticated requests return 401.
OAuth metadata: https://mcp.ozma.app/.well-known/oauth-protected-resource
Echo Mcp-Session-Id on subsequent requests for session key persistence (30-day TTL in KV).
Auth modes
| Mode | Best for |
|---|---|
| OAuth 2.1 | Interactive agents — email OTP proves ownership; mints full-scope key on approve |
Bearer ozma_live_… |
CI/scripts with pre-provisioned verified key |
Provider and billing tools need billing:write / provider:write — available after email verification or OAuth approve. Bare ozma_register keys return 403 until elevated.
Consumer tools
| Tool | Params | Action |
|---|---|---|
ozma_register |
— | POST /v1/register → key + 0 credits |
discover_tools |
query, category?, max_results? |
Context-efficient catalog search |
search_apis |
query, category?, sort?, max_price_cents? |
Full search |
get_categories |
— | Category list |
get_market_overview |
— | Market aggregates |
get_leaderboard |
board, category? |
Merit board |
request_api |
query, email?, notes? |
Catalog gap request |
get_api_details |
slug |
Listing detail |
get_schema |
slug |
Endpoints + schemas |
get_balance |
— | Billing balance |
create_checkout |
pack?, amount_cents? |
Stripe Checkout (billing:write) |
billing_portal |
— | Portal URL (billing:write) |
billing_setup |
— | SetupIntent (billing:write) — human must confirm card |
get_usage |
from?, to? |
Usage summary |
set_budget |
key_id?, budget_cents?, per_call_max_cents?, daily_cap_cents? |
Patch key caps |
provision_access |
slug? |
Ensure key exists |
call_api |
slug, endpoint, method?, input? |
Gateway proxy — 428 if required terms missing |
run_probe |
slug, endpoint, input? |
GET test call |
Provider tools
Requires provider:write.
| Tool | Params | Action |
|---|---|---|
provider_list_apis |
— | List draft/live APIs |
provider_get_api |
api_id |
Detail + pricing |
provider_create_api |
openapi_url?, rapidapi_url?, body? |
Create/import |
provider_update_api |
api_id, metadata… |
Patch listing |
provider_set_credentials |
api_id, secret, injection? |
Store upstream secret |
provider_set_pricing |
api_id, endpoints[] |
Price/discounts |
provider_verify |
api_id |
Upstream smoke test |
provider_publish |
api_id, skip_verify?, accept_terms? |
Go live — accept_terms: true required |
provider_unpublish |
api_id |
Live → draft |
provider_cancel_pending_pricing |
api_id, endpoint_id |
Cancel scheduled increase |
provider_analytics |
— | GMV + payout stats |
provider_connect_onboard |
— | Stripe Connect URL — human KYC |
Profile tools
| Tool | Params | Action |
|---|---|---|
list_providers |
query?, limit?, offset? |
Public directory |
get_provider_profile |
slug |
Trust badges + APIs |
get_my_profile |
— | Own profile (provider:write) |
update_my_profile |
profile fields… | Patch profile (provider:write) |
Terms & documents
Dedicated MCP tools are not yet registered. Use REST or CLI:
| Role | CLI |
|---|---|
| Consumer | ozma terms show|status|accept <slug> |
| Provider | ozma provider documents list|create|activate |
REST: GET /v1/apis/:slug/terms, POST …/terms/accept, POST/GET /v1/provider/documents.
Human steps for billing / Connect
| Tool | Human action |
|---|---|
billing_setup |
Confirm card in dashboard or Stripe.js |
billing_portal |
Open returned URL in browser |
create_checkout |
Complete Stripe Checkout in browser |
provider_connect_onboard |
Complete Stripe Express KYC |
Recommended flow
- Connect OAuth or verified key
discover_tools/search_apis→get_schema→call_api- For paid: human adds payment method; agent sets
set_budget - Provide:
provider_connect_onboard(human) →provider_create_api→ credentials → verify → pricing →provider_publishwithaccept_terms: true
Agent onboarding: https://ozma.app/onboarding.md