Foresee Insurance Services, LLC Estimate API
Instant estimates (quote_insurance)
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/go-foresee-com:go-foresee-com-estimate-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Foresee Estimate 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: estimate
description: Instant estimates (quote_insurance)
paths:
/tools/quote_insurance:
servers:
- url: https://mcp.go-foresee.com
- url: https://agents.go-foresee.com
post:
tags:
- estimate
operationId: quote_insurance
summary: Instant estimates
description: MCP tool. Invoke via `tools/call` on POST /mcp, not as a raw REST path. No authentication. Prices a household profile across the supported carriers, per line in `lines`. These are estimates, not bindable quotes. Unserviceable state/line combinations return a structured coverage error.
security: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/QuoteInsuranceArgs'
responses:
'200':
description: Per-carrier monthly point estimates, confidence intervals, assumptions, tighten_by, failures.
components:
schemas:
HomeAsk:
type: object
additionalProperties: true
description: Home coverage ask, in dollars. All four axes required.
properties:
coverage_a:
type: integer
description: Dwelling limit — usually the replacement cost.
coverage_e:
type: integer
description: Personal liability.
coverage_f:
type: integer
description: Guest medical.
aop_deductible:
type: integer
description: All-other-perils deductible.
QuoteInsuranceArgs:
type: object
required:
- profile
- lines
properties:
profile:
$ref: '#/components/schemas/QuoteProfile'
lines:
$ref: '#/components/schemas/Lines'
carriers:
type: array
items:
type: string
description: Restrict the panel; defaults to all supported carriers.
include_failures:
type: boolean
default: true
RentersAsk:
type: object
additionalProperties: true
description: 'Renters coverage ask, in dollars. Required axes: coverage_c, coverage_e, coverage_f, deductible.'
properties:
coverage_c:
type: integer
description: Personal-property (contents) limit.
coverage_e:
type: integer
description: Personal liability.
coverage_f:
type: integer
description: Guest medical.
deductible:
type: integer
description: All-perils deductible.
coverage_d:
type: integer
description: Optional. Loss of use.
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
AutoAsk:
type: object
additionalProperties: true
description: 'Auto coverage ask, as actual numbers. Required axes: bi, pd, coll_deductible, comp_deductible. An incomplete ask returns coverage_required naming the axes.'
properties:
bi:
type: string
description: Bodily-injury liability, per-person/per-accident in $000s, e.g. "100/300".
pd:
type: integer
description: Property-damage liability in $000s, e.g. 100.
coll_deductible:
type: integer
description: Collision deductible in dollars.
comp_deductible:
type: integer
description: Comprehensive deductible in dollars.
um:
type: string
description: Optional. UM/UIM BI in $000s, e.g. "100/300".
medpay:
type: integer
description: Optional. Medical payments in dollars.
Lines:
type: object
additionalProperties: true
description: 'REQUIRED — one map: each key names a line to price (auto, home, renters), each value that line''s coverage ask as actual numbers.'
properties:
auto:
$ref: '#/components/schemas/AutoAsk'
home:
$ref: '#/components/schemas/HomeAsk'
renters:
$ref: '#/components/schemas/RentersAsk'
externalDocs:
description: Human and agent docs
url: https://go-foresee.com/docs