Foresee Insurance Services, LLC Confirm API

openapi: 3.2.0
info:
  title: Foresee Confirm API
  summary: Personal-lines insurance quotes from every carrier, for AI agents.
  description: 'Foresee quotes every personal insurance line in every U.S. state. California auto is live today.


    Two MCP streamable-HTTP hosts, both unauthenticated:

    - https://mcp.go-foresee.com/mcp — ChatGPT and Claude.ai. Tool: quote_insurance (estimates).

    - https://agents.go-foresee.com/mcp — Cursor, Claude Code, other agents, site chat. Tools: quote_insurance (estimates) and live_carrier_quotes (confirm on the carrier''s own site).


    Estimates are not bindable quotes. Confirmations are what a carrier''s site printed, still not binders. Foresee does not take payment. Docs: https://go-foresee.com/docs'
  version: 1.27.2
  contact:
    name: Foresee
    email: support@go-foresee.com
    url: https://go-foresee.com/support
  license:
    name: Terms of Service
    url: https://go-foresee.com/terms
servers:
- url: https://mcp.go-foresee.com
  description: Connector MCP (ChatGPT, Claude.ai). quote_insurance only. POST /mcp.
- url: https://agents.go-foresee.com
  description: Agents MCP (Cursor, Claude Code, site chat). quote_insurance + live_carrier_quotes. POST /mcp.
- url: https://go-foresee.com
  description: Site, docs, OpenAPI, health.
tags:
- name: confirm
  description: Confirm on the carrier's own site (live_carrier_quotes, agents host)
paths:
  /tools/live_carrier_quotes:
    servers:
    - url: https://agents.go-foresee.com
    post:
      tags:
      - confirm
      operationId: live_carrier_quotes
      summary: Confirm on the carrier's own site
      description: MCP tool (idempotent). Invoke via `tools/call` on POST /mcp. Agents host only. No authentication. Foresee walks the named carriers' quote sites and reads back what they printed. Pass an explicit go-ahead verbatim as user_authorization. Re-call with the same arguments to collect progress. Not a bindable quote.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveQuoteArgs'
      responses:
        '200':
          description: Per-carrier confirmation results, including still-running rows.
components:
  schemas:
    QuoteProfile:
      type: object
      additionalProperties: true
      description: ZIP code, age (or dob) and — for auto — each vehicle's year/make/model are required; every other omission becomes a declared assumption reported back under assumptions/tighten_by.
      properties:
        zip_code:
          type: string
          description: 5-digit ZIP. Required.
        age:
          type: integer
          description: Required, or pass dob.
        dob:
          type: string
          description: YYYY-MM-DD — accepted alternative to age.
        city:
          type: string
        gender:
          type: string
        marital_status:
          type: string
        education:
          type: string
        employment_status:
          type: string
        occupation:
          type: string
        credit_range:
          type: string
          description: Used only where state law permits credit in rating.
        home_ownership_status:
          type: string
          description: rent / own
        residence_type:
          type: string
        military_affiliation:
          type: string
          description: active / veteran / family / none. USAA is military-affiliated households only.
        memberships:
          type: array
          items:
            type: string
        effective_date:
          type: string
        prior_insurance:
          type: object
          additionalProperties: true
          description: 'Current/prior insurance for the same line: carrier, limits, tenure.'
        companion_policies:
          type: array
          description: Policies the household already holds, each with the carrier that writes it. A carrier's multi-policy discount applies only to a policy it writes.
          items:
            type: object
            additionalProperties: true
            required:
            - line
            properties:
              line:
                type: string
                description: 'What the policy insures: home, renters, condo, auto, life, umbrella…'
              carrier:
                type: string
                description: Who writes it, e.g. "State Farm", "AAA". Without it no carrier's discount applies.
              in_force:
                type: boolean
                description: False for a policy that has lapsed or been cancelled.
        auto:
          type: object
          additionalProperties: true
          description: 'Auto block: vehicles[] (year/make/model required) and drivers[].'
          properties:
            vehicles:
              type: array
              items:
                type: object
                additionalProperties: true
                properties:
                  year:
                    type: integer
                  make:
                    type: string
                  model:
                    type: string
                  ownership:
                    type: string
                  annual_mileage:
                    type: integer
                  primary_use:
                    type: string
                  garaging_zip:
                    type: string
            drivers:
              type: array
              items:
                type: object
                additionalProperties: true
                properties:
                  relation:
                    type: string
                    description: self for the first.
                  dob:
                    type: string
                  years_licensed:
                    type: integer
                  accidents:
                    type: array
                    items:
                      type: object
                      required:
                      - 'on'
                    description: Empty list = clean record.
                  violations:
                    type: array
                    items:
                      type: object
                      required:
                      - 'on'
                      - kind
                  sr22_required:
                    type: boolean
        property:
          type: object
          additionalProperties: true
          description: Home/renters block.
          properties:
            year_built:
              type: integer
            construction_type:
              type: string
            roof_type:
              type: string
            square_feet:
              type: integer
            protection_class:
              type: string
            replacement_cost:
              type: integer
            devices:
              type: array
              items:
                type: string
            losses:
              type: array
              items:
                type: object
    LiveQuoteArgs:
      type: object
      required:
      - profile
      - lines
      - user_authorization
      properties:
        profile:
          $ref: '#/components/schemas/QuoteProfile'
        lines:
          type: object
          additionalProperties: true
          description: One key per line to walk. Auto and renters asks are required (same axes as quote_insurance); home takes null — the carrier's own form prices its package. Several keys commission bundled walks.
        identity:
          type: object
          additionalProperties: true
          description: Legal name, dob, street address, email — live submissions only.
        user_authorization:
          type: string
          description: The user's in-chat go-ahead, verbatim.
        carriers:
          type: array
          items:
            type: string
externalDocs:
  description: Human and agent docs
  url: https://go-foresee.com/docs