{"_meta":{"coverageCat":{"appVersion":"0.1.0","consumerCheckoutCapableLines":["umbrella"],"consumerHandoffToolsAuthentication":"none; Coverage Cat prefers the hidden MCP shopper session after prefill and also rotates an intake_access_token fallback for stateless hosts","consumerOperatedDefaultByLine":{"homeowners":["homeowners_consumer_prefill","consumer_intake_issues","consumer_intake_verify_email","consumer_intake_patch","homeowners_consumer_select","homeowners_consumer_bind","homeowners_consumer_policy","homeowners_consumer_service"],"umbrella":["umbrella_consumer_prefill","consumer_intake_issues","consumer_intake_verify_email","consumer_intake_patch","umbrella_consumer_select","umbrella_consumer_bind","umbrella_consumer_attach","umbrella_consumer_payment","umbrella_consumer_policy","umbrella_consumer_service"]},"consumerOperatedDefaultToolNames":["umbrella_consumer_prefill","homeowners_consumer_prefill","consumer_intake_issues","consumer_intake_verify_email","consumer_intake_patch","umbrella_consumer_select","umbrella_consumer_bind","umbrella_consumer_attach","umbrella_consumer_payment","umbrella_consumer_policy","umbrella_consumer_service","homeowners_consumer_select","homeowners_consumer_bind","homeowners_consumer_policy","homeowners_consumer_service"],"consumerPortalHandoffLines":["homeowners"],"operatorServerCardUrl":"https://coveragecat.com/developers/mcp/operator/server-card.json","operatorServerUrl":"https://coveragecat.com/api/agent/mcp","readOnlyToolsAuthentication":"none","serverCardUrl":"https://coveragecat.com/.well-known/mcp/server-card.json","wellKnownUrl":"https://coveragecat.com/.well-known/mcp.json"}},"authentication":{"required":false,"schemes":["none"]},"capabilities":{"extensions":{"io.modelcontextprotocol/ui":{"mimeTypes":["text/html;profile=mcp-app"]}},"resources":{"listChanged":false},"tools":{"listChanged":false}},"description":"Help a personal insurance agent start Coverage Cat's real umbrella or homeowners shopping flows, use read-only calculators, and browse setup docs from one MCP connection.","documentationUrl":"https://coveragecat.com/developers/mcp","iconUrl":"https://coveragecat.com/images/general/med/logo-opengraph.webp","icons":[{"mimeType":"image/png","sizes":["1640x856"],"src":"https://coveragecat.com/images/general/original/logo-opengraph.png"}],"instructions":"Coverage Cat insurance MCP for real consumer umbrella/homeowners shopping. This default server is intentionally the no-auth consumer/read-only surface. If Coverage Cat MCP tools are unavailable in a runtime that supports MCP, stop and ask a short choice question. Ask the question on its own line exactly as:\n\nWould you like to install the Coverage Cat MCP (recommended) or use the REST/CLI tools instead?\nIf the shopper wants Coverage Cat to shop for or buy umbrella insurance, start with `umbrella_consumer_prefill`, not the read-only umbrella calculator, then stay on the same consumer subset through quoted offers, declarations upload, payment_needed, optional agentic payment collection, payment_url fallback, and post-bind policy/support follow-up with `consumer_intake_issues`, `consumer_intake_patch`, `umbrella_consumer_select`, `umbrella_consumer_bind`, `umbrella_consumer_attach`, `umbrella_consumer_payment`, `umbrella_consumer_policy`, and `umbrella_consumer_service`. Use `sandbox: true` only on the first umbrella prefill call for a synthetic rehearsal, and try `umbrella_consumer_payment` first when Coverage Cat returns `payment_needed`.\nFor homeowners, start with `homeowners_consumer_prefill`, stay on the same subset through `homeowners_consumer_select`, `homeowners_consumer_bind`, `homeowners_consumer_policy`, and `homeowners_consumer_service`, keep polling because quotes or bind follow-up may take up to 48 hours, and answer `conversation.reply_pending` in chat with `consumer_intake_patch` and `message_reply`. Homeowners payment or signing links must go to the customer email on file.\nUntil submission, say explicitly that the application is not submitted yet. Use `docs_list_topics`, `docs_search`, and `docs_get_resource` for quickstart, auth, sandbox, and OpenAPI help. Delegated MCP/OpenAPI: https://coveragecat.com/api/agent/mcp and https://coveragecat.com/api/agent/openapi.yaml. Consumer REST/OpenAPI: https://coveragecat.com/api/consumer and https://coveragecat.com/api/consumer/openapi.yaml.","name":"coverage-cat-product-mcp","protocolVersion":"2026-07-28","protocolVersions":["2026-07-28","2025-11-25"],"resourceCount":24,"resources":[{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for home insurance calculator.","mimeType":"text/html;profile=mcp-app","name":"Home insurance calculator","title":"Home insurance calculator","uri":"ui://coveragecat/tools/v2/home-calculator"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for umbrella insurance calculator.","mimeType":"text/html;profile=mcp-app","name":"Umbrella insurance calculator","title":"Umbrella insurance calculator","uri":"ui://coveragecat/tools/v2/umbrella-calculator"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for auto insurance estimates.","mimeType":"text/html;profile=mcp-app","name":"Auto insurance estimates","title":"Auto insurance estimates","uri":"ui://coveragecat/tools/v2/auto-estimates"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for collision and comprehensive coverage calculator.","mimeType":"text/html;profile=mcp-app","name":"Collision and comprehensive coverage calculator","title":"Collision and comprehensive coverage calculator","uri":"ui://coveragecat/tools/v2/collision-and-comprehensive-coverage"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for auto claim filing break-even calculator.","mimeType":"text/html;profile=mcp-app","name":"Auto claim filing break-even calculator","title":"Auto claim filing break-even calculator","uri":"ui://coveragecat/tools/v2/file-a-claim"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for homeowners agent finder.","mimeType":"text/html;profile=mcp-app","name":"Homeowners agent finder","title":"Homeowners agent finder","uri":"ui://coveragecat/tools/v2/homeowners-agent-finder"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for umbrella coverage limit planner.","mimeType":"text/html;profile=mcp-app","name":"Umbrella coverage limit planner","title":"Umbrella coverage limit planner","uri":"ui://coveragecat/tools/v2/umbrella-limit-planner"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for umbrella underlying limit checker.","mimeType":"text/html;profile=mcp-app","name":"Umbrella underlying limit checker","title":"Umbrella underlying limit checker","uri":"ui://coveragecat/tools/v2/umbrella-underlying-limit-check"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for calculators and delegated insurance workflows.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive Coverage Cat MCP app for standalone umbrella vs. bundle calculator.","mimeType":"text/html;profile=mcp-app","name":"Standalone umbrella vs. bundle calculator","title":"Standalone umbrella vs. bundle calculator","uri":"ui://coveragecat/tools/v2/umbrella-bundle-comparison"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com","https://api.stripe.com","https://m.stripe.network","https://r.stripe.com"],"frame_domains":["https://js.stripe.com","https://hooks.stripe.com"],"resource_domains":["https://js.stripe.com","https://m.stripe.network"]},"openai/widgetDescription":"Secure Coverage Cat MCP app for Stripe payment-method collection.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com","https://api.stripe.com","https://m.stripe.network","https://r.stripe.com"],"frameDomains":["https://js.stripe.com","https://hooks.stripe.com"],"resourceDomains":["https://js.stripe.com","https://m.stripe.network"]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Secure MCP app for consumer umbrella Stripe payment-method collection.","mimeType":"text/html;profile=mcp-app","name":"Coverage Cat umbrella payment app","title":"Coverage Cat umbrella payment app","uri":"ui://coveragecat/umbrella-payment"},{"_meta":{"openai/widgetCSP":{"connect_domains":["https://coveragecat.com"],"frame_domains":[],"resource_domains":[]},"openai/widgetDescription":"Interactive Coverage Cat MCP app for documentation and onboarding resources.","openai/widgetDomain":"https://coveragecat.com","openai/widgetPrefersBorder":true,"ui":{"csp":{"connectDomains":["https://coveragecat.com"],"frameDomains":[],"resourceDomains":[]},"domain":"https://coveragecat.com","prefersBorder":true},"ui/domain":"https://coveragecat.com","ui/prefersBorder":true},"description":"Interactive MCP app for browsing Coverage Cat docs topics, skills, and API artifacts inside an agent host.","mimeType":"text/html;profile=mcp-app","name":"Coverage Cat docs browser app","title":"Coverage Cat docs browser app","uri":"ui://coveragecat/docs/browser/v2"},{"description":"Coverage Cat quickstart with consumer and delegated discovery JSON, OpenAPI, runtime markdown skills, auth setup, and sandbox-first guidance.","mimeType":"text/markdown","name":"Coverage Cat Developer Quickstart","title":"Coverage Cat Developer Quickstart","uri":"coveragecat://developers/quickstart"},{"description":"Coverage Cat connector data-handling notice covering permitted purpose, prohibited uses, precedence over broader site terms for connector-submitted data, revocation, retention expectations, and support paths.","mimeType":"text/markdown","name":"Coverage Cat Connector Data Handling","title":"Coverage Cat Connector Data Handling","uri":"coveragecat://developers/data-handling"},{"description":"Coverage Cat auth docs covering service-owned agent identity claims, OAuth token exchange, OTP compatibility flows, and where delegated umbrella and homeowners flows require authenticated operator credentials.","mimeType":"text/markdown","name":"Coverage Cat OAuth and Agent Auth","title":"Coverage Cat OAuth and Agent Auth","uri":"coveragecat://developers/auth"},{"description":"Coverage Cat OpenAPI and discovery docs covering shopper-safe consumer and delegated JSON discovery entry points, YAML and JSON contracts, markdown mirrors, and related llms.txt files.","mimeType":"text/markdown","name":"Coverage Cat OpenAPI and Discovery Docs","title":"Coverage Cat OpenAPI and Discovery Docs","uri":"coveragecat://developers/openapi"},{"description":"Coverage Cat sandbox docs covering the full synthetic consumer umbrella sandbox, the homeowners browser sandbox, delegated homeowners and umbrella API sandbox semantics, and recommended pre-production checks.","mimeType":"text/markdown","name":"Coverage Cat Sandbox and Testing","title":"Coverage Cat Sandbox and Testing","uri":"coveragecat://developers/sandbox"},{"description":"Coverage Cat webhook status page explaining that public agent integrations should poll the documented status endpoints instead of relying on a public callback system.","mimeType":"text/markdown","name":"Coverage Cat Webhook Status","title":"Coverage Cat Webhook Status","uri":"coveragecat://developers/webhooks"},{"description":"Coverage Cat MCP setup for ChatGPT website checkout, default consumer registration, local Codex transport, delegated operator OAuth, and streamable HTTP behavior.","mimeType":"text/markdown","name":"Coverage Cat MCP Setup","title":"Coverage Cat MCP Setup","uri":"coveragecat://developers/mcp"},{"description":"Shopper-safe discovery document for consumer-prefill handoffs and direct follow-up without delegated operator auth.","mimeType":"application/json","name":"Coverage Cat consumer discovery JSON","title":"Coverage Cat consumer discovery JSON","uri":"coveragecat://api/consumer/discovery"},{"description":"Markdown mirror of Coverage Cat's shopper-agent discovery surface.","mimeType":"text/markdown","name":"Coverage Cat consumer discovery markdown","title":"Coverage Cat consumer discovery markdown","uri":"coveragecat://api/consumer/discovery.md"},{"description":"Shopper-safe OpenAPI contract for consumer-prefill, coarse status polling, and direct intake follow-up.","mimeType":"text/yaml","name":"Coverage Cat consumer OpenAPI YAML","title":"Coverage Cat consumer OpenAPI YAML","uri":"coveragecat://api/consumer/openapi.yaml"},{"description":"JSON serialization of the shopper-agent Coverage Cat OpenAPI contract.","mimeType":"application/json","name":"Coverage Cat consumer OpenAPI JSON","title":"Coverage Cat consumer OpenAPI JSON","uri":"coveragecat://api/consumer/openapi.json"},{"description":"Runtime markdown instructions for consumer-prefill and delegated umbrella purchase flows.","mimeType":"text/markdown","name":"Coverage Cat umbrella runtime skill","title":"Coverage Cat umbrella runtime skill","uri":"coveragecat://skills/umbrella"},{"description":"Runtime markdown instructions for consumer-prefill, browser-fallback, and delegated homeowners flows.","mimeType":"text/markdown","name":"Coverage Cat homeowners runtime skill","title":"Coverage Cat homeowners runtime skill","uri":"coveragecat://skills/homeowners"}],"serverCardUrl":"https://coveragecat.com/.well-known/mcp/server-card.json","serverInfo":{"description":"Help a personal insurance agent start Coverage Cat's real umbrella or homeowners shopping flows, use read-only calculators, and browse setup docs from one MCP connection.","icons":[{"mimeType":"image/png","sizes":["1640x856"],"src":"https://coveragecat.com/images/general/original/logo-opengraph.png"}],"name":"coverage-cat-product-mcp","title":"Coverage Cat Insurance","version":"0.1.0","websiteUrl":"https://coveragecat.com/developers/mcp"},"serverUrl":"https://coveragecat.com/api/consumer/mcp","title":"Coverage Cat Insurance","toolCount":27,"tools":[{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":false,"approvalScope":"none","classification":"write","sideEffects":["stores_application_draft","may_apply_field_estimates"]},"flow":"consumer_prefill","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/consumer/umbrella/prefill","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Preferred umbrella MCP entry point when a shopper wants Coverage Cat to shop for, compare, or buy umbrella insurance and no operator bearer token is present. On a cold start, call this before asking the shopper a questionnaire and assemble the fullest justified estimate from user-controlled context. Use canonical umbrella keys such as address.street/city/state/zip, license_state, license_number, approximate_asset_value or net_worth_numeric, desired_coverage_limit, required_coverage_e_limit, and vehicle_count or umbrella_details.motorized_vehicle_count. Do not send vehicles rows before submission. Stay on the same consumer-operated subset through `consumer_intake_issues`, `consumer_intake_patch`, `umbrella_consumer_select`, `umbrella_consumer_bind`, `umbrella_consumer_attach`, `umbrella_consumer_payment`, `umbrella_consumer_policy`, and `umbrella_consumer_service`. If you are rehearsing the shopper flow, set `sandbox: true` on this first prefill call only. That same consumer sandbox uid can then continue through the same shopper-safe flow. 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. Until later follow-up shows progress, tell the shopper the application is not submitted yet. 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.","inputSchema":{"additionalProperties":false,"properties":{"credit_consent_pending":{"const":true,"description":"Declares that this handoff starts before the shopper has given soft-credit-check consent, so do not ask about credit now. Coverage Cat requests that consent on `umbrella_consumer_select`, once the shopper picks an offer.","type":"boolean"},"field_estimates":{"description":"Provenance for intake values you inferred from context rather than heard from the shopper, one row per inferred value. On the initial umbrella handoff, add rows only for fields that already appear in the current umbrella review; otherwise send `intake` alone.","items":{"additionalProperties":true,"properties":{"confidence":{"description":"How strongly your source supports the inferred value.","enum":["low","medium","high"],"type":"string"},"field":{"description":"Intake dot-path of the inferred value, matching the key you sent under `intake`, such as `address.zip`.","type":"string"},"source":{"description":"Free-form label for where the inferred value came from, such as `policy_declarations`, `email_thread`, or a property-data provider.","type":"string"}},"required":["field","source","confidence"],"type":"object"},"type":"array"},"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_prefill request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake":{"additionalProperties":true,"description":"Fullest currently known consumer umbrella application patch. Use canonical keys such as address.street/city/state/zip, license_state, license_number, approximate_asset_value or net_worth_numeric, desired_coverage_limit, required_coverage_e_limit, and vehicle_count or umbrella_details.motorized_vehicle_count for umbrella counts. Do not send vehicles rows before submission.","properties":{"current_auto_coverages":{"description":"Which band the shopper's current underlying auto liability limits fall into: `500k/1m` covers $500k/$1 Million/$100k or higher; `500k/500k` covers $500k/$500k/$100k or $500k CSL; `300k/300k` covers $250k/$500k/$100k or $300k/$300k/$100k or $300k CSL; `100k/300k` covers $100k/$300k/$100k or lower. Pick the strongest band the shopper's actual limits fully satisfy. Underlying auto limits gate umbrella eligibility, so use `unsure` only when the shopper genuinely does not know their limits.","enum":["unsure","500k/1m","500k/500k","300k/300k","100k/300k"],"type":"string"}},"type":"object"},"sandbox":{"description":"Set true on this first prefill call to run a fully synthetic shopper rehearsal instead of a live application. The returned sandbox uid continues through the same consumer tool set.","type":"boolean"}},"required":["credit_consent_pending","intake"],"type":"object"},"name":"umbrella_consumer_prefill","outputSchema":{"additionalProperties":false,"properties":{"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"review_summary":{"additionalProperties":false,"description":"Current non-authoritative pre-submit checkpoint the agent may summarize before continuing in chat or opening a browser fallback. Unless a later follow-up response shows quote progress, treat this application as not submitted yet. If any shown value is estimated, mark that bullet or value with `*`, include the short note `* = estimated` once above and once below the list, and do not prefix every estimated line with `[Estimated]`.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"}},"required":["status"],"type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"uid":{"description":"Coverage Cat intake uid for MCP follow-up.","type":"string"}},"required":["uid","expires_at","review_summary","intake_access_token"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella consumer prefill handoff"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":false,"approvalScope":"none","classification":"write","sideEffects":["stores_application_draft","may_apply_field_estimates"]},"flow":"consumer_prefill","line":"homeowners","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/consumer/homeowners/prefill","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Preferred homeowners MCP entry point when a shopper wants Coverage Cat to shop for, compare, or buy homeowners insurance and no operator bearer token is present. On a cold start, ask only for the user's name, email, property address, and whether this should be standard homeowners, condo, or landlord coverage. If that coverage type is still unknown, ask the shopper to reply with exactly one of `standard homeowners`, `condo`, or `landlord`, then enrich from user-controlled context and property sources before handing off to Coverage Cat. Recover core shopper and occupancy facts from that context before relying on estimated review data. Stay on the same consumer-operated subset through review, quote polling, `homeowners_consumer_select`, `homeowners_consumer_bind`, `homeowners_consumer_policy`, and `homeowners_consumer_service`. Homeowners quotes or carrier bind follow-up may take up to 48 hours. If `consumer_intake_issues` returns `conversation.reply_pending`, answer in chat with `consumer_intake_patch` and `message_reply`. 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. Homeowners payment or signing links must be sent to the customer's own email inbox on file. Until submission, tell the shopper the application is not submitted yet.","inputSchema":{"additionalProperties":false,"properties":{"credit_consent_pending":{"const":true,"description":"Declares that this handoff starts before the shopper has given soft-credit-check consent, so do not ask about credit now. Coverage Cat requests that consent on the homeowners review turn.","type":"boolean"},"field_estimates":{"description":"Provenance for home values you inferred from context or property data rather than heard from the shopper, one row per inferred value. Coverage Cat stores the rows on the first `intake.home` row.","items":{"additionalProperties":true,"properties":{"confidence":{"description":"How strongly your source supports the inferred value.","enum":["low","medium","high"],"type":"string"},"field":{"description":"Name of the inferred field on the `intake.home` row, such as `home_sqft`.","type":"string"},"source":{"description":"Free-form label for where the inferred value came from, such as `policy_declarations`, `email_thread`, or a property-data provider.","type":"string"}},"required":["field","source","confidence"],"type":"object"},"type":"array"},"idempotency_key":{"description":"Key you generate to identify one logical homeowners_consumer_prefill request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake":{"additionalProperties":true,"description":"Fullest currently known homeowners application assembled from the user's own context: shopper name and email plus a `home` row (object or one-row array) with the property street, city, state, and zip, and the home_ownership and property_type that distinguish standard homeowners, condo, or landlord coverage.","type":"object"}},"required":["credit_consent_pending","intake"],"type":"object"},"name":"homeowners_consumer_prefill","outputSchema":{"additionalProperties":false,"properties":{"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"review_summary":{"additionalProperties":false,"description":"Current non-authoritative pre-submit checkpoint the agent may summarize before continuing in chat or opening a browser fallback. Unless a later follow-up response shows quote progress, treat this application as not submitted yet. If any shown value is estimated, mark that bullet or value with `*`, include the short note `* = estimated` once above and once below the list, and do not prefix every estimated line with `[Estimated]`.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"}},"required":["status"],"type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"uid":{"description":"Coverage Cat intake uid for MCP follow-up.","type":"string"}},"required":["uid","expires_at","review_summary","intake_access_token"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Start homeowners application"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":false,"approvalScope":"none","classification":"read","sideEffects":[]},"flow":"consumer_follow_up","preferredWithoutOperatorAuth":true,"restMethod":"GET","restUrl":"https://coveragecat.com/api/intake/{uid}/issues"}},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Continue a consumer-prefill homeowners or umbrella handoff in chat. 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 homeowners, treat `missing_fields` as hidden enrichment backlog, keep recovering context-backed facts, reserve one final review turn, and use `consumer_intake_patch` with `message_reply` when `conversation.reply_pending` surfaces insurer or shopper follow-up. 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.","inputSchema":{"additionalProperties":false,"properties":{"intake_access_token":{"description":"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.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"consumer_intake_issues","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Get consumer intake status"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["sends_verification_email"]},"flow":"consumer_follow_up","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/verify-email","supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"When consumer_intake_issues reports verification.required, ask the shopper whether to send a verification email, then call with confirm_send: true. The link goes only to the application's email on file. Ask the shopper to open it, then poll consumer_intake_issues until verification.required is false. Never ask the shopper to paste the login link or code into chat.","inputSchema":{"additionalProperties":false,"properties":{"confirm_send":{"const":true,"description":"Confirm that the shopper asked to send a verification link to their application's email on file.","type":"boolean"},"idempotency_key":{"description":"Key you generate to identify one logical consumer_intake_verify_email request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid","confirm_send"],"type":"object"},"name":"consumer_intake_verify_email","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Send shopper email verification"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["application_revision","coverage_change","effective_date_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["stores_application_updates","may_submit_application","may_trigger_quote_generation","may_send_follow_up_reply"]},"flow":"consumer_follow_up","preferredWithoutOperatorAuth":true,"restMethod":"PATCH","restUrl":"https://coveragecat.com/api/intake/{uid}","supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Patch or submit a consumer-prefill homeowners or umbrella handoff in chat. 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. For homeowners, use `intake` to add context-backed or property-backed answers while keeping the user out of a questionnaire until the one-time review, and after submission use `message_reply` plus optional `reply_to_message_id` for insurer or shopper follow-up surfaced under `conversation.messages`. For umbrella, use the staged review turn to send only explicitly missing shopper-owned details plus corrections, set `confirm_submission` only on that final review confirmation, do not send vehicles rows on this pre-submit patch, and do not ask for umbrella credit consent here. Normalize shopper birthdays from MM-DD-YYYY to YYYY-MM-DD, and tell the shopper the application is not submitted yet until you actually submit it. Returns the same follow-up payload as `consumer_intake_issues` for the updated intake.","inputSchema":{"additionalProperties":false,"properties":{"confirm_submission":{"description":"Set true only on the single final review turn.","type":"boolean"},"field_estimates":{"description":"Umbrella provenance for values in this same patch that you inferred rather than heard from the shopper, one row per inferred value. Add rows only when you are certain each field path matches a current umbrella review field.","items":{"additionalProperties":true,"properties":{"confidence":{"description":"How strongly your source supports the inferred value.","enum":["low","medium","high"],"type":"string"},"field":{"description":"Intake dot-path of the inferred value, matching the key you sent under `intake`, such as `address.zip`.","type":"string"},"source":{"description":"Free-form label for where the inferred value came from, such as `policy_declarations`, `email_thread`, or a property-data provider.","type":"string"}},"required":["field","source","confidence"],"type":"object"},"type":"array"},"idempotency_key":{"description":"Key you generate to identify one logical consumer_intake_patch request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake":{"additionalProperties":true,"description":"Top-level intake edits. For umbrella, send only missing shopper-owned details, corrections, or canonical umbrella count fixes such as umbrella_details.motorized_vehicle_count. Do not send vehicles rows on this pre-submit patch.","properties":{"current_auto_coverages":{"description":"Which band the shopper's current underlying auto liability limits fall into: `500k/1m` covers $500k/$1 Million/$100k or higher; `500k/500k` covers $500k/$500k/$100k or $500k CSL; `300k/300k` covers $250k/$500k/$100k or $300k/$300k/$100k or $300k CSL; `100k/300k` covers $100k/$300k/$100k or lower. Pick the strongest band the shopper's actual limits fully satisfy. Underlying auto limits gate umbrella eligibility, so use `unsure` only when the shopper genuinely does not know their limits.","enum":["unsure","500k/1m","500k/500k","300k/300k","100k/300k"],"type":"string"}},"type":"object"},"intake_access_token":{"description":"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.","type":"string"},"message_reply":{"description":"Homeowners post-submit only. Send the reply text Coverage Cat should deliver in-thread when consumer_intake_issues surfaced an insurer or shopper follow-up under conversation.messages.","type":"string"},"reply_to_message_id":{"description":"Homeowners post-submit message_id from conversation.messages[] that message_reply answers in-thread, when Coverage Cat returned a specific message to reply to.","type":"integer"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"consumer_intake_patch","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Update consumer intake"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["offer_revision","coverage_change","effective_date_change","price_change","um_uim_election_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["selects_offer","collects_soft_credit_consent","may_start_bind_follow_up"]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/select","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Continue the consumer-prefill umbrella flow after quotes are ready. 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 same consumer-operated MCP subset, use the returned selection_token, collect the real user's consent for a soft credit check here, and let Coverage Cat enter the normal post-choose workflow without switching to delegated tools. If the quote payload exposed selection_guidance.same_reply_requirements for the chosen offer, send those answers under intake on this first select call. If Coverage Cat still returns credit_consent_required with a bind-stage next_question, ask for both the soft-credit-check consent and those bind details in one shopper-facing turn, then retry this same tool with both credit_consent and intake.","inputSchema":{"additionalProperties":false,"properties":{"credit_consent":{"additionalProperties":false,"description":"Real-user consent for a soft credit check, collected on the selection turn when Coverage Cat asks for it.","properties":{"answer":{"description":"Records the shopper's own reply agreeing to Coverage Cat's credit_consent_question. Send it only after the shopper agrees in their own words.","enum":["Yes"],"type":"string"},"collected_from_user":{"const":true,"description":"Attests that the shopper personally answered the credit consent question in this conversation, rather than the agent assuming their consent.","type":"boolean"}},"required":["answer","collected_from_user"],"type":"object"},"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_select request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake":{"additionalProperties":true,"description":"Bind-stage answers for the current next_question, or the chosen offer's selection_guidance.same_reply_requirements, keyed by the field names Coverage Cat asked for. Send them when Coverage Cat asked for consent and bind details in the same shopper-facing turn.","type":"object"},"intake_access_token":{"description":"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.","type":"string"},"selection_confirmed":{"const":true,"description":"Attests that the shopper explicitly picked the offer named by selection_token in chat, rather than the agent choosing for them.","type":"boolean"},"selection_token":{"description":"selection_token of the shopper's chosen offer from `offers[]` in the latest quoted follow-up response.","type":"string"},"uid":{"description":"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.","type":"string"},"um_uim_election":{"description":"The shopper's choice to include or decline the offer's $1M excess UM/UIM option, when they make it in the same selection reply.","oneOf":[{"type":"boolean"},{"enum":["include","decline"],"type":"string"},{"additionalProperties":false,"properties":{"elected":{"description":"Whether the shopper wants the offer's excess UM/UIM option included.","type":"boolean"}},"required":["elected"],"type":"object"}]}},"required":["uid","selection_token","selection_confirmed"],"type":"object"},"name":"umbrella_consumer_select","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella consumer offer select"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["offer_revision","coverage_change","effective_date_change","price_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["advances_bind_workflow","may_send_bind_answers_to_carrier"]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/bind","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Continue the consumer-prefill umbrella bind follow-up only after select returns needs_more_info_to_bind or ready_to_finalize. 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 same consumer-operated MCP subset and send only the current bind-stage fields inside `intake`. This later bind-stage follow-up is where actual vehicle details may appear for selected offers such as Markel; do not move that question into the pre-submit review.","inputSchema":{"additionalProperties":false,"properties":{"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_bind request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake":{"additionalProperties":true,"description":"Answers to the current bind-stage next_question, keyed by the field names Coverage Cat asked for, such as vehicle details for a selected Markel offer.","type":"object"},"intake_access_token":{"description":"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.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"umbrella_consumer_bind","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Continue umbrella bind"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["attachment_set_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["uploads_customer_documents","may_trigger_document_review"]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/attach","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Upload declarations or auto declarations during the consumer-prefill umbrella post-choose flow. 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 same consumer-operated MCP subset. Use only after selection and only when Coverage Cat says documents are needed. If both the home and auto files are already available, prefer one attach call with attachments so the shopper only approves one upload turn. If your runtime already has the files on disk or can stream raw bytes, prefer the REST binary `/api/intake/{uid}/attach-upload` fallback instead of hand-building base64. The upload itself is usually quick once the files are available, and secure checkout is usually ready about 5-10 minutes after Coverage Cat has the uploads on file.","inputSchema":{"additionalProperties":false,"description":"Provide either type, filename, and content for one upload or attachments for a batch upload, never both modes.","properties":{"attachments":{"description":"Upload multiple declarations in one call when both files are already available.","items":{"additionalProperties":false,"properties":{"content":{"contentEncoding":"base64","description":"The whole declarations document named by filename, not an excerpt, summary, or extracted text.","type":"string"},"filename":{"description":"Original file name with its extension, such as `home-declarations.pdf`. Coverage Cat reads the file type from the extension and accepts PDF, JPEG, or PNG files.","type":"string"},"type":{"description":"Which policy the declarations page belongs to: `declarations` for the home, condo, renters, or landlord policy, or `auto_declarations` for the auto policy. Match the upload types Coverage Cat listed in `required_upload_types`.","enum":["declarations","auto_declarations"],"type":"string"}},"required":["type","filename","content"],"type":"object"},"minItems":1,"type":"array"},"content":{"contentEncoding":"base64","description":"The whole declarations document named by filename, not an excerpt, summary, or extracted text.","type":"string"},"filename":{"description":"Original file name with its extension, such as `home-declarations.pdf`. Coverage Cat reads the file type from the extension and accepts PDF, JPEG, or PNG files.","type":"string"},"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_attach request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"type":{"description":"Which policy the declarations page belongs to: `declarations` for the home, condo, renters, or landlord policy, or `auto_declarations` for the auto policy. Match the upload types Coverage Cat listed in `required_upload_types`.","enum":["declarations","auto_declarations"],"type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"umbrella_consumer_attach","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella consumer attachment upload"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["selected_offer_revision","payment_method_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","hostedSecretDelivery":"secure_ui_or_browser_fallback_only","sideEffects":["creates_secure_payment_collection_session","registers_reusable_payment_method"]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/payment","supportsDirectCheckout":true,"supportsIdempotencyKey":true},"openai/outputTemplate":"ui://coveragecat/umbrella-payment","openai/toolInvocation/invoked":"Payment step ready","openai/toolInvocation/invoking":"Preparing secure payment...","openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/umbrella-payment","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/umbrella-payment"},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Prepare secure Stripe payment collection or submit the resulting payment method during the consumer-prefill umbrella post-choose flow. 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 same consumer-operated MCP subset. Use this only after Coverage Cat says payment_needed. First call it with payment_collection_requested: true; do not send the shopper straight to payment_url before you try this native step. If the host confirms the registered secure payment UI can render, display it and wait for completion; do not request card details through conversational text. After successful Stripe setup, call this same tool again with setup_intent_id and payment_method_id. If UI support is unknown or unsupported, or if secure setup fails in chat, share payment_url with the specific fallback reason instead.","inputSchema":{"additionalProperties":false,"description":"Provide either payment_collection_requested: true or both setup_intent_id and payment_method_id, never both modes.","properties":{"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_payment request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"payment_collection_requested":{"const":true,"description":"Starts secure card collection: Coverage Cat prepares a Stripe SetupIntent and returns the publishable_key, client_secret, and setup_intent_id the registered payment UI needs. Send it on the first payment call, without setup_intent_id or payment_method_id.","type":"boolean"},"payment_method_id":{"description":"Reusable Stripe PaymentMethod id produced by secure client-side setup confirmation.","type":"string"},"setup_intent_id":{"description":"SetupIntent id returned by the earlier payment_collection_ready response.","type":"string"},"uid":{"description":"Coverage Cat intake uid for the current shopper session.","type":"string"}},"required":["uid"],"type":"object"},"name":"umbrella_consumer_payment","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Collect umbrella payment"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":false,"approvalScope":"none","classification":"read","sideEffects":[]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"GET","restUrl":"https://coveragecat.com/api/intake/{uid}/policy"}},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Read the current bound or cancelled umbrella policy record, policy documents, and any existing cancellation, refund, or support request history. 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. Use this read-only tool after Coverage Cat reports a policy on file, or after a service request is opened, to show policy facts without switching to delegated tools.","inputSchema":{"additionalProperties":false,"properties":{"intake_access_token":{"description":"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.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"umbrella_consumer_policy","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Get umbrella policy"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["request_type_change","requested_effective_date_change","request_details_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["opens_policy_service_request","may_trigger_support_follow_up"]},"flow":"consumer_follow_up","line":"umbrella","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/service","supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Preview or open a cancellation, refund, or support request for a consumer umbrella policy. 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 same consumer-operated MCP subset after bind. Preview the consequences first, then send confirm_request: true only after the shopper approves opening the request. Do not describe a cancellation, refund, or support issue as completed until Coverage Cat confirms the final outcome.","inputSchema":{"additionalProperties":false,"description":"requested_effective_date is required when request_type is policy_cancellation.","properties":{"confirm_request":{"description":"Whether to open the request now. false, the default, returns a preview of the consequences without opening anything; send true only after the shopper approves that preview.","type":"boolean"},"details":{"description":"Shopper-approved context beyond the short reason, such as the specifics of a billing dispute, recorded on the request and its preview.","type":"string"},"idempotency_key":{"description":"Key you generate to identify one logical umbrella_consumer_service request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"reason":{"description":"Short shopper-approved reason for the request.","type":"string"},"request_type":{"description":"What the shopper wants done after purchase. `policy_cancellation` asks the carrier to end the policy on requested_effective_date; `refund_request` asks the carrier or billing provider to review a refund or outstanding balance without changing coverage; `support_case` opens a general support case for anything else.","enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"description":"Day the shopper wants a cancellation to take effect; used only for policy_cancellation. It is a request: the carrier reviews it and may set a different date.","format":"date","type":"string"},"uid":{"description":"Coverage Cat intake uid for the current shopper session.","type":"string"}},"required":["uid","request_type","reason"],"type":"object"},"name":"umbrella_consumer_service","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Preview or open umbrella service request"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["offer_revision","coverage_change","effective_date_change","price_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["selects_offer","stages_bind_preview"]},"flow":"consumer_follow_up","line":"homeowners","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/select","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Continue the consumer-prefill homeowners flow after quotes are ready. 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 same consumer-operated MCP subset, use the returned selection_token, and let Coverage Cat stage the exact selected offer for one final bind approval in chat. This select step does not collect payment and does not start carrier bind follow-up yet.","inputSchema":{"additionalProperties":false,"properties":{"idempotency_key":{"description":"Key you generate to identify one logical homeowners_consumer_select request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"selection_confirmed":{"const":true,"description":"Attests that the shopper explicitly picked the offer named by selection_token in chat, rather than the agent choosing for them.","type":"boolean"},"selection_token":{"description":"selection_token of the shopper's chosen offer from `offers[]` in the latest quoted follow-up response.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid","selection_token","selection_confirmed"],"type":"object"},"name":"homeowners_consumer_select","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Homeowners consumer offer select"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["offer_revision","coverage_change","effective_date_change","price_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["advances_bind_workflow","may_start_carrier_bind_follow_up"]},"flow":"consumer_follow_up","line":"homeowners","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/bind","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Confirm the previewed homeowners offer after `homeowners_consumer_select` returns `ready_to_finalize`. 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. Reuse the returned preview_token, set bind_confirmed: true, and stay on the same consumer-operated follow-up tool set. Coverage Cat cannot collect homeowners payment in chat; any carrier payment or signing link is emailed to the customer's email on file.","inputSchema":{"additionalProperties":false,"properties":{"bind_confirmed":{"const":true,"description":"Attests that the shopper approved the previewed homeowners bind terms in chat, including email delivery of any carrier payment or signing links.","type":"boolean"},"idempotency_key":{"description":"Key you generate to identify one logical homeowners_consumer_bind request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"preview_token":{"description":"Preview token returned by `homeowners_consumer_select` in the `ready_to_finalize` response for this exact offer.","type":"string"},"uid":{"description":"Coverage Cat intake uid returned by the earlier homeowners consumer-prefill or follow-up response.","type":"string"}},"required":["uid","preview_token","bind_confirmed"],"type":"object"},"name":"homeowners_consumer_bind","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Confirm homeowners bind"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalRequired":false,"approvalScope":"none","classification":"read","sideEffects":[]},"flow":"consumer_follow_up","line":"homeowners","preferredWithoutOperatorAuth":true,"restMethod":"GET","restUrl":"https://coveragecat.com/api/intake/{uid}/policy","supportsDirectCheckout":true}},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Read the current bound or cancelled homeowners policy record, policy documents, and any existing cancellation, refund, or support request history. 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. Use this read-only tool after Coverage Cat reports a policy on file, or after a service request is opened, to show policy facts without switching to delegated tools.","inputSchema":{"additionalProperties":false,"properties":{"intake_access_token":{"description":"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.","type":"string"},"uid":{"description":"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.","type":"string"}},"required":["uid"],"type":"object"},"name":"homeowners_consumer_policy","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Get homeowners policy"},{"_meta":{"coverageCat":{"audience":"consumer_agent","consumerOperatedDefault":true,"contract":{"approvalInvalidatedBy":["request_type_change","requested_effective_date_change","request_details_change"],"approvalRequired":true,"approvalScope":"per_invocation","classification":"sensitive_write","sideEffects":["opens_policy_service_request","may_trigger_support_follow_up"]},"flow":"consumer_follow_up","line":"homeowners","preferredWithoutOperatorAuth":true,"restMethod":"POST","restUrl":"https://coveragecat.com/api/intake/{uid}/service","supportsDirectCheckout":true,"supportsIdempotencyKey":true}},"annotations":{"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"description":"Preview or open a cancellation, refund, or support request for a consumer homeowners policy. 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 same consumer-operated MCP subset after bind. Preview the consequences first, then send confirm_request: true only after the shopper approves opening the request. Do not describe a cancellation, refund, or support issue as completed until Coverage Cat confirms the final outcome.","inputSchema":{"additionalProperties":false,"description":"requested_effective_date is required when request_type is policy_cancellation.","properties":{"confirm_request":{"description":"Whether to open the request now. false, the default, returns a preview of the consequences without opening anything; send true only after the shopper approves that preview.","type":"boolean"},"details":{"description":"Shopper-approved context beyond the short reason, such as the specifics of a billing dispute, recorded on the request and its preview.","type":"string"},"idempotency_key":{"description":"Key you generate to identify one logical homeowners_consumer_service request, so a retry cannot apply it twice. After a timeout or transport failure, retry with the same key and identical arguments to get the original result back; Coverage Cat keeps that result for 24 hours and rejects different arguments sent under a used key.","type":"string"},"intake_access_token":{"description":"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.","type":"string"},"reason":{"description":"Short shopper-approved reason for the request.","type":"string"},"request_type":{"description":"What the shopper wants done after purchase. `policy_cancellation` asks the carrier to end the policy on requested_effective_date; `refund_request` asks the carrier or billing provider to review a refund or outstanding balance without changing coverage; `support_case` opens a general support case for anything else.","enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"description":"Day the shopper wants a cancellation to take effect; used only for policy_cancellation. It is a request: the carrier reviews it and may set a different date.","format":"date","type":"string"},"uid":{"description":"Coverage Cat intake uid for the current shopper session.","type":"string"}},"required":["uid","request_type","reason"],"type":"object"},"name":"homeowners_consumer_service","outputSchema":{"additionalProperties":false,"description":"MCP consumer follow-up payload for the hidden-session shopper flow.","properties":{"post_choose":{"additionalProperties":true,"description":"Structured post-choose state after a quoted umbrella offer is selected.","type":"object"},"next_action":{"additionalProperties":true,"description":"A structured hint for the next allowed tool or endpoint action.","type":"object"},"required_upload_types":{"items":{"type":"string"},"type":"array"},"service_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"reason":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["preview"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"credit_consent_question":{"type":"string"},"detail_status":{"enum":["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"],"type":"string"},"expires_at":{"description":"When the current consumer handoff expires.","format":"date-time","type":"string"},"selected_offer":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"schema":{"additionalProperties":true,"description":"Supplemental schema hints for homeowners review payloads.","type":"object"},"line":{"enum":["umbrella","homeowners"],"type":"string"},"pending_fields":{"description":"Structured missing-value hints for umbrella pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for umbrella pre-submit review.","type":"object"},"type":"array"},"uploaded_count":{"type":"integer"},"offers":{"items":{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"annual_price":{"type":"number"},"carrier":{"type":"string"},"coverage_limit":{"type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Homeowners or umbrella coverage details Coverage Cat can safely summarize.","type":"object"},"deductible":{"type":"number"},"dwelling_coverage":{"type":"number"},"is_estimate":{"type":"boolean"},"minimum_auto_limits":{"additionalProperties":true,"description":"Underlying auto-limit requirements for this offer.","type":"object"},"personal_liability":{"type":"number"},"policy_subtype":{"type":"string"},"policy_subtype_display":{"type":"string"},"price_range":{"additionalProperties":false,"properties":{"high":{"type":"number"},"low":{"type":"number"}},"type":"object"},"quote_number":{"type":"string"},"recommended":{"type":"boolean"},"sample_policy_url":{"format":"uri","type":"string"},"selection_guidance":{"additionalProperties":true,"description":"Offer-specific same-reply requirements and guidance.","type":"object"},"selection_token":{"type":"string"},"um_uim_selection":{"additionalProperties":true,"description":"Optional excess UM/UIM election details for this offer.","type":"object"}},"type":"object"},"type":"array"},"response_summary":{"type":"string"},"payment_status":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"payment_intent_id":{"type":"string"},"payment_method_saved_at":{"format":"date-time","type":"string"},"provider":{"type":"string"},"state":{"type":"string"},"timing":{"type":"string"}},"type":"object"},"poll_after_seconds":{"type":"integer"},"uid":{"description":"Coverage Cat intake uid for the current handoff.","type":"string"},"conversation":{"additionalProperties":false,"properties":{"messages":{"items":{"additionalProperties":false,"properties":{"author_label":{"type":"string"},"delivery_state":{"enum":["received","queued","sent"],"type":"string"},"direction":{"enum":["incoming","outgoing"],"type":"string"},"medium":{"enum":["email","app","sms"],"type":"string"},"message_id":{"type":"integer"},"subject":{"type":"string"},"text":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"type":"array"},"reply_pending":{"type":"boolean"},"reply_supported":{"type":"boolean"},"reply_to_message_id":{"type":"integer"},"reply_via":{"type":"string"}},"type":"object"},"compare_details_url":{"description":"Coverage Cat browser URL for compare-details follow-up.","format":"uri","type":"string"},"offer_summary":{"additionalProperties":false,"properties":{"cheapest_annual_premium":{"type":"number"},"cheapest_carrier":{"type":"string"},"quote_count":{"type":"integer"},"recommended_annual_premium":{"type":"number"},"recommended_carrier":{"type":"string"}},"type":"object"},"review_token":{"description":"Opaque review token for delegated review-style submit paths.","type":"string"},"status":{"enum":["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"],"type":"string"},"preview_token":{"description":"Opaque bind-preview token for the next homeowners bind confirmation.","type":"string"},"next_question":{"additionalProperties":true,"description":"The current shopper-owned question bundle or bind-stage question.","type":"object"},"review_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"known_summary":{"additionalProperties":true,"description":"Structured facts Coverage Cat can safely summarize at this stage.","type":"object"},"user_action_required":{"type":"string"},"payment_collection_supported":{"type":"boolean"},"offers_url":{"description":"Coverage Cat browser URL for the selected offer or offer-tracking page.","format":"uri","type":"string"},"service_request":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"review":{"additionalProperties":true,"description":"Structured review card or selected-offer review block.","type":"object"},"sandbox":{"description":"True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.","type":"boolean"},"selection_guidance":{"additionalProperties":true,"description":"Guidance for completing an offer choice in one shopper-facing reply.","type":"object"},"documents":{"items":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"download_url":{"description":"Short-lived browser continuation for this policy document.","format":"uri","type":"string"},"label":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"notification_channel":{"additionalProperties":false,"properties":{"customer_owned_inbox_required":{"type":"boolean"},"destination_hint":{"type":"string"},"events":{"items":{"type":"string"},"type":"array"},"registered":{"type":"boolean"},"role":{"type":"string"},"type":{"type":"string"}},"type":"object"},"support":{"additionalProperties":false,"properties":{"contact_url":{"description":"Coverage Cat support route for billing, cancellations, and quote follow-up.","format":"uri","type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"type":"object"},"purchase_preview":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"approval_required":{"type":"boolean"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_summary":{"additionalProperties":true,"description":"Coverage details tied to the current previewed offer.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"payment_timing":{"type":"string"},"price":{"additionalProperties":false,"properties":{"annual_premium":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"}},"type":"object"},"status":{"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"uploaded":{"items":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"type":{"type":"string"}},"type":"object"},"type":"array"},"payment_ui":{"additionalProperties":false,"properties":{"availability":{"enum":["ready","unknown","unsupported"],"type":"string"},"fallback_reason":{"type":"string"},"mode":{"type":"string"}},"type":"object"},"field_estimates":{"items":{"additionalProperties":true,"description":"Coverage Cat estimate provenance metadata for reviewed values.","type":"object"},"type":"array"},"policy":{"additionalProperties":false,"properties":{"cancellation_note":{"type":"string"},"cancelled_at":{"format":"date","type":"string"},"carrier":{"type":"string"},"confirmation_timestamp":{"format":"date-time","type":"string"},"coverage_summary":{"additionalProperties":true,"description":"Carrier-confirmed policy coverage details Coverage Cat can safely return.","type":"object"},"effective_date":{"format":"date","type":"string"},"effective_period":{"additionalProperties":false,"properties":{"ends_on":{"format":"date","type":"string"},"starts_on":{"format":"date","type":"string"}},"type":"object"},"policy_number":{"type":"string"},"state":{"enum":["bound","cancelled"],"type":"string"}},"type":"object"},"payment_setup":{"additionalProperties":false,"properties":{"environment":{"enum":["test","live"],"type":"string"},"payment_method_types":{"items":{"type":"string"},"type":"array"},"provider":{"type":"string"},"setup_intent_id":{"type":"string"},"usage":{"type":"string"}},"type":"object"},"agent_instructions":{"items":{"type":"string"},"type":"array"},"service_requests":{"items":{"additionalProperties":false,"properties":{"action_summary":{"type":"string"},"billing_effect":{"type":"string"},"carrier_conditions":{"items":{"type":"string"},"type":"array"},"coverage_effect":{"type":"string"},"details":{"type":"string"},"estimated_refund_status":{"enum":["not_applicable","unknown_pending_review"],"type":"string"},"final_outcome":{"additionalProperties":true,"description":"Final carrier or billing outcome once Coverage Cat can confirm it.","type":"object"},"reason":{"type":"string"},"request_id":{"type":"string"},"request_type":{"enum":["policy_cancellation","refund_request","support_case"],"type":"string"},"requested_at":{"format":"date-time","type":"string"},"requested_effective_date":{"format":"date","type":"string"},"status":{"enum":["pending_review","completed"],"type":"string"},"uncertainty":{"type":"string"}},"type":"object"},"type":"array"},"missing_fields":{"description":"Structured missing-value hints for homeowners pre-submit review.","items":{"additionalProperties":true,"description":"Structured missing-value hints for homeowners pre-submit review.","type":"object"},"type":"array"},"application_submitted":{"type":"boolean"},"payment_url":{"description":"Coverage Cat browser URL for secure payment fallback.","format":"uri","type":"string"},"review_items":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"display_value":{"type":"string"},"enum":{"items":{"type":"string"},"type":"array"},"label":{"type":"string"},"number":{"type":"integer"},"path":{"items":{"type":["string","integer"]},"type":"array"},"suggested_value":{}},"type":"object"},"type":"array"},"verification":{"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"},"intake_access_token":{"description":"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.","type":"string"}},"required":["uid","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Preview or open homeowners service request"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/home"},"openai/outputTemplate":"ui://coveragecat/tools/v2/home-calculator","openai/toolInvocation/invoked":"Estimate ready","openai/toolInvocation/invoking":"Estimating home insurance...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/home-calculator","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/home-calculator"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Estimate annual and monthly home insurance ranges for a California property and return the normalized inputs, available risk-factor ids, and ZIP-level context notes that explain the estimate.","inputSchema":{"additionalProperties":false,"properties":{"home_sqft":{"description":"Approximate finished living area of the home in square feet.","maximum":25000,"minimum":1,"type":"integer"},"risk_factors":{"description":"Optional Coverage Cat risk-factor ids, such as `pool` or `old_systems`, for property traits that can change premium.","items":{"type":"string"},"type":"array"},"zip":{"description":"ZIP code for the California property being estimated.","type":"string"}},"required":["zip","home_sqft"],"type":"object"},"name":"home_calculator","outputSchema":{"additionalProperties":false,"properties":{"available_risk_factors":{"description":"Every risk factor you can pass in risk_factors, whether or not it was applied.","items":{"additionalProperties":false,"properties":{"id":{"description":"Value to send in risk_factors.","type":"string"},"impact_pct":{"description":"Percent the factor adds to the premium.","type":"integer"},"label":{"description":"Shopper-facing name of the factor.","type":"string"}},"required":["id","label","impact_pct"],"type":"object"},"type":"array"},"disclaimer":{"description":"Notice that these figures are informational estimates, not binding quotes; relay it with the numbers.","type":"string"},"estimate":{"additionalProperties":false,"description":"Premium range for the home, in US dollars.","properties":{"annual_high":{"description":"High end of the annual premium range.","type":"integer"},"annual_low":{"description":"Low end of the annual premium range.","type":"integer"},"annual_mid":{"description":"Typical annual premium.","type":"integer"},"monthly_high":{"description":"High end of the monthly premium range.","type":"integer"},"monthly_low":{"description":"Low end of the monthly premium range.","type":"integer"},"monthly_mid":{"description":"Typical monthly premium.","type":"integer"},"risk_factor_count":{"description":"How many recognized risk factors were applied.","type":"integer"},"zip":{"description":"ZIP code the estimate priced.","type":"string"},"zip_risk":{"description":"ZIP-level premium tier before risk factors: `Standard`, `Moderate`, `Elevated`, or `High`.","type":"string"}},"required":["annual_low","annual_mid","annual_high","monthly_low","monthly_mid","monthly_high","zip","zip_risk","risk_factor_count"],"type":"object"},"estimate_unit":{"description":"Currency of every estimate figure: `usd`.","type":"string"},"inputs":{"additionalProperties":false,"description":"The ZIP, square footage, and risk-factor ids the estimate used.","properties":{"home_sqft":{"description":"Living area in square feet.","type":"integer"},"risk_factors":{"description":"Risk-factor ids as sent, including any the estimator did not recognize.","items":{"type":"string"},"type":"array"},"zip":{"description":"ZIP code that was priced.","type":"string"}},"required":["zip","home_sqft","risk_factors"],"type":"object"},"zip_facts":{"description":"Context notes that explain the ZIP's premium tier.","items":{"type":"string"},"type":"array"}},"required":["inputs","estimate","available_risk_factors","zip_facts","estimate_unit","disclaimer"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Home insurance calculator"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/umbrella"},"openai/outputTemplate":"ui://coveragecat/tools/v2/umbrella-calculator","openai/toolInvocation/invoked":"Estimate ready","openai/toolInvocation/invoking":"Estimating umbrella premium...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/umbrella-calculator","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/umbrella-calculator"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Research-only estimate of annual personal umbrella pricing bands, the inferred risk class, and per-factor impacts for directional pricing. Use this for price exploration, not when the shopper wants Coverage Cat to shop for or buy umbrella insurance.","inputSchema":{"additionalProperties":false,"properties":{"antique_vehicles":{"description":"How many collector or antique vehicles should be counted in the risk profile.","minimum":0,"type":"integer"},"at_fault_accidents":{"description":"Total at-fault accidents across all household drivers. Omitted counts as none; a high count can move the profile to specialized review or make it ineligible for instant pricing.","minimum":0,"type":"integer"},"auto_count":{"description":"How many cars, trucks, or SUVs are in the household auto profile.","minimum":0,"type":"integer"},"drivers_over_70":{"description":"Number of drivers in the household who are 70 or older.","minimum":0,"type":"integer"},"drivers_under_22":{"description":"Number of drivers in the household who are younger than 22.","minimum":0,"type":"integer"},"jet_skis":{"description":"Count of personal watercraft such as jet skis.","minimum":0,"type":"integer"},"large_watercraft":{"description":"Count of boats of any size; personal watercraft go under jet_skis.","minimum":0,"type":"integer"},"motorcycles":{"description":"How many motorcycles should be added to the total vehicle exposure.","minimum":0,"type":"integer"},"moving_violations":{"description":"Total moving violations across all household drivers. Omitted counts as none; a high count can move the profile to specialized review or make it ineligible for instant pricing.","minimum":0,"type":"integer"},"property_count":{"description":"How many residential properties the household owns or carries liability for.","minimum":0,"type":"integer"},"zip":{"description":"ZIP code for the household being priced.","type":"string"}},"required":["zip"],"type":"object"},"name":"umbrella_calculator","outputSchema":{"additionalProperties":false,"properties":{"disclaimer":{"description":"Notice that these figures are informational estimates, not binding quotes; relay it with the numbers.","type":"string"},"estimate":{"additionalProperties":false,"description":"Risk class and annual premium bands.","properties":{"class":{"description":"Risk class inferred from the household profile, such as `preferred` or `standard`.","type":"string"},"prices":{"description":"One annual premium band per umbrella limit available in the state.","items":{"additionalProperties":false,"properties":{"coverage_millions":{"description":"Umbrella limit in millions of dollars.","type":"integer"},"high":{"description":"High end of the annual premium band.","type":"integer"},"low":{"description":"Low end of the annual premium band.","type":"integer"},"mid":{"description":"Typical annual premium.","type":"integer"}},"required":["coverage_millions","low","mid","high"],"type":"object"},"type":"array"},"umbrella_class":{"description":"Class used for pricing; it adds `_with_youth` to a standard class when any driver is under 22.","type":"string"}},"required":["class","umbrella_class","prices"],"type":"object"},"estimate_unit":{"description":"Unit of every price: `annual_premium_usd`, annual premium in US dollars.","type":"string"},"factor_impacts":{"description":"Household factors that moved the profile off the best (`preferred`) class; empty when none did.","items":{"additionalProperties":false,"properties":{"factor":{"description":"Internal factor id, such as `moving_violation_count`.","type":"string"},"impact":{"description":"Class this factor alone puts the profile in.","type":"string"},"label":{"description":"Shopper-facing name of the factor.","type":"string"},"value":{"description":"Count the estimate used for this factor.","type":"integer"}},"required":["factor","label","value","impact"],"type":"object"},"type":"array"},"inputs":{"additionalProperties":true,"description":"The household counts you sent, parsed to integers; omitted counts are left out.","type":"object"}},"required":["inputs","estimate","factor_impacts","estimate_unit","disclaimer"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella insurance calculator"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/auto-estimates"},"openai/outputTemplate":"ui://coveragecat/tools/v2/auto-estimates","openai/toolInvocation/invoked":"Estimates ready","openai/toolInvocation/invoking":"Estimating auto premiums...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/auto-estimates","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/auto-estimates"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Estimate monthly auto premiums for one driver and vehicle profile across several carriers. Returns each carrier's id, name, and monthly premium spread (lowest, lower, median, upper, and highest modeled premium) in US dollars, plus the normalized inputs the model used. These are model estimates for research, not bindable quotes.","inputSchema":{"additionalProperties":true,"properties":{"age":{"description":"Age in years of the driver being priced; the model converts it to a birth year.","minimum":16,"type":"integer"},"collision_deductible":{"description":"Dollars the driver pays toward a collision repair before collision coverage pays the rest. Omitted means $1,000.","type":"integer"},"comprehensive_deductible":{"description":"Dollars the driver pays toward non-collision damage, such as theft, hail, or vandalism, before comprehensive coverage pays the rest. Omitted means $1,000.","type":"integer"},"gender":{"description":"Driver gender code the pricing model rates on: `M` for male, `F` for female, or `N` when not specified.","type":"string"},"make":{"description":"Vehicle manufacturer, such as `Toyota` or `Honda`.","type":"string"},"model":{"description":"Vehicle model, such as `Camry` or `Civic`.","type":"string"},"seed":{"description":"Optional deterministic seed for the estimate sample when a caller wants stable repeat runs.","type":"integer"},"state":{"description":"Two-letter state code for the garaging address or rating state.","type":"string"},"style":{"description":"Vehicle trim, body style, or submodel when you want to narrow the vehicle match.","type":"string"},"year":{"description":"Vehicle model year. With make and model it prices a specific car; omit it to price a generic vehicle instead.","type":"integer"},"zip":{"description":"ZIP code for the driver or garaging location being priced.","type":"string"}},"required":["state","zip","age","gender"],"type":"object"},"name":"auto_estimates","outputSchema":{"additionalProperties":false,"properties":{"carriers":{"description":"One estimate per carrier the model could price.","items":{"additionalProperties":false,"properties":{"carrier":{"description":"Carrier id, such as `geico`.","type":"string"},"monthly":{"additionalProperties":false,"description":"Modeled monthly premium spread for this carrier. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"name":{"description":"Carrier display name.","type":"string"}},"required":["carrier","name","monthly"],"type":"object"},"type":"array"},"disclaimer":{"description":"Notice that these figures are informational estimates, not binding quotes; relay it with the numbers.","type":"string"},"estimate_unit":{"description":"Unit of the monthly premium spreads: `monthly_premium_usd`.","type":"string"},"inputs":{"additionalProperties":true,"description":"Driver, vehicle, and deductible values the model used, with defaults filled in for omitted inputs.","type":"object"}},"required":["inputs","carriers","estimate_unit","disclaimer"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Auto insurance estimates"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/collision-and-comprehensive-coverage"},"openai/outputTemplate":"ui://coveragecat/tools/v2/collision-and-comprehensive-coverage","openai/toolInvocation/invoked":"Comparison ready","openai/toolInvocation/invoking":"Comparing coverages...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/collision-and-comprehensive-coverage","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/collision-and-comprehensive-coverage"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Estimate what collision and comprehensive coverage cost for one driver and vehicle profile, to help decide whether to carry them. Returns monthly premium spreads in US dollars with no physical-damage coverage, collision only, and both, plus collision-only and both after one claim, and cumulative premium projections for each coverage option over projection_years. These are model estimates, not bindable quotes.","inputSchema":{"additionalProperties":true,"properties":{"age":{"description":"Age in years of the driver being priced; the model converts it to a birth year.","minimum":16,"type":"integer"},"collision_deductible":{"description":"Dollars the driver pays toward a collision repair before collision coverage pays the rest. Omitted means $1,000.","type":"integer"},"comprehensive_deductible":{"description":"Dollars the driver pays toward non-collision damage, such as theft, hail, or vandalism, before comprehensive coverage pays the rest. Omitted means $1,000.","type":"integer"},"gender":{"description":"Driver gender code the pricing model rates on: `M` for male, `F` for female, or `N` when not specified.","type":"string"},"make":{"description":"Vehicle manufacturer, such as `Toyota` or `Honda`.","type":"string"},"model":{"description":"Vehicle model, such as `Camry` or `Civic`.","type":"string"},"seed":{"description":"Optional deterministic seed for the estimate sample when a caller wants stable repeat runs.","type":"integer"},"state":{"description":"Two-letter state code for the garaging address or rating state.","type":"string"},"style":{"description":"Vehicle trim, body style, or submodel when you want to narrow the vehicle match.","type":"string"},"year":{"description":"Vehicle model year. With make and model it prices a specific car; omit it to price a generic vehicle instead.","type":"integer"},"zip":{"description":"ZIP code for the driver or garaging location being priced.","type":"string"}},"required":["state","zip","age","gender"],"type":"object"},"name":"collision_and_comprehensive_coverage","outputSchema":{"additionalProperties":false,"properties":{"cumulative_annual_scenarios":{"description":"Running premium totals for the without, collision-only, and both coverage options.","items":{"additionalProperties":false,"properties":{"cumulative_annual_premiums":{"description":"Total premium in US dollars paid by the end of each year from 1 to projection_years, based on the median monthly premium.","items":{"type":"integer"},"type":"array"},"label":{"description":"Shopper-facing scenario name.","type":"string"},"scenario":{"description":"Scenario key in monthly_estimates: `without`, `collision`, or `both`.","type":"string"}},"required":["scenario","label","cumulative_annual_premiums"],"type":"object"},"type":"array"},"disclaimer":{"description":"Notice that these figures are informational estimates, not binding quotes; relay it with the numbers.","type":"string"},"estimate_unit":{"description":"Unit of the monthly premium spreads: `monthly_premium_usd`.","type":"string"},"inputs":{"additionalProperties":true,"description":"Driver, vehicle, and deductible values the model used, with defaults filled in for omitted inputs.","type":"object"},"monthly_estimates":{"additionalProperties":false,"description":"Monthly premium spread for each coverage scenario.","properties":{"both":{"additionalProperties":false,"description":"With collision and comprehensive coverage. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"both_claim":{"additionalProperties":false,"description":"With collision and comprehensive coverage, after one claim. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"collision":{"additionalProperties":false,"description":"With collision coverage only. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"collision_claim":{"additionalProperties":false,"description":"With collision coverage only, after one claim. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"without":{"additionalProperties":false,"description":"Without collision or comprehensive coverage. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"}},"required":["without","collision","both","collision_claim","both_claim"],"type":"object"},"projection_years":{"description":"Number of years the cumulative projections cover.","type":"integer"}},"required":["inputs","monthly_estimates","projection_years","cumulative_annual_scenarios","estimate_unit","disclaimer"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Collision and comprehensive coverage calculator"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/file-a-claim"},"openai/outputTemplate":"ui://coveragecat/tools/v2/file-a-claim","openai/toolInvocation/invoked":"Evaluation ready","openai/toolInvocation/invoking":"Evaluating claim costs...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/file-a-claim","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/file-a-claim"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Estimate whether filing an auto collision claim costs more than paying for the repair yourself. Returns monthly premium spreads with and without one claim, the monthly and multi-year premium increase, the collision deductible, the total cost of filing (deductible plus premium increase), and a file_claim or pay_out_of_pocket recommendation with the estimated savings. These are model estimates, not carrier quotes.","inputSchema":{"additionalProperties":true,"properties":{"age":{"description":"Age in years of the driver being priced; the model converts it to a birth year.","minimum":16,"type":"integer"},"collision_deductible":{"description":"Dollars the driver pays toward a collision repair before collision coverage pays the rest. Omitted means $1,000.","type":"integer"},"comprehensive_deductible":{"description":"Dollars the driver pays toward non-collision damage, such as theft, hail, or vandalism, before comprehensive coverage pays the rest. Omitted means $1,000.","type":"integer"},"gender":{"description":"Driver gender code the pricing model rates on: `M` for male, `F` for female, or `N` when not specified.","type":"string"},"make":{"description":"Vehicle manufacturer, such as `Toyota` or `Honda`.","type":"string"},"model":{"description":"Vehicle model, such as `Camry` or `Civic`.","type":"string"},"repair_estimate":{"description":"Approximate dollar amount you expect to pay to repair the vehicle if you do not file a claim.","minimum":0,"type":"integer"},"seed":{"description":"Optional deterministic seed for the estimate sample when a caller wants stable repeat runs.","type":"integer"},"state":{"description":"Two-letter state code for the garaging address or rating state.","type":"string"},"style":{"description":"Vehicle trim, body style, or submodel when you want to narrow the vehicle match.","type":"string"},"year":{"description":"Vehicle model year. With make and model it prices a specific car; omit it to price a generic vehicle instead.","type":"integer"},"zip":{"description":"ZIP code for the driver or garaging location being priced.","type":"string"}},"required":["state","zip","age","gender","repair_estimate"],"type":"object"},"name":"file_a_claim","outputSchema":{"additionalProperties":false,"properties":{"claim_monthly":{"additionalProperties":false,"description":"Monthly premium spread after filing one claim. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"deductible":{"description":"Collision deductible paid when filing.","type":"integer"},"disclaimer":{"description":"Notice that these figures are informational estimates, not binding quotes; relay it with the numbers.","type":"string"},"estimate_unit":{"description":"Currency of every dollar figure: `usd`.","type":"string"},"inputs":{"additionalProperties":true,"description":"Driver, vehicle, and deductible values the model used, with defaults filled in for omitted inputs.","type":"object"},"monthly_increase":{"description":"Median monthly premium increase after the claim.","type":"integer"},"no_claim_monthly":{"additionalProperties":false,"description":"Monthly premium spread with no claim on record. Whole US dollars per month.","properties":{"lower":{"description":"Lower end of the typical range.","type":"integer"},"max":{"description":"Highest modeled premium.","type":"integer"},"median":{"description":"Median modeled premium.","type":"integer"},"min":{"description":"Lowest modeled premium.","type":"integer"},"upper":{"description":"Upper end of the typical range.","type":"integer"}},"required":["min","lower","median","upper","max"],"type":"object"},"premium_impact_years":{"description":"Years the higher premium is assumed to last.","type":"integer"},"premium_increase":{"description":"Total extra premium over premium_impact_years.","type":"integer"},"recommendation":{"additionalProperties":false,"description":"Whether filing or paying out of pocket costs less; null when no repair estimate was read.","properties":{"action":{"description":"`file_claim` when repair_estimate exceeds total_claim_cost, otherwise `pay_out_of_pocket`.","type":"string"},"estimated_savings":{"description":"Dollars saved by taking action instead of the alternative.","type":"integer"}},"required":["action","estimated_savings"],"type":["object","null"]},"repair_estimate":{"description":"The repair estimate you sent.","type":"integer"},"total_claim_cost":{"description":"Total cost of filing: deductible plus premium_increase.","type":"integer"}},"required":["inputs","no_claim_monthly","claim_monthly","monthly_increase","premium_impact_years","premium_increase","deductible","total_claim_cost","repair_estimate","estimate_unit","disclaimer"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Auto claim filing break-even calculator"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/tools/homeowners-agents/search"},"openai/outputTemplate":"ui://coveragecat/tools/v2/homeowners-agent-finder","openai/toolInvocation/invoked":"Agents ready","openai/toolInvocation/invoking":"Finding homeowners agents...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/homeowners-agent-finder","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/homeowners-agent-finder"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Find licensed homeowners insurance agents near a ZIP code using state department of insurance licensing data. California searches return agents within 75 miles, nearest first; Texas searches return agents in the same ZIP. ZIP codes in other states return an empty agents list alongside supported_states. Each agent record includes name, agency, license, lines, location, contact details, and source links.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"description":"How many agent records to return. Omit it to get up to 25; Coverage Cat returns at most 50 even when asked for more.","maximum":100,"minimum":1,"type":"integer"},"lines":{"description":"Insurance lines the agent should handle, such as `homeowners`, `condominium`, `dwelling_fire`, or `renters`; an agent listed for any of them matches, and synonyms such as `condo` are normalized. Omit it to search homeowners agents.","items":{"type":"string"},"type":"array"},"zip":{"description":"ZIP code to search for nearby homeowners agents.","type":"string"}},"required":["zip"],"type":"object"},"name":"homeowners_agent_finder","outputSchema":{"additionalProperties":false,"properties":{"agents":{"description":"Matching agents and agencies, up to the requested limit.","items":{"additionalProperties":true,"properties":{"agency":{"additionalProperties":true,"description":"Agency the agent works for.","type":"object"},"company":{"additionalProperties":true,"description":"Agency and carrier affiliations, such as represented insurers.","type":"object"},"contact":{"additionalProperties":true,"description":"Published phone, email, and address.","type":"object"},"insurer":{"additionalProperties":true,"description":"California only: insurer the agent is appointed with.","type":"object"},"languages":{"description":"Languages the agent lists, when the state publishes them.","items":{"type":"string"},"type":["array","null"]},"last_updated_at":{"description":"When Coverage Cat last saw this record in the state data.","format":"date-time","type":["string","null"]},"license_number":{"description":"State insurance license number.","type":["string","null"]},"lines":{"description":"Insurance lines listed for the agent.","items":{"type":"string"},"type":"array"},"links":{"additionalProperties":true,"description":"URLs for the source record and, when available, the license lookup.","type":"object"},"location":{"additionalProperties":true,"description":"Office address, city, state, and zip; California records add coordinates and distance_miles from the searched ZIP.","type":"object"},"name":{"description":"Agent or firm name.","type":["string","null"]},"source":{"description":"Name of the state dataset the record came from.","type":"string"},"state":{"description":"State whose licensing data lists the agent.","type":"string"}},"required":["state","source","lines","location","contact","links"],"type":"object"},"type":"array"},"last_updated_at":{"description":"Most recent refresh time across the returned agents; null when none were returned.","format":"date-time","type":["string","null"]},"lines":{"description":"Normalized insurance lines the search matched against.","items":{"type":"string"},"type":"array"},"result_count":{"description":"Number of agents returned.","type":"integer"},"source_label":{"description":"Licensing data source, such as `CA Dept of Insurance`; null outside supported states.","type":["string","null"]},"state":{"description":"Two-letter state code for the ZIP.","type":"string"},"state_name":{"description":"Full state name for the ZIP.","type":"string"},"supported_states":{"description":"States the finder has licensing data for.","items":{"type":"string"},"type":"array"},"zip":{"description":"ZIP code that was searched.","type":"string"}},"required":["zip","state","state_name","source_label","lines","agents","result_count","supported_states"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Homeowners agent finder"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/umbrella-limits"},"openai/outputTemplate":"ui://coveragecat/tools/v2/umbrella-limit-planner","openai/toolInvocation/invoked":"Umbrella coverage limit planner ready","openai/toolInvocation/invoking":"Running Umbrella coverage limit planner...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/umbrella-limit-planner","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/umbrella-limit-planner"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Compare how much umbrella coverage to consider from net worth, independently confirmed protected assets, an optional income allowance, and the lowest applicable underlying liability limit. Returns the arithmetic target, additional limit needed, and $0/$1M/$2M/$3M/$5M/$10M scenarios. This is planning, not a quote or a determination of legally exposed assets.","inputSchema":{"additionalProperties":false,"properties":{"annual_income":{"default":0,"description":"Income included in your optional planning allowance. Whole US dollars.","maximum":10000000,"minimum":0,"title":"Annual household income","type":"integer"},"income_years":{"default":0,"description":"Choose 0 for an assets-only scenario; not a garnishment estimate.","maximum":30,"minimum":0,"title":"Years of income to include","type":"integer"},"net_worth":{"description":"Assets minus debts, including property equity. Use 0 if negative. Whole US dollars.","maximum":1000000000,"minimum":0,"title":"Net worth","type":"integer"},"protected_assets":{"default":0,"description":"Only amounts included in net worth whose legal protection you have confirmed. Whole US dollars.","maximum":1000000000,"minimum":0,"title":"Legally protected assets","type":"integer"},"underlying_limit":{"description":"Use the lowest applicable auto, home, or rental liability limit. For a single injured person under split auto limits, use the per-person limit. Do not add separate policies together. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Applicable underlying liability limit","type":"integer"}},"required":["net_worth","underlying_limit"],"type":"object"},"name":"umbrella_limit_planner","outputSchema":{"additionalProperties":false,"properties":{"additional_limit_needed":{"description":"Planning target minus the applicable underlying limit, floored at zero, in USD.","minimum":0,"type":"integer"},"assets_included":{"description":"Net worth minus the caller's confirmed protected-assets allowance, in USD.","minimum":0,"type":"integer"},"assumptions":{"description":"Assumptions and exclusions needed to interpret the calculation.","items":{"type":"string"},"type":"array"},"disclaimer":{"description":"Limits of this planning result and the need to verify policy terms and legal protections.","type":"string"},"estimate_unit":{"const":"usd","description":"Currency for monetary inputs and outputs; year/count fields retain their named units.","type":"string"},"first_illustrated_limit_meeting_target":{"description":"First listed scenario meeting the arithmetic target, not a coverage recommendation. Null when the target exceeds every scenario.","minimum":0,"type":["integer","null"]},"income_allowance":{"description":"Annual income multiplied by the chosen income years, in USD; not a garnishment forecast.","minimum":0,"type":"integer"},"inputs":{"additionalProperties":false,"description":"Normalized caller inputs including defaults; unverified optional limits remain null.","properties":{"annual_income":{"description":"Income included in your optional planning allowance. Whole US dollars.","maximum":10000000,"minimum":0,"title":"Annual household income","type":["integer","null"]},"income_years":{"description":"Choose 0 for an assets-only scenario; not a garnishment estimate.","maximum":30,"minimum":0,"title":"Years of income to include","type":["integer","null"]},"net_worth":{"description":"Assets minus debts, including property equity. Use 0 if negative. Whole US dollars.","maximum":1000000000,"minimum":0,"title":"Net worth","type":["integer","null"]},"protected_assets":{"description":"Only amounts included in net worth whose legal protection you have confirmed. Whole US dollars.","maximum":1000000000,"minimum":0,"title":"Legally protected assets","type":["integer","null"]},"underlying_limit":{"description":"Use the lowest applicable auto, home, or rental liability limit. For a single injured person under split auto limits, use the per-person limit. Do not add separate policies together. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Applicable underlying liability limit","type":["integer","null"]}},"required":["annual_income","income_years","net_worth","protected_assets","underlying_limit"],"type":"object"},"methodology_version":{"description":"Version date of the calculator's arithmetic and assumptions.","type":"string"},"planning_target":{"description":"Assets included plus the optional income allowance, in USD.","minimum":0,"type":"integer"},"scenarios":{"description":"Illustrations for $0, $1M, $2M, $3M, $5M, and $10M of umbrella coverage.","items":{"additionalProperties":false,"properties":{"meets_target":{"description":"Whether this scenario's combined limit reaches the planning target.","type":"boolean"},"target_shortfall":{"description":"Planning target left uncovered by this arithmetic scenario, floored at zero, in USD.","minimum":0,"type":"integer"},"total_liability_limit":{"description":"One applicable underlying limit plus this umbrella scenario, in USD; not a claim-payout guarantee.","minimum":0,"type":"integer"},"umbrella_limit":{"description":"Illustrated additional umbrella limit in USD.","minimum":0,"type":"integer"}},"required":["meets_target","target_shortfall","total_liability_limit","umbrella_limit"],"type":"object"},"type":"array"},"sources":{"description":"Primary background sources; premiums and required limits still come from the caller.","items":{"additionalProperties":false,"properties":{"reviewed_on":{"description":"Date Coverage Cat reviewed this background source; not a quote effective date.","format":"date","type":"string"},"title":{"description":"Title of the primary background source.","type":"string"},"url":{"description":"Public URL of the primary background source.","format":"uri","type":"string"}},"required":["reviewed_on","title","url"],"type":"object"},"type":"array"},"specialist_review_needed":{"description":"True when none of the illustrated umbrella limits meets the arithmetic target.","type":"boolean"}},"required":["additional_limit_needed","assets_included","assumptions","disclaimer","estimate_unit","first_illustrated_limit_meeting_target","income_allowance","inputs","methodology_version","planning_target","scenarios","sources","specialist_review_needed"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella coverage limit planner"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/umbrella-underlying-limits"},"openai/outputTemplate":"ui://coveragecat/tools/v2/umbrella-underlying-limit-check","openai/toolInvocation/invoked":"Umbrella underlying limit checker ready","openai/toolInvocation/invoking":"Running Umbrella underlying limit checker...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/umbrella-underlying-limit-check","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/umbrella-underlying-limit-check"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Check an auto, homeowners, renters, or rental-property policy against the underlying liability requirements stated in a specific umbrella quote. Supply requirements from that quote, not assumed carrier minimums. Missing current limits stay unknown. Returns each required increase separately; it does not determine claim payouts or eligibility.","inputSchema":{"additionalProperties":false,"properties":{"current_limit":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current liability limit","type":["integer","null"]},"current_per_accident":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars. Must be at least the corresponding per-person limit.","maximum":50000000,"minimum":0,"title":"Current bodily injury per accident","type":["integer","null"]},"current_per_person":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current bodily injury per person","type":["integer","null"]},"current_property_damage":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current property damage per accident","type":["integer","null"]},"policy_type":{"description":"Choose home for homeowners, renters, or rental-property liability; auto_csl for combined single limit; auto_split for separate bodily-injury and property-damage limits. auto_split requires required_per_person, required_per_accident, and required_property_damage; home and auto_csl require required_limit. Send only fields for the chosen structure.","enum":["auto_split","auto_csl","home"],"title":"Policy limit structure","type":"string"},"required_limit":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required liability limit","type":"integer"},"required_per_accident":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars. Must be at least the corresponding per-person limit.","maximum":50000000,"minimum":1,"title":"Required bodily injury per accident","type":"integer"},"required_per_person":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required bodily injury per person","type":"integer"},"required_property_damage":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required property damage per accident","type":"integer"}},"required":["policy_type"],"type":"object"},"name":"umbrella_underlying_limit_check","outputSchema":{"additionalProperties":false,"properties":{"assumptions":{"description":"Assumptions and exclusions needed to interpret the calculation.","items":{"type":"string"},"type":"array"},"checks":{"description":"Separate comparisons for each applicable component; do not add split auto limits together.","items":{"additionalProperties":false,"properties":{"current_limit":{"description":"Current declared limit in USD; null means unknown and zero means confirmed no limit.","minimum":0,"type":["integer","null"]},"increase_needed":{"description":"Required minus current limit, floored at zero, in USD; null if current coverage is unknown.","minimum":0,"type":["integer","null"]},"label":{"description":"Liability component compared, such as bodily injury per person.","type":"string"},"required_limit":{"description":"Positive underlying limit required by the caller's specific umbrella quote, in USD.","minimum":0,"type":"integer"},"status":{"description":"Whether this component is below, unknown, or meets its entered requirement.","enum":["below_requirement","unknown","meets_requirement"],"type":"string"}},"required":["current_limit","increase_needed","label","required_limit","status"],"type":"object"},"type":"array"},"disclaimer":{"description":"Limits of this planning result and the need to verify policy terms and legal protections.","type":"string"},"estimate_unit":{"const":"usd","description":"Currency for monetary inputs and outputs; year/count fields retain their named units.","type":"string"},"inputs":{"additionalProperties":false,"description":"Normalized caller inputs including defaults; unverified optional limits remain null.","properties":{"current_limit":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current liability limit","type":["integer","null"]},"current_per_accident":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars. Must be at least the corresponding per-person limit.","maximum":50000000,"minimum":0,"title":"Current bodily injury per accident","type":["integer","null"]},"current_per_person":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current bodily injury per person","type":["integer","null"]},"current_property_damage":{"description":"Read from your current declarations. Omit or use null if unknown; enter 0 only when confirmed. Whole US dollars.","maximum":50000000,"minimum":0,"title":"Current property damage per accident","type":["integer","null"]},"policy_type":{"description":"Choose home for homeowners, renters, or rental-property liability; auto_csl for combined single limit; auto_split for separate bodily-injury and property-damage limits. auto_split requires required_per_person, required_per_accident, and required_property_damage; home and auto_csl require required_limit. Send only fields for the chosen structure.","enum":["auto_split","auto_csl","home"],"title":"Policy limit structure","type":["string","null"]},"required_limit":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required liability limit","type":["integer","null"]},"required_per_accident":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars. Must be at least the corresponding per-person limit.","maximum":50000000,"minimum":1,"title":"Required bodily injury per accident","type":["integer","null"]},"required_per_person":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required bodily injury per person","type":["integer","null"]},"required_property_damage":{"description":"Read the positive required limit from the specific umbrella quote or policy. Whole US dollars.","maximum":50000000,"minimum":1,"title":"Required property damage per accident","type":["integer","null"]}},"required":["current_limit","current_per_accident","current_per_person","current_property_damage","policy_type","required_limit","required_per_accident","required_per_person","required_property_damage"],"type":"object"},"methodology_version":{"description":"Version date of the calculator's arithmetic and assumptions.","type":"string"},"sources":{"description":"Primary background sources; premiums and required limits still come from the caller.","items":{"additionalProperties":false,"properties":{"reviewed_on":{"description":"Date Coverage Cat reviewed this background source; not a quote effective date.","format":"date","type":"string"},"title":{"description":"Title of the primary background source.","type":"string"},"url":{"description":"Public URL of the primary background source.","format":"uri","type":"string"}},"required":["reviewed_on","title","url"],"type":"object"},"type":"array"},"status":{"description":"A confirmed shortfall takes priority; otherwise unknown current limits need verification, or every entered requirement is met.","enum":["below_requirement","unknown","meets_entered_requirements"],"type":"string"}},"required":["assumptions","checks","disclaimer","estimate_unit","inputs","methodology_version","sources","status"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Umbrella underlying limit checker"},{"_meta":{"coverageCat":{"restMethod":"POST","restUrl":"https://coveragecat.com/api/agent/calculators/umbrella-bundle-comparison"},"openai/outputTemplate":"ui://coveragecat/tools/v2/umbrella-bundle-comparison","openai/toolInvocation/invoked":"Standalone umbrella vs. bundle calculator ready","openai/toolInvocation/invoking":"Running Standalone umbrella vs. bundle calculator...","openai/widgetAccessible":true,"openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/tools/v2/umbrella-bundle-comparison","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/tools/v2/umbrella-bundle-comparison"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Compare the total cost of keeping existing home and auto insurance with standalone umbrella coverage versus moving all three to a bundle. Enter annual net premiums, required underlying-limit upgrades, and one-time switching cost. Returns first-year and multi-year totals, savings, and the first whole break-even year. Flags unverified coverage comparability; no carrier prices are invented.","inputSchema":{"additionalProperties":false,"properties":{"auto_upgrade_premium":{"default":0,"description":"Additional annual cost to meet standalone umbrella requirements. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Annual auto limit upgrade","type":"integer"},"bundled_auto_premium":{"description":"Annual replacement auto quote, after discounts, with required limits. Double a six-month premium; multiply a monthly premium by 12. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled auto premium","type":"integer"},"bundled_home_premium":{"description":"Annual replacement home quote, after discounts, with required limits. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled home premium","type":"integer"},"bundled_umbrella_premium":{"description":"Annual bundled umbrella quote at the same limit. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled umbrella premium","type":"integer"},"coverage_comparable":{"default":false,"description":"True only after comparing limits, deductibles, exclusions, insured risks, and claims terms.","title":"Coverage terms have been compared","type":"boolean"},"current_auto_premium":{"description":"Annual premium for the auto policies you would keep. Double a six-month premium; multiply a monthly premium by 12. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Current auto premium","type":"integer"},"current_home_premium":{"description":"Annual premium for the home, renters, or rental policies you would keep. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Current home premium","type":"integer"},"home_upgrade_premium":{"default":0,"description":"Additional annual cost to meet standalone umbrella requirements. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Annual home limit upgrade","type":"integer"},"standalone_umbrella_premium":{"description":"Annual standalone umbrella quote at the limit you want. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Standalone umbrella premium","type":"integer"},"switching_cost":{"default":0,"description":"Additional nonrefundable cost of moving to the bundle; exclude refunded or overlapping premiums. Whole US dollars.","maximum":1000000,"minimum":0,"title":"One-time switching cost","type":"integer"},"years":{"default":3,"description":"Assumes unchanged annual premiums across this period.","maximum":30,"minimum":1,"title":"Years to compare","type":"integer"}},"required":["current_auto_premium","current_home_premium","standalone_umbrella_premium","bundled_auto_premium","bundled_home_premium","bundled_umbrella_premium"],"type":"object"},"name":"umbrella_bundle_comparison","outputSchema":{"additionalProperties":false,"properties":{"annual_savings_with_bundle":{"description":"Standalone annual cost minus bundled annual cost, in USD; negative means the bundle costs more.","type":"integer"},"assumptions":{"description":"Assumptions and exclusions needed to interpret the calculation.","items":{"type":"string"},"type":"array"},"bundle":{"additionalProperties":false,"description":"Cost of replacing home/auto/umbrella together, including one-time switching cost.","properties":{"annual_premium":{"description":"Annual recurring premiums for this option, including required limit upgrades, in USD.","minimum":0,"type":"integer"},"first_year_cost":{"description":"First-year premiums plus any one-time switching cost for this option, in USD.","minimum":0,"type":"integer"},"total_cost":{"description":"Total premiums over the selected years plus any one-time switching cost, in USD.","minimum":0,"type":"integer"}},"required":["annual_premium","first_year_cost","total_cost"],"type":"object"},"bundle_break_even_year":{"description":"First whole policy year when recurring bundle savings cover switching cost; null if there are no recurring savings.","minimum":1,"type":["integer","null"]},"comparison_status":{"description":"Whether the caller confirmed comparable coverage terms; otherwise review coverage before relying on cost alone.","enum":["costs_comparable","coverage_review_needed"],"type":"string"},"disclaimer":{"description":"Limits of this planning result and the need to verify policy terms and legal protections.","type":"string"},"estimate_unit":{"const":"usd","description":"Currency for monetary inputs and outputs; year/count fields retain their named units.","type":"string"},"inputs":{"additionalProperties":false,"description":"Normalized caller inputs including defaults; unverified optional limits remain null.","properties":{"auto_upgrade_premium":{"description":"Additional annual cost to meet standalone umbrella requirements. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Annual auto limit upgrade","type":["integer","null"]},"bundled_auto_premium":{"description":"Annual replacement auto quote, after discounts, with required limits. Double a six-month premium; multiply a monthly premium by 12. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled auto premium","type":["integer","null"]},"bundled_home_premium":{"description":"Annual replacement home quote, after discounts, with required limits. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled home premium","type":["integer","null"]},"bundled_umbrella_premium":{"description":"Annual bundled umbrella quote at the same limit. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Bundled umbrella premium","type":["integer","null"]},"coverage_comparable":{"description":"True only after comparing limits, deductibles, exclusions, insured risks, and claims terms.","title":"Coverage terms have been compared","type":["boolean","null"]},"current_auto_premium":{"description":"Annual premium for the auto policies you would keep. Double a six-month premium; multiply a monthly premium by 12. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Current auto premium","type":["integer","null"]},"current_home_premium":{"description":"Annual premium for the home, renters, or rental policies you would keep. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Current home premium","type":["integer","null"]},"home_upgrade_premium":{"description":"Additional annual cost to meet standalone umbrella requirements. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Annual home limit upgrade","type":["integer","null"]},"standalone_umbrella_premium":{"description":"Annual standalone umbrella quote at the limit you want. Whole US dollars.","maximum":1000000,"minimum":0,"title":"Standalone umbrella premium","type":["integer","null"]},"switching_cost":{"description":"Additional nonrefundable cost of moving to the bundle; exclude refunded or overlapping premiums. Whole US dollars.","maximum":1000000,"minimum":0,"title":"One-time switching cost","type":["integer","null"]},"years":{"description":"Assumes unchanged annual premiums across this period.","maximum":30,"minimum":1,"title":"Years to compare","type":["integer","null"]}},"required":["auto_upgrade_premium","bundled_auto_premium","bundled_home_premium","bundled_umbrella_premium","coverage_comparable","current_auto_premium","current_home_premium","home_upgrade_premium","standalone_umbrella_premium","switching_cost","years"],"type":"object"},"lower_cost_option":{"description":"Option with the lower total cost over the selected period; this does not establish coverage equivalence.","enum":["standalone","bundle","tie"],"type":"string"},"methodology_version":{"description":"Version date of the calculator's arithmetic and assumptions.","type":"string"},"sources":{"description":"Primary background sources; premiums and required limits still come from the caller.","items":{"additionalProperties":false,"properties":{"reviewed_on":{"description":"Date Coverage Cat reviewed this background source; not a quote effective date.","format":"date","type":"string"},"title":{"description":"Title of the primary background source.","type":"string"},"url":{"description":"Public URL of the primary background source.","format":"uri","type":"string"}},"required":["reviewed_on","title","url"],"type":"object"},"type":"array"},"standalone":{"additionalProperties":false,"description":"Cost of keeping current home/auto policies with standalone umbrella and any required limit upgrades.","properties":{"annual_premium":{"description":"Annual recurring premiums for this option, including required limit upgrades, in USD.","minimum":0,"type":"integer"},"first_year_cost":{"description":"First-year premiums plus any one-time switching cost for this option, in USD.","minimum":0,"type":"integer"},"total_cost":{"description":"Total premiums over the selected years plus any one-time switching cost, in USD.","minimum":0,"type":"integer"}},"required":["annual_premium","first_year_cost","total_cost"],"type":"object"},"total_savings_with_bundle":{"description":"Standalone total minus bundled total over the chosen years, including switching cost, in USD.","type":"integer"}},"required":["annual_savings_with_bundle","assumptions","bundle","bundle_break_even_year","comparison_status","disclaimer","estimate_unit","inputs","lower_cost_option","methodology_version","sources","standalone","total_savings_with_bundle"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Standalone umbrella vs. bundle calculator"},{"_meta":{"coverageCat":{"mcpServerUrl":"https://coveragecat.com/api/consumer/mcp"},"openai/outputTemplate":"ui://coveragecat/docs/browser/v2","openai/toolInvocation/invoked":"Topics loaded","openai/toolInvocation/invoking":"Loading docs topics...","openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/docs/browser/v2","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/docs/browser/v2"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"List Coverage Cat documentation topics from the same consumer MCP connection and return each topic's title, category, URI, MIME type, summary, and public href.","inputSchema":{"additionalProperties":false,"properties":{"category":{"description":"Docs category to browse: `developers` for guides such as quickstart, auth, sandbox, and MCP setup, `api` for discovery and OpenAPI documents, `skills` for runtime skill guides, or `all`. Omit it to browse every category.","enum":["all","developers","api","skills"],"type":"string"},"limit":{"description":"How many topics to return from the start of the filtered catalog. Omit it to get up to 25.","maximum":25,"minimum":1,"type":"integer"}},"type":"object"},"name":"docs_list_topics","outputSchema":{"additionalProperties":false,"properties":{"category":{"description":"Category filter that was applied.","type":"string"},"topics":{"description":"Topics in catalog order.","items":{"additionalProperties":false,"properties":{"category":{"description":"Docs category: `developers`, `api`, or `skills`.","type":"string"},"href":{"description":"Public web URL for the same content.","type":"string"},"mime_type":{"description":"Format of the resource body, such as `text/markdown` or `text/yaml`.","type":"string"},"summary":{"description":"What the topic covers.","type":"string"},"title":{"description":"Human-readable topic title.","type":"string"},"uri":{"description":"Resource URI to pass to docs_get_resource.","type":"string"}},"required":["title","uri","mime_type","summary","category","href"],"type":"object"},"type":"array"},"total":{"description":"Number of topics in this response after limit, not the size of the whole catalog.","type":"integer"}},"required":["category","total","topics"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Coverage Cat docs topic index"},{"_meta":{"coverageCat":{"mcpServerUrl":"https://coveragecat.com/api/consumer/mcp"},"openai/outputTemplate":"ui://coveragecat/docs/browser/v2","openai/toolInvocation/invoked":"Results ready","openai/toolInvocation/invoking":"Searching docs...","openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/docs/browser/v2","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/docs/browser/v2"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Search quickstart, auth, sandbox, OpenAPI, and runtime skill docs on this consumer MCP connection. Topics are ranked by how many query words appear in their title, summary, URI, or category; each match carries its title, category, URI, MIME type, summary, and public href, and an empty matches list means no topic contains any query word. Pass a match's uri to docs_get_resource to read it.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"description":"How many of the best-ranked topics to return. Omit it to get the top 5.","maximum":10,"minimum":1,"type":"integer"},"query":{"description":"Search terms describing the documentation need.","type":"string"}},"required":["query"],"type":"object"},"name":"docs_search","outputSchema":{"additionalProperties":false,"properties":{"matches":{"description":"Matching topics, best match first.","items":{"additionalProperties":false,"properties":{"category":{"description":"Docs category: `developers`, `api`, or `skills`.","type":"string"},"href":{"description":"Public web URL for the same content.","type":"string"},"mime_type":{"description":"Format of the resource body, such as `text/markdown` or `text/yaml`.","type":"string"},"summary":{"description":"What the topic covers.","type":"string"},"title":{"description":"Human-readable topic title.","type":"string"},"uri":{"description":"Resource URI to pass to docs_get_resource.","type":"string"}},"required":["title","uri","mime_type","summary","category","href"],"type":"object"},"type":"array"},"query":{"description":"The search query after trimming whitespace.","type":"string"},"total":{"description":"Number of matches in this response after limit, not every topic that matched.","type":"integer"}},"required":["query","total","matches"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Coverage Cat docs search"},{"_meta":{"coverageCat":{"mcpServerUrl":"https://coveragecat.com/api/consumer/mcp"},"openai/outputTemplate":"ui://coveragecat/docs/browser/v2","openai/toolInvocation/invoked":"Resource loaded","openai/toolInvocation/invoking":"Loading doc resource...","openai/widgetDomain":"https://coveragecat.com","ui":{"domain":"https://coveragecat.com","resourceUri":"ui://coveragecat/docs/browser/v2","visibility":["model","app"]},"ui/domain":"https://coveragecat.com","ui/resourceUri":"ui://coveragecat/docs/browser/v2"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"description":"Read one Coverage Cat docs resource by URI from the default consumer MCP and return its URI, public href (null when it has no public page), MIME type, and full markdown, JSON, or YAML text.","inputSchema":{"additionalProperties":false,"properties":{"uri":{"description":"A coveragecat:// or ui:// resource URI from docs_list_topics or docs_search.","type":"string"}},"required":["uri"],"type":"object"},"name":"docs_get_resource","outputSchema":{"additionalProperties":false,"properties":{"href":{"description":"Public web URL for the same content, or null when the resource has no public page.","type":["string","null"]},"mime_type":{"description":"Format of text, such as `text/markdown`, `application/json`, or `text/yaml`.","type":"string"},"text":{"description":"The full resource body in mime_type format.","type":"string"},"uri":{"description":"The resource URI that was read.","type":"string"}},"required":["uri","href","mime_type","text"],"type":"object"},"securitySchemes":[{"type":"noauth"}],"title":"Coverage Cat docs resource reader"}],"transport":{"endpoint":"/api/consumer/mcp","type":"streamable-http","url":"https://coveragecat.com/api/consumer/mcp"},"url":"https://coveragecat.com/api/consumer/mcp","version":"0.1.0","websiteUrl":"https://coveragecat.com/developers/mcp"}