# MCP for COIOps

Connect your agent to COIOps over **authenticated HTTP MCP** (JSON-RPC 2.0).

## Endpoint

```
POST https://coiops.com/api/mcp
Authorization: Bearer coiops_<your_org_key>
Content-Type: application/json
```

Discover tools with `tools/list`, invoke with `tools/call`. Optional `prompts/list` and `resources/list`. Org API keys are created in **Settings → MCP keys** after sign-in (demo key from `npm run seed` locally).

## What tools do

Tools return **document scores** and gate status from certificates you store. They do **not** verify live coverage with carriers. `check_requirements` writes a score; it is not carrier confirmation. `request_updated_coi` sends email only when Resend or SMTP is configured.

Confirm-gated writes: `block_vendor_if_noncompliant`, `set_gate_status` (pass `confirm: true`).

Idempotency: send `Idempotency-Key` on `ingest_coi_pdf`, `request_updated_coi`, `set_gate_status`.

## Metering

Tool calls log billable units (read = 1, write = 5, heavy = 25). Free: 500 units/mo read-heavy. Pro: 10,000 units/mo including writes. OAuth PRM: `/.well-known/oauth-protected-resource` (Bearer org API keys — interactive OAuth not enabled). Unauthenticated POST returns 401 with `WWW-Authenticate` `resource_metadata`.

Cross-origin browser MCP hosts (e.g. claude.ai, chatgpt.com, localhost) may call `GET`/`POST /api/mcp` when sending `Authorization: Bearer coiops_…` — no cookies; see `cors` field on `GET /api/mcp`.

## Client config (HTTP-capable MCP hosts)

```json
{
  "mcpServers": {
    "coiops": {
      "url": "https://coiops.com/api/mcp",
      "headers": {
        "Authorization": "Bearer coiops_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}
```

Hosts that only support stdio need a local HTTP bridge; see your client docs. Do not commit real keys.

## For AI agents

Start from [llms.txt](https://coiops.com/llms.txt) for curated links. Full tool parameter reference lives in the repository `docs/MCP.md`.

## Links

- HTML page: https://coiops.com/mcp
- Docs: https://coiops.com/docs
- Pricing: https://coiops.com/pricing.md