---
title: "Coverage Cat CLI"
description: "Coverage Cat CLI docs covering installation from source, the Coverage Cat Homebrew tap, discovery commands, MCP commands, and authenticated API requests."
canonical: "https://www.coveragecat.com/developers/cli"
last-updated: "2026-11-19"
---

# Coverage Cat CLI

## Coverage Cat CLI package

Coverage Cat maintains an official CLI project configured to publish as `@coveragecat/cli`.
The package source and release automation live in the public repo, while Homebrew installs come from the separate public tap.

The canonical sources live at:

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

## Install with Homebrew

Coverage Cat publishes a tap-ready formula in the public Homebrew tap:

```sh
brew tap Coverage-Cat/coveragecat
brew trust coverage-cat/coveragecat
brew install coveragecat
coveragecat help
```

## Install from npm

Coverage Cat publishes the official CLI package to the public npm registry:

```sh
npm install -g @coveragecat/cli
coveragecat help
```

## Install from the package source

If you want the package source directly:

```sh
git clone https://github.com/Coverage-Cat/coveragecat-cli.git
cd coveragecat-cli
package_tgz="$(npm pack --silent)"
npm install -g "./$package_tgz"
coveragecat help
```

## Feedback

Use `coveragecat feedback "Describe the issue"` to send product feedback to the
internal review queue without an operator key. For structured feedback, use
`coveragecat feedback --json '{"message":"Quote table is hard to read","category":"suggestion"}'`.
MCP exposes `submit_feedback`; REST accepts `POST /api/consumer/feedback`
or `POST /api/agent/feedback`. See the published OpenAPI for optional `tool`
and `request_id` fields. Omit personal information, credentials, and transcripts.
Feedback is available at any purchase stage and never changes application or policy state.

## What the Coverage Cat CLI covers

If Coverage Cat MCP tools are unavailable in a runtime that supports MCP, stop and ask a short choice question instead of telling the user to register `/.well-known/mcp.json` immediately.
Ask the question on its own line exactly as:

Would you like to install the Coverage Cat MCP (recommended) or use the REST/CLI tools instead?

After the user chooses MCP or asks for setup details, share the connection instructions for their host.

- `/api/agent` discovery
- `/api/agent/openapi.yaml` and `/openapi.json`
- Recommended default consumer MCP manifest and list operations
- Read-only calculator endpoints
- Generic authenticated requests to the agent-operable API surface

## Common commands

```sh
coveragecat discover
coveragecat openapi yaml
coveragecat mcp consumer tools
coveragecat tool home_calculator --json '{"zip":"90210","home_sqft":1800}'
coveragecat batch --json '{"operations":[{"tool":"home_calculator","input":{"zip":"90210","home_sqft":1800}}]}'
```

## Related docs

- `/developers/quickstart`
- `/developers/auth`
- `/developers/openapi`
- `/developers/mcp`
- `/developers/sandbox`

## 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"])
```
