---
title: "Coverage Cat Developer Quickstart"
description: "Coverage Cat quickstart with consumer and delegated discovery JSON, OpenAPI, runtime markdown skills, auth setup, and sandbox-first guidance."
canonical: "https://www.coveragecat.com/developers/quickstart"
last-updated: "2026-11-17"
---

# Coverage Cat Developer Quickstart

## 1. Choose the MCP endpoint for your host

In ChatGPT, use the dedicated streamable HTTP transport:

```
https://www.coveragecat.com/api/chatgpt/mcp
```

Use only the tools advertised by that endpoint. Present the returned `checkout_url` or `payment_url` so the shopper can complete document uploads and final checkout on Coverage Cat's website. Stay on the ChatGPT connection for status and policy follow-up; do not switch endpoints to complete checkout.

For other manifest-aware MCP hosts, use the no-OAuth default consumer MCP manifest:

```
https://www.coveragecat.com/.well-known/mcp.json
```

For local Codex direct transport setup, use:

```
https://www.coveragecat.com/api/consumer/mcp
```

Agents on that default consumer MCP should stay on its subset:

- `umbrella_consumer_prefill`

- `consumer_intake_issues`
- `consumer_intake_patch`
- `umbrella_consumer_select`
- `umbrella_consumer_bind`
- `umbrella_consumer_attach`
- `umbrella_consumer_payment`
- `umbrella_consumer_policy`
- `umbrella_consumer_service`


- `homeowners_consumer_policy`
- `homeowners_consumer_service`

For umbrella, that subset stays valid through `payment_needed`, secure payment UI when available, `payment_url` fallback, authoritative policy reads, and shopper-approved policy-support previews or requests; do not switch to delegated tools just to reach checkout or aftercare. Use those shopper surfaces only for insurance purchase and policy support. Coverage Cat records connector origin and permitted purpose on these handoffs. For homeowners, use the existing authorized intake for policy status, documents, and support; new applications and quotes are retired.

## 2. Read the shopper-agent discovery document first

Fetch the consumer discovery JSON first:

```sh
curl https://www.coveragecat.com/api/consumer
```

That document points shopper-facing runtimes at the default consumer MCP, the consumer OpenAPI contract, the consumer status polling loop, and the direct follow-up URLs.

## 3. Download the shopper-safe consumer OpenAPI contract

Use whichever format your runtime prefers:

```sh
curl https://www.coveragecat.com/api/consumer/openapi.yaml
curl https://www.coveragecat.com/api/consumer/openapi.json
```

## 4. Read the delegated contract only when the flow actually needs operator auth

Delegated operator workflows still live on the `/api/agent` surface:

```sh
curl https://www.coveragecat.com/api/agent
curl https://www.coveragecat.com/api/agent/openapi.yaml
```

Use those delegated docs only when your runtime already has operator auth and is acting on behalf of its own customers rather than shopping for the human in chat.

## 5. Choose the right runtime skill

- Umbrella consumer + delegated handoff: `/api/agent/skill.md`
- Homeowners service retirement: `/api/agent/homeowners/skill.md`

The HTML guides at `/ai/skills`, `/ai/skills/umbrella`, and `/ai/skills/homeowners` provide more context for humans and search engines.

## 6. Set up auth only when the flow requires it

Read `/developers/auth` before you call any delegated umbrella endpoint. Coverage Cat issues operator-scoped bearer keys through the OTP flow:

```sh
POST /api/agent/key/request
POST /api/agent/key/confirm
POST /api/agent/key/rotate
```

Humans who need a browser-safe walkthrough should start with `/developers/get-api-key`.

## 7. Rehearse the supported sandbox flows before live traffic

Use the sandbox doc at `/developers/sandbox`. Coverage Cat supports:

- A full synthetic consumer umbrella sandbox using `sandbox: true` only on the first `/api/consumer/umbrella/prefill` call or `umbrella_consumer_prefill` tool call, then the same shopper-facing follow-up loop through issues, patch, select, bind, attach, payment, policy, service, and status


- A delegated umbrella API sandbox using `sandbox: true` only on the first draft call, limited to draft/quote/status rehearsal

## 8. Link your agent to the public guide and repo assets

Coverage Cat's public skills repo is `https://github.com/Coverage-Cat/skills`. Link agents to `/agents.txt`, `/.well-known/agents.txt`, `/AGENTS.md`, `/agents.md`, `/.well-known/agents.md`, `https://github.com/Coverage-Cat/skills/blob/skills/AGENTS.md`, and `https://github.com/Coverage-Cat/skills/tree/skills/skills` when you want them to work from the published instructions rather than a copied prompt.

## 9. Use the official Coverage Cat CLI when scripting from a shell

Coverage Cat also ships an official CLI project for discovery, MCP, read-only tools, and authenticated API requests:

- Docs: `/developers/cli`
- Package name: `@coveragecat/cli`
- Homebrew tap: `Coverage-Cat/coveragecat`
- Source: `https://github.com/Coverage-Cat/coveragecat-cli`
- Homebrew formula source: `https://raw.githubusercontent.com/Coverage-Cat/homebrew-coveragecat/main/Formula/coveragecat.rb`

## Multi-language starter samples

Coverage Cat's shopper-safe consumer discovery document is the fastest starting point for a personal shopping agent. From there, call the consumer-prefill flow instead of sending the shopper straight to `/umbrella`.

```sh
curl https://www.coveragecat.com/api/consumer
curl -X POST https://www.coveragecat.com/api/consumer/umbrella/prefill \
  -H "Content-Type: application/json" \
  -H "Coverage-Cat-API-Version: v1" \
  -H "Idempotency-Key: demo-consumer-prefill-1" \
  -d '{"credit_consent_pending":true,"intake":{"full_name":"Taylor Example","email":"taylor@example.test","address":{"street":"123 Main St","city":"San Francisco","state":"CA","zip":"94107"}}}'
```

```javascript
const discovery = await fetch("https://www.coveragecat.com/api/consumer").then((response) => response.json());
console.log(discovery.preferred_openapi_url);
```

```python
import requests

discovery = requests.get("https://www.coveragecat.com/api/consumer", timeout=30).json()
print(discovery["preferred_openapi_url"])
```
