Coverage Cat

Get consumer intake status

consumer_intake_issues

Read the status of an umbrella application or an existing homeowners policy. Records request attribution and rotates follow-up access. In the umbrella sandbox, polling advances checkout and can create a synthetic policy; it does not issue real coverage. Returns the intake's status and detail_status, whether the application is submitted, the staged review and next_question, quoted offers with their selection_token, and any post-choose, payment, policy, or conversation state. Reuse uid and the latest intake_access_token from the previous successful Coverage Cat response on each follow-up. MCP 2026-07-28 is stateless and requires that token. Legacy MCP hosts may also preserve hidden shopper session authorization. Keep tokens private and stay on this same MCP follow-up tool. Stay on the default consumer-operated subset and, before submission, say explicitly that the application is not submitted yet. For umbrella, keep missing fields hidden until Coverage Cat stages the single pre-submit review turn, then ask only for the explicitly missing shopper-owned fields in next_question and invite corrections instead of re-keying reviewed values. Coverage Cat will not resume or expose a prior consumer umbrella draft based on email alone. Continue an existing consumer draft only through the issued uid plus the current hidden MCP session or latest intake_access_token handoff. Normalize shopper birthdays from MM-DD-YYYY to YYYY-MM-DD before you patch Coverage Cat.

Input Schema

Name	Required	Description	Default
`uid`	Yes	Coverage Cat intake uid for the existing authorized intake or returned by `umbrella_consumer_prefill` and echoed on every follow-up response. Reuse it for each follow-up call on the same application.
`intake_access_token`	No	Send the latest intake_access_token from the previous successful Coverage Cat response on each follow-up. Required for stateless MCP 2026-07-28 requests; also accepted by legacy hosts. Keep it private and never show it to the shopper.

Output Schema

Name	Required	Description
`uid`	Yes	Coverage Cat intake uid for the current handoff.
`line`	No
`offers`	No
`policy`	No
`review`	No	Structured review card or selected-offer review block.
`schema`	No	Supplemental schema hints for homeowners review payloads.
`status`	Yes
`sandbox`	No	True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.
`support`	No
`uploaded`	No
`documents`	No
`expires_at`	No	When the current consumer handoff expires.
`offers_url`	No	Coverage Cat browser URL for the selected offer or offer-tracking page.
`payment_ui`	No
`next_action`	No	A structured hint for the next allowed tool or endpoint action.
`payment_url`	No	Coverage Cat browser URL for secure payment fallback.
`post_choose`	No	Structured post-choose state after a quoted umbrella offer is selected.
`conversation`	No
`review_items`	No
`review_token`	No	Opaque review token for delegated review-style submit paths.
`verification`	No
`detail_status`	No
`known_summary`	No	Structured facts Coverage Cat can safely summarize at this stage.
`next_question`	No	The current shopper-owned question bundle or bind-stage question.
`offer_summary`	No
`payment_setup`	No
`preview_token`	No	Opaque bind-preview token for the next homeowners bind confirmation.
`missing_fields`	No	Structured missing-value hints for homeowners pre-submit review.
`payment_status`	No
`pending_fields`	No	Structured missing-value hints for umbrella pre-submit review.
`selected_offer`	No
`uploaded_count`	No
`field_estimates`	No
`service_preview`	No
`service_request`	No
`purchase_preview`	No
`response_summary`	No
`review_estimates`	No
`service_requests`	No
`agent_instructions`	No
`poll_after_seconds`	No
`selection_guidance`	No	Guidance for completing an offer choice in one shopper-facing reply.
`compare_details_url`	No	Coverage Cat browser URL for compare-details follow-up.
`intake_access_token`	No	Short-lived follow-up bearer. On REST, send it back as Authorization for the next `/api/intake/{uid}` call. On MCP, retry the same follow-up tool with this token only when your host cannot preserve Coverage Cat's hidden shopper session. Never display it to the shopper.
`notification_channel`	No
`user_action_required`	No
`application_submitted`	No
`required_upload_types`	No
`credit_consent_question`	No
`credit_consent_disclosure`	No	Versioned canonical text that must be shown verbatim; echo version and text_hash with the user's response.
`payment_collection_supported`	No
`monoline_mvr_consent_question`	No
`contact_preferences_disclosures`	No	Optional versioned service-contact disclosures for the phone number on file; no marketing consent and no purchase requirement.
`monoline_mvr_consent_disclosure`	No	Versioned Monoline-specific text that must be shown verbatim with its source URL; echo version and text_hash with the user's response.

Schema Changelog

Changes observed during successful MCP inspections.

Changed10 schema fields changedNov 5, 2026

addedOutput schema / properties / contact_preferences_disclosures / properties / service_call / properties / source_updated_at
```
Added value: +{
+  "format": "date",
+  "type": "string"
+}
```
addedOutput schema / properties / contact_preferences_disclosures / properties / service_call / properties / source_url
```
Added value: +{
+  "format": "uri",
+  "type": "string"
+}
```
addedOutput schema / properties / contact_preferences_disclosures / properties / service_sms / properties / source_updated_at
```
Added value: +{
+  "format": "date",
+  "type": "string"
+}
```
addedOutput schema / properties / contact_preferences_disclosures / properties / service_sms / properties / source_url
```
Added value: +{
+  "format": "uri",
+  "type": "string"
+}
```
addedOutput schema / properties / credit_consent_disclosure / properties / source_updated_at
```
Added value: +{
+  "format": "date",
+  "type": "string"
+}
```
addedOutput schema / properties / credit_consent_disclosure / properties / source_url
```
Added value: +{
+  "format": "uri",
+  "type": "string"
+}
```

changedOutput schema / properties / detail_status / enum

Previous value: -[
-  "abandoned",
-  "blocked",
-  "bound",
-  "cancelled",
-  "chosen",
-  "credit_consent_pending",
-  "credit_consent_required",
-  "dev_success",
-  "documents_needed",
-  "documents_pending_review",
-  "email_sent",
-  "in_review",
-  "ineligible",
-  "info_requested",
-  "needs_more_info",
-  "needs_more_info_to_bind",
-  "no_policy",
-  "no_chosen_offer",
-  "no_quotes",
-  "no_selection",
-  "ok",
-  "payment_collection_ready",
-  "payment_needed",
-  "pending",
-  "pending_quotes",
-  "queued",
-  "quote_rate_limited",
-  "quoted",
-  "ready_for_review",
-  "ready_for_submission",
-  "ready_to_finalize",
-  "review_pending",
-  "service_preview",
-  "service_requested",
-  "sandbox_unsupported",
-  "stale_selection",
-  "verifying_documents",
-  "waiting_on_carrier",
-  "waiting_on_documents",
-  "waiting_on_payment"
-]New value: +[
+  "abandoned",
+  "blocked",
+  "bound",
+  "cancelled",
+  "chosen",
+  "credit_consent_pending",
+  "credit_consent_required",
+  "monoline_mvr_consent_required",
+  "dev_success",
+  "documents_needed",
+  "documents_pending_review",
+  "email_sent",
+  "in_review",
+  "ineligible",
+  "info_requested",
+  "needs_more_info",
+  "needs_more_info_to_bind",
+  "no_policy",
+  "no_chosen_offer",
+  "no_quotes",
+  "no_selection",
+  "ok",
+  "payment_collection_ready",
+  "payment_needed",
+  "pending",
+  "pending_quotes",
+  "queued",
+  "quote_rate_limited",
+  "quoted",
+  "ready_for_review",
+  "ready_for_submission",
+  "ready_to_finalize",
+  "review_pending",
+  "service_preview",
+  "service_requested",
+  "sandbox_unsupported",
+  "stale_selection",
+  "verifying_documents",
+  "waiting_on_carrier",
+  "waiting_on_documents",
+  "waiting_on_payment"
+]

addedOutput schema / properties / monoline_mvr_consent_disclosure

Added value: +{
+  "additionalProperties": false,
+  "description": "Versioned Monoline-specific text that must be shown verbatim with its source URL; echo version and text_hash with the user's response.",
+  "properties": {
+    "kind": {
+      "const": "monoline_mvr",
+      "type": "string"
+    },
+    "source_updated_at": {
+      "format": "date",
+      "type": "string"
+    },
+    "source_url": {
+      "format": "uri",
+      "type": "string"
+    },
+    "text": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "text_hash": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    },
+    "version": {
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind",
+    "version",
+    "text",
+    "text_hash",
+    "source_url",
+    "source_updated_at"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / monoline_mvr_consent_question
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / status / enum

Previous value: -[
-  "abandoned",
-  "blocked",
-  "bound",
-  "cancelled",
-  "chosen",
-  "credit_consent_pending",
-  "credit_consent_required",
-  "dev_success",
-  "documents_needed",
-  "documents_pending_review",
-  "email_sent",
-  "in_review",
-  "ineligible",
-  "info_requested",
-  "needs_more_info",
-  "needs_more_info_to_bind",
-  "no_policy",
-  "no_chosen_offer",
-  "no_quotes",
-  "no_selection",
-  "ok",
-  "payment_collection_ready",
-  "payment_needed",
-  "pending",
-  "pending_quotes",
-  "queued",
-  "quote_rate_limited",
-  "quoted",
-  "ready_for_review",
-  "ready_for_submission",
-  "ready_to_finalize",
-  "review_pending",
-  "service_preview",
-  "service_requested",
-  "sandbox_unsupported",
-  "stale_selection",
-  "verifying_documents",
-  "waiting_on_carrier",
-  "waiting_on_documents",
-  "waiting_on_payment"
-]New value: +[
+  "abandoned",
+  "blocked",
+  "bound",
+  "cancelled",
+  "chosen",
+  "credit_consent_pending",
+  "credit_consent_required",
+  "monoline_mvr_consent_required",
+  "dev_success",
+  "documents_needed",
+  "documents_pending_review",
+  "email_sent",
+  "in_review",
+  "ineligible",
+  "info_requested",
+  "needs_more_info",
+  "needs_more_info_to_bind",
+  "no_policy",
+  "no_chosen_offer",
+  "no_quotes",
+  "no_selection",
+  "ok",
+  "payment_collection_ready",
+  "payment_needed",
+  "pending",
+  "pending_quotes",
+  "queued",
+  "quote_rate_limited",
+  "quoted",
+  "ready_for_review",
+  "ready_for_submission",
+  "ready_to_finalize",
+  "review_pending",
+  "service_preview",
+  "service_requested",
+  "sandbox_unsupported",
+  "stale_selection",
+  "verifying_documents",
+  "waiting_on_carrier",
+  "waiting_on_documents",
+  "waiting_on_payment"
+]

Changed1 schema field changedNov 4, 2026

changedInput schema / properties / uid / description

Previous value: -"Coverage Cat intake uid returned by `umbrella_consumer_prefill` or `homeowners_consumer_prefill` and echoed on every follow-up response. Reuse it for each follow-up call on the same application."New value: +"Coverage Cat intake uid for the existing authorized intake or returned by `umbrella_consumer_prefill` and echoed on every follow-up response. Reuse it for each follow-up call on the same application."

Changed2 schema fields changedNov 4, 2026

addedOutput schema / properties / contact_preferences_disclosures

Added value: +{
+  "additionalProperties": false,
+  "description": "Optional versioned service-contact disclosures for the phone number on file; no marketing consent and no purchase requirement.",
+  "properties": {
+    "service_call": {
+      "additionalProperties": false,
+      "description": "Optional service-call disclosure; show its text verbatim before recording a choice.",
+      "properties": {
+        "kind": {
+          "const": "service_call",
+          "type": "string"
+        },
+        "text": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "text_hash": {
+          "pattern": "^[a-f0-9]{64}$",
+          "type": "string"
+        },
+        "version": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind",
+        "version",
+        "text",
+        "text_hash"
+      ],
+      "type": "object"
+    },
+    "service_sms": {
+      "additionalProperties": false,
+      "description": "Optional service-text disclosure; show its text verbatim before recording a choice.",
+      "properties": {
+        "kind": {
+          "const": "service_sms",
+          "type": "string"
+        },
+        "text": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "text_hash": {
+          "pattern": "^[a-f0-9]{64}$",
+          "type": "string"
+        },
+        "version": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind",
+        "version",
+        "text",
+        "text_hash"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / credit_consent_disclosure

Added value: +{
+  "additionalProperties": false,
+  "description": "Versioned canonical text that must be shown verbatim; echo version and text_hash with the user's response.",
+  "properties": {
+    "kind": {
+      "const": "credit_report",
+      "type": "string"
+    },
+    "text": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "text_hash": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    },
+    "version": {
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind",
+    "version",
+    "text",
+    "text_hash"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 31, 2026

addedOutput schema / properties / verification

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "instructions": {
+      "type": "string"
+    },
+    "request_tool": {
+      "type": "string"
+    },
+    "required": {
+      "type": "boolean"
+    },
+    "retry_after_seconds": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "status": {
+      "enum": [
+        "required",
+        "pending",
+        "verified",
+        "not_required"
+      ],
+      "type": "string"
+    },
+    "status_tool": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "required",
+    "retry_after_seconds",
+    "request_tool",
+    "status_tool",
+    "instructions"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 31, 2026

changedInput schema / properties / intake_access_token / description

Previous value: -"Bearer fallback for this same MCP follow-up tool when your host cannot preserve Coverage Cat's hidden shopper session. Send the intake_access_token from the previous successful Coverage Cat response and never show it to the shopper."New value: +"Send the latest intake_access_token from the previous successful Coverage Cat response on each follow-up. Required for stateless MCP 2026-07-28 requests; also accepted by legacy hosts. Keep it private and never show it to the shopper."

Changed2 schema fields changedOct 19, 2026

changedInput schema / properties / intake_access_token / description

Previous value: -"Optional bearer fallback for this same MCP follow-up tool when your host cannot preserve Coverage Cat's hidden shopper session. Reuse the latest token from the previous successful Coverage Cat response and never show it to the shopper."New value: +"Bearer fallback for this same MCP follow-up tool when your host cannot preserve Coverage Cat's hidden shopper session. Send the intake_access_token from the previous successful Coverage Cat response and never show it to the shopper."

addedInput schema / properties / uid / description

Added value: +"Coverage Cat intake uid returned by `umbrella_consumer_prefill` or `homeowners_consumer_prefill` and echoed on every follow-up response. Reuse it for each follow-up call on the same application."

First observedOct 17, 2026

TDQS

A4.1/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds substantial behavior beyond the annotations: it discloses that the call records request attribution and rotates follow-up access, that in the umbrella sandbox polling advances checkout and can create a synthetic policy without issuing real coverage, and that email alone cannot resume a prior draft. This directly explains why readOnlyHint=false and idempotentHint=false despite the read-like framing — exactly the kind of context annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The lead sentence is well front-loaded, but the body is a dense run-on mixing return-field enumeration, auth handoff rules, agent behavior scripts ('say explicitly that the application is not submitted yet'), and birthday normalization. Several clauses (birthday format normalization, a long list of returned state keys) do not belong in a status-read description and dilute the actionable parts.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, yet the description still spends a long clause enumerating return fields (detail_status, next_question, selection_token, etc.), which is redundant. Auth, sandbox, and draft-resumption edge cases are otherwise well covered for a stateful handoff tool, so an agent has enough to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and both parameters are fully documented in the schema, so baseline is 3. The description adds real meaning on top: it explains that the token rotates per response and must be the LATEST one from the previous successful response, and that uid must be carried across every call on the same application — operational semantics the schema states only tersely.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource: 'Read the status of an umbrella application or an existing homeowners policy,' and the follow-up framing ('reuse uid and the latest intake_access_token... on each follow-up') makes clear this is the status-poll endpoint rather than a patch/verify step. It does not name a sibling tool explicitly, so an agent must infer that consumer_intake_patch and consumer_intake_verify_email are the alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete operating conditions: reuse uid plus the latest token on every follow-up, stay on this same follow-up tool, stay on the default consumer-operated subset, and hold missing umbrella fields until the pre-submit review turn. The gaps are that it never states when NOT to call it (e.g. when to call consumer_intake_patch or umbrella_consumer_prefill instead) and the guidance is interleaved with return-field detail rather than organized.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Coverage Cat tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?