Foresee

npx add-mcp 'https://agents.go-foresee.com/mcp'

Docs

O Foresee permite que assistentes de IA comparem seguros de casa e automóvel em todas as seguradoras e opções de cobertura, fornecendo estimativas de cotação instantâneas, precisas e detalhadas.

Usando o Foresee

O Foresee hospeda dois servidores MCP:

Usuários que desejam uma estimativa de cotação simples e sem fricção, sem fornecer seus dados pessoais (PII), usam:

https://mcp.go-foresee.com/mcp

Usuários que também desejam confirmar as estimativas de cotação diretamente com as seguradoras podem despachar os agentes de uso de computador do Foresee via:

https://agents.go-foresee.com/mcp

Nenhum dos servidores requer autenticação.

Ferramentas

O Foresee publica duas ferramentas nos servidores MCP:

Ferramenta	Finalidade	agents.	mcp.
quote_insurance	Gerar estimativas de cotação instantâneas, precisas e detalhadas	✅	✅
live_carrier_quotes	Confirmar estimativas de cotação com as seguradoras	✅	❌

Ferramenta 1: quote_insurance

Finalidade: gerar estimativas de cotação instantâneas e detalhadas das seguradoras suportadas pelo Foresee, em todas as linhas e estados atualmente atendidos, em uma única chamada.

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Detalhes
profile	objeto	sim	ver Perfil
lines	objeto	sim	As chaves são as linhas a precificar (auto, home, renters); os valores são as opções de cobertura dessa linha (ver Opções de cobertura)
carriers	string[]	não	Padrão: "todas as seguradoras"
include_partial	booleano	não	false
include_failures	booleano	não	true

Perfil

Perfil Principal

Há uma entrada principal profile, além de blocos adicionais para seguro de automóvel e residencial/locatário. Os únicos campos obrigatórios são idade (ou dob), CEP e (para seguro de automóvel) dados do veículo.

Campos opcionais omitidos tornam-se premissas declaradas: escolhemos um substituto conservador, reportado como assumptions — ex.: annual_mileage = 12000, com uma entrada tighten_by listando as premissas que mais moveriam o preço. prior_insurance significa seguro para a mesma linha; companion_policies significa seguro para uma linha diferente

Campo	Tipo	Obrigatório
zip_code	string	sim
age	inteiro	sim
dob	string, YYYY-MM-DD	alternativa aceita para age
city	string	não
gender	string	não
marital_status	string	não
education	string	não
employment_status	string	não
occupation	string	não
credit_range	string	não
home_ownership_status	string	não
residence_type	string	não
military_affiliation	string	não
memberships	string[]	não
effective_date	string	não
prior_insurance	objeto	não
companion_policies	string[]	não

Perfil de Seguro de Automóvel

Campo	Tipo	Obrigatório
auto.vehicles[].year	inteiro	sim
auto.vehicles[].make	string	sim
auto.vehicles[].model	string	sim
auto.vehicles[].ownership	string	não
auto.vehicles[].annual_mileage	inteiro	não
auto.vehicles[].primary_use	string	não
auto.vehicles[].garaging_zip	string	não
auto.drivers[].relation	string	não (self para o primeiro)
auto.drivers[].dob	string	não
auto.drivers[].years_licensed	inteiro	não
auto.drivers[].accidents	objeto[]	não
auto.drivers[].violations	objeto[]	não
auto.drivers[].sr22_required	booleano	não

accidents e violations são listas de objetos estruturados, onde uma lista vazia indica um histórico limpo.

Perfil de Seguro Residencial e Locatário

Campo	Tipo	Obrigatório
property.year_built	inteiro	não
property.construction_type	string	não
property.roof_type	string	não
property.square_feet	inteiro	não
property.protection_class	string	não
property.replacement_cost	inteiro	não
property.devices	string[]	não
property.losses	objeto[]	não

Opções de cobertura

Cada chave em lines recebe as opções de cobertura dessa linha. Nada é precificado com um padrão do servidor: as opções que você enviar são as que serão precificadas.

Automóvel

Opção	Tipo	Obrigatório	O que cobre
bi	string	sim	Responsabilidade por danos corporais: lesões que você causar a outras pessoas. Limite por pessoa/por acidente em milhares de $, ex.: "100/300"
pd	inteiro	sim	Responsabilidade por danos materiais: danos que você causar aos carros e propriedades de outras pessoas. Limite em milhares de $, ex.: 100
coll_deductible	inteiro	sim	Colisão: danos ao seu próprio carro em um acidente, independentemente de quem seja o culpado. A franquia que você paga por sinistro, em dólares
comp_deductible	inteiro	sim	Compreensivo: danos ao seu próprio carro por qualquer coisa além de acidente — roubo, incêndio, granizo, vandalismo, atropelamento de animal. A franquia que você paga por sinistro, em dólares
um	string	não	Motorista não segurado/subsegurado: suas lesões quando o motorista culpado não tem seguro ou tem seguro insuficiente. Limite por pessoa/por acidente em milhares de $, ex.: "100/300"
medpay	inteiro	não	Pagamentos médicos: contas médicas para você e seus passageiros, independentemente de quem seja o culpado. Limite em dólares, ex.: 5000

Residencial

Opção	Tipo	Obrigatório	O que cobre
coverage_a	inteiro	sim	Moradia: reconstrução da própria casa. Limite em dólares, geralmente o custo de reposição
coverage_e	inteiro	sim	Responsabilidade pessoal: lesões ou danos pelos quais você é legalmente responsável, dentro ou fora da propriedade. Limite em dólares
coverage_f	inteiro	sim	Pagamentos médicos a terceiros: contas médicas de um convidado após lesão na sua propriedade, independentemente de quem seja o culpado. Limite em dólares
aop_deductible	inteiro	sim	Franquia para todos os outros riscos: o que você paga por sinistro para tudo, exceto riscos com franquia própria (como terremoto). Em dólares

As coberturas B (outras estruturas, como garagem destacada ou cerca), C (propriedade pessoal — seus pertences) e D (perda de uso — custos de moradia enquanto a casa não pode ser habitada) não são solicitadas em dólares — elas retornam em sel como proporções da Cobertura A que foram precificadas.

Locatário

Opção	Tipo	Obrigatório	O que cobre
coverage_c	inteiro	sim	Propriedade pessoal: seus pertences. Limite em dólares
coverage_e	inteiro	sim	Responsabilidade pessoal: lesões ou danos pelos quais você é legalmente responsável. Limite em dólares
coverage_f	inteiro	sim	Pagamentos médicos a terceiros: contas médicas de um convidado após lesão na sua casa, independentemente de quem seja o culpado. Limite em dólares
deductible	inteiro	sim	O que você paga por sinistro antes de a cobertura começar. Em dólares
coverage_d	inteiro	não	Perda de uso: custos extras de moradia se você precisar se mudar enquanto o local é reparado. Limite em dólares

Formato da resposta

Prefixo	Frequência	Significado
Q	uma vez por linha	O que foi precificado: estado, ramo, seleção de cobertura
format: factors:	uma vez por linha	Legenda autodescritiva para tudo abaixo
assumptions:	uma vez por linha	Premissas adotadas pelo Foresee; high_impact: true significa que este campo move materialmente a estimativa de cotação
tighten_by:	uma vez por linha	As premissas/fatos ausentes que mais moveriam o preço
not_priced:	quando aplicável	Seguradoras excluídas, com o motivo
C	uma vez por seguradora	Seguradora, entidade emissora, prêmio mensal (estimativa pontual e intervalo de confiança)
W	conforme necessário	Aviso anexado à seguradora acima — ex.: "Não emite BI / PD mínimo estadual"
L	uma vez por seguradora	Custo mensal por cobertura ou risco
F	várias por seguradora	Um fator de classificação por linha, nomeado na legenda factors:. Os valores se alinham um a um com os códigos L: em branco = não afeta essa cobertura, um único valor = aplica-se a todas as coberturas. O parêntese é a linha em que o perfil se enquadrou (um degrau como 100/300, um fato como 90066, ou applied / not applied). Sufixo do valor: nenhum = exato, ~ = derivado, ? = estimado
D	por seguradora	Escadas de preço: para cada alavanca de cobertura, cada degrau oferecido como ±$/mês em relação ao mensal cotado, mantendo todo o resto na seleção. +0.00 marca o degrau selecionado; (asked X) = X não é oferecido e o preço fica no degrau oferecido mais próximo. Recalcule a partir de D; não faça nova chamada

---

Exemplo: automóvel

Uma pessoa de 41 anos no CEP 90066 com um Honda Civic 2021.

A Mercury mostra a célula simples da seguradora; a Travelers precifica por meio de duas possíveis entidades emissoras, então sua célula traz um segmento ci (o intervalo de posicionamento). A USAA aparece em not_priced com o motivo da própria seguradora.

{
  "profile": {
    "zip_code": "90066",
    "age": 41,
    "auto": {"vehicles": [{"year": 2021, "make": "Honda", "model": "Civic"}]}
  },
  "lines": {"auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500}},
  "carriers": ["mercury", "travelers", "usaa"]
}

Todo campo de perfil omitido retorna como uma premissa declarada — o bloco gordo assumptions: abaixo é causado pela solicitação enxuta acima, e tighten_by: lista as sete respostas que mais moveriam o preço. A Mercury mostra a célula simples da seguradora; a Travelers precifica por meio de duas possíveis entidades emissoras, então sua célula traz um segmento ci (o intervalo de posicionamento). A USAA aparece em not_priced com o motivo da própria seguradora.

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=BI Limit f1=Good Driver f2=Group Placement (Rule G) f3=PD Limit f4=UMBI Limit f5=Medical Payments Limit f6=Comprehensive Deductible f7=Collision Deductible f8=Vehicle Symbol f9=ca_good_driver_pri f10=group f11=UM Limit
assumptions: [{"assumed":"Male","field":"gender","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":12000,"field":"annual_mileage","high_impact":true},{"assumed":0,"field":"accidents_3yr","high_impact":true},{"assumed":0,"field":"violations_3yr","high_impact":true},{"assumed":false,"field":"dui","high_impact":true},{"assumed":false,"field":"currently_insured","high_impact":true},{"assumed":null,"field":"homeowner","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: annual_mileage,accidents_3yr,violations_3yr,dui,currently_insured,occupation,memberships
not_priced: usaa:USAA sells only to military members, veterans, and their fam
C mercury|Mercury Insurance Company|235.11
L BI:56.33,PD:44.10,UMBI:16.85,MP:0.97,COMP:17.49,COLL:99.38
F f0(100/300)=1.51,,,,,
F f1(applied)=0.8
F f2(not applied)=1.0
F f3(100)=,1.38,,,,
F f4(30/60)=,,1.65,,,
F f5(1000)=,,,1.0,,
F f6(500)=,,,,0.89,
F f7(500)=,,,,,1.0
D bi 100/300=15/30 *available through December 31, 2024:-19.03,25/50 *available through December 31, 2024:-14.18,30/60 *available on or after January 1, 2025:-9.70,50/100:-6.72,100/300:+0.00,250/500:+12.31,300/300:+12.68,500/500:+23.13
D pd 100=5:-15.34,10:-12.14,15:-9.27,25:-7.99,50:-2.88,100:+0.00,250:+2.56,300:+3.83
D coll_deductible 500=100:+19.87,200:+14.91,250:+12.42,500:+0.00,1000:-9.94,2000:-29.81,2500:-39.75
D comp_deductible 500=25:+25.74,50:+17.88,100:+11.00,200:+6.09,250:+2.75,500:+0.00,1000:-2.75,2000:-5.70,2500:-8.06
C travelers|Travelers Commercial Insurance Company|368.50|ci 327.21-415.00
L BI:149.00,PD:70.17,CP:15.50,CL:114.33,UMBI:19.50
F f0(100000/300000)=1.649,,,,
F f8(symbol AA)=1.009?,1.003?,,,
F f9(applied)=0.8
F f10(not applied)=1.0
F f3(100000)=,1.443,,,
F f6(500)=,,0.627,,
F f8(symbol 12)=,,0.941?,,
F f7(500)=,,,0.801,
F f8(symbol 17)=,,,1.013?,
F f11(30000/60000)=,,,,1.5
F f8(symbol 1)=,,,,1.0?
D pd 100=5:-21.50,10:-10.50,15:-6.67,25:-2.83,50:-0.67,100:+0.00,250:+0.50,300:+0.83,500:+1.17
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

Os códigos L de automóvel são as coberturas que a seguradora precifica (combinadas BIPD, ou divididas BI/PD, além de colisão, compreensivo, motorista não segurado, taxas). Eles não são normalizados entre o painel.

---

Exemplo: residencial

A mesma pessoa de 41 anos acima, segurando uma casa de alvenaria construída em 1998 com custo de reposição de $450.000:

{
  "profile": {
    "zip_code": "90066",
    "age": 41,
    "property": {"year_built": 1998, "construction_type": "frame", "replacement_cost": 450000}
  },
  "lines": {"home": {"coverage_a": 450000, "coverage_e": 300000, "coverage_f": 1000, "aop_deductible": 1000}},
  "carriers": ["mercury", "autoclub"]
}

sel ecoa B/C/D como as proporções da Cobertura A que foram precificadas. O L da Mercury é uma decomposição por risco (incêndio, água, incêndio florestal, taxas); a AAA registra um prêmio empacotado. Os fatos da moradia estão em assumptions:/tighten_by: — aqui, tipo de telhado, classe de proteção e um histórico de sinistros limpo.

Q CA home sel={"aop_deductible":1000,"coverage_a":450000,"coverage_b_pct":0.1,"coverage_c_pct":0.5,"coverage_d_pct":0.2,"coverage_e":300000,"coverage_f":1000}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=Deductible f1=Coverage A f2=Multiple Policy Discount (Automobile) f3=Personal Property Replacement Cost f4=Additional Replacement Cost f5=Ordinance or Law f6=Reduced Coverage Endorsement f7=Coverage E f8=Coverage F f9=Enhanced Home Package f10=Water Backup Limit f11=Other Perils Deductible (Table 5 relativity, additive) f12=Water Deductible (Table 5 relativity, additive) f13=Coverage A / Amount of Insurance Relativity (Table 5) f14=Package Discount (Exchange auto policy)
assumptions: [{"assumed":"Asphalt Shingle","field":"roof_type","high_impact":false},{"assumed":1,"field":"stories","high_impact":false},{"assumed":2,"field":"bathrooms","high_impact":false},{"assumed":1,"field":"families","high_impact":false},{"assumed":"Primary","field":"residency_type","high_impact":false},{"assumed":5,"field":"protection_class","high_impact":true},{"assumed":"Attached","field":"garage_type","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: protection_class,home_losses
C mercury|CALIFORNIA AUTOMOBILE INS CO|123.67
L P1_FIRE:34.69,P2_LIABILITY:6.39,P3_THEFT:6.40,P4_WIND:2.68,P5_WATER:61.56,P6_OTHER:3.57,P7_CAT_WIND:0.97,P10_CAT_WATER:0.04,P12_WILDFIRE:0.43,P13_FFEQ:1.36,WC_RESIDENCE_EMPLOYEES_910:0.67,FEE:3.75,FEE:1.16,FEE:0.01
F f0(1000)=0.95,,0.887,0.963,1.0,0.909,0.963,1.0,0.95,0.95,,,,
F f1(450000)=1.895,1.206,1.142,0.901,2.519,1.176,0.901,2.519,1.518,2.313,,,,
F f2(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f3(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f4(No)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f5(0.1)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f6(No)=1.0,,1.0,1.0,1.0,1.0,1.0,1.0,1.0,1.0,,,,
F f7(300000)=,1.5,,,,1.0,,,,,,,,
F f8(1000)=,1.5,,,,,,,,,,,,
F f9(No)=,,1.0,1.0,1.0,1.0,1.0,1.0,,,,,,
F f10(No)=,,,,1.0,,,1.0,,,,,,
D aop_deductible 1000=500:+13.38,1000:+0.00,1500:-5.38,2500:-21.45,3500:-26.58,5000:-37.01,10000:-48.28,25000:-63.01,50000:-72.51
D coverage_a 450000=30000:-90.60,65000:-82.94,95000:-76.38,130000:-68.81,165000:-61.24,195000:-54.76,230000:-47.27,265000:-39.79,295000:-33.39,330000:-25.82,365000:-18.34,395000:-11.94,430000:-4.37,445000:-1.17,450000:+0.00,455000:+1.01,465000:+3.20,500000:+10.86,570000:+26.34,630000:+39.88,700000:+56.03,770000:+72.77,830000:+87.49,900000:+105.41,970000:+124.09,2500000:+523.01,6000000:+1464.79
D coverage_e 300000=100000:-1.34,200000:-0.58,300000:+0.00,500000:+0.68,1000000:+4.04
D coverage_f 1000=1000:+0.00,2000:+0.17,5000:+0.42
C autoclub|Interinsurance Exchange of the Automobile Club|146.10
L Package:139.00,MedPayIL:0.00,LiabilityIL:2.08,BrushFire:0.00,FireFollowingEQ:3.42,FEE:1.60
F f11(1000)=0.393,,,,,
F f12(1000)=1.092,,,,,
F f13(450000)=1.485,,,,,
F f14(No)=1.0,,,,,
D aop_deductible 1000=500:+20.98,750:+7.59,1000:+0.00,1500:-11.45,2000:-16.93,3000:-21.06,5000:-25.36,10000:-28.73,15000:-51.90,20000:-63.44,25000:-71.53,30000:-77.34,50000:-90.49
D coverage_a 450000=60000:-120.65,90000:-115.51,110000:-110.96,130000:-105.66,150000:-99.59,170000:-92.85,190000:-86.53,220000:-76.17,250000:-64.54,280000:-54.09,320000:-40.02,350000:-29.15,360000:-26.54,400000:-16.00,440000:-3.62,450000:+0.00,460000:+2.45,480000:+9.44,550000:+32.95,650000:+77.19,750000:+98.00,850000:+116.62,950000:+147.71,2000000:+475.47,4000000:+1099.41,10000000:+2982.24
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Exemplo: locatário

Um domicílio diferente no mesmo CEP: um locatário de 27 anos:

{
  "profile": {"zip_code": "90066", "dob": "1998-11-11"},
  "lines": {"renters": {"coverage_c": 30000, "coverage_e": 100000, "coverage_f": 1000, "deductible": 500}},
  "carriers": ["farmers", "usaa"]
}

Q CA renters sel={"coverage_c":30000,"coverage_e":100000,"coverage_f":1000,"deductible":500}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead
factors: f0=Coverage C - Personal Property f1=Deductible f2=Coverage D - Loss of Use (% of C) f3=Additional Living Expense Term (months) f4=Contents Loss Settlement (ACV) f5=Enhanced Personal Property Coverage f6=Claims Free Discount f7=Multi-Policy Discount - Renter/auto f8=Multi-Policy Discount - Renter/life f9=Multi-Policy Discount - Renter/umbrella f10=Multi-Policy Discount - Renter/business f11=Multi-Policy Discount - Renter/boat f12=Multi-Policy Discount - Renter/motorhome f13=Multi-Policy Discount - Renter/recreational_vehicle f14=Multi-Policy Discount - Renter/cea f15=ZIP Code f16=Fireline Score f17=Experience Rating (points) f18=Coverage E - Personal Liability f19=Premises Rented to Others Solely Used as a Private Residence
assumptions: [{"assumed":2000,"field":"year_built","high_impact":false},{"assumed":5,"field":"protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: home_losses
not_priced: usaa:USAA sells only to military members, veterans, and their fam
C farmers|Fire Insurance Exchange|29.88
L PC1_PROPERTY:21.00,PC2_LIABILITY:8.17,FEE:0.42,FEE:0.30
F f0(30000)=1.087,,,
F f1(500)=1.0,,,
F f2(20)=1.0,,,
F f3(12)=1.0,,,
F f4(N)=1.0,,,
F f5(N)=1.0,,,
F f6(Y)=0.9,,,
F f7(N)=1.0,1.0,,
F f8(N)=1.0,1.0,,
F f9(N)=1.0,1.0,,
F f10(N)=1.0,1.0,,
F f11(N)=1.0,1.0,,
F f12(N)=1.0,1.0,,
F f13(N)=1.0,1.0,,
F f14(N)=1.0,1.0,,
F f15(90066)=1.423,,,
F f16(0)=1.0,,,
F f17(0)=1.0,,,
F f18(100000)=,1.0,,
F f19({})=,1.0,,
D deductible 500=100:+5.89,250:+1.85,500:+0.00,1000:-2.61,1500:-4.29,2500:-6.73
D coverage_c 30000=4000:-16.33,10000:-11.95,17000:-7.15,23000:-3.87,29000:-0.59,30000:+0.00,31000:+0.51,37000:+3.79,43000:+7.07,49000:+10.36,55000:+13.64,62000:+17.43,68000:+20.71,74000:+23.99,81000:+27.78,87000:+31.06,93000:+34.35,100000:+38.14,106000:+41.42,112000:+44.70,118000:+47.99,125000:+51.77,131000:+55.06,137000:+58.34,144000:+62.13,150000:+65.41
D coverage_e 100000=100000:+0.00,300000:+3.28,500000:+5.56,1000000:+10.69
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Exemplo: pacote automóvel + locatário

O mesmo locatário de 27 anos, agora com um carro. "incidents": [] significa um histórico limpo, então as perguntas sobre histórico de direção deixam assumptions: completamente de fora.

{
  "profile": {
    "zip_code": "90066",
    "age": 27,
    "incidents": [],
    "prior_insurance": {"insured": true, "carrier": "GEICO", "since": "2019"},
    "auto": {"vehicles": [{"year": 2021, "make": "Honda", "model": "Civic", "annual_mileage": 9000}]},
    "property": {"year_built": 1978, "square_feet": 850}
  },
  "lines": {
    "auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500},
    "renters": {"coverage_c": 30000, "coverage_e": 100000, "coverage_f": 1000, "deductible": 500}
  },
  "carriers": ["farmers", "mercury"]
}

Como agora fornecemos histórico, quilometragem e histórico de seguro, os assumptions: de automóvel diminuem para cinco entradas e seus tighten_by: para duas. No entanto, a seção de locatário declara seus próprios substitutos de moradia; a Mercury precifica apenas automóvel — avulsa, sem pacote. A Farmers precifica ambos, oferecendo um desconto de 20%, documentado no B. O mesmo resumo acompanha o structuredContent como bundle: {farmers: {lines, bundle_total, standalone_total, savings}}.

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead ; B carrier|bundled $/mo|standalone $/mo|saves $/mo = this carrier priced the asked lines together; the per-line C prices ARE the bundled prices
factors: f0=BI Limit f1=Good Driver f2=Group Placement (Rule G) f3=PD Limit f4=UMBI Limit f5=Medical Payments Limit f6=Comprehensive Deductible f7=Collision Deductible f8=Business & Professional Group f9=UM Limit
assumptions: [{"assumed":"Male","field":"gender","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":null,"field":"homeowner","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: occupation,memberships
C mercury|Mercury Insurance Company|289.94
L BI:66.80,PD:52.55,UMBI:17.38,MP:1.05,COMP:23.50,COLL:128.67
F f0(100/300)=1.51,,,,,
F f1(applied)=0.8
F f2(not applied)=1.0
F f3(100)=,1.38,,,,
F f4(30/60)=,,1.65,,,
F f5(1000)=,,,1.0,,
F f6(500)=,,,,0.89,
F f7(500)=,,,,,1.0
D bi 100/300=15/30 *available through December 31, 2024:-22.56,25/50 *available through December 31, 2024:-16.81,30/60 *available on or after January 1, 2025:-11.50,50/100:-7.96,100/300:+0.00,250/500:+14.60,300/300:+15.04,500/500:+27.43
D pd 100=5:-18.28,10:-14.47,15:-11.04,25:-9.52,50:-3.43,100:+0.00,250:+3.05,300:+4.57
D coll_deductible 500=100:+25.74,200:+19.30,250:+16.09,500:+0.00,1000:-12.87,2000:-38.60,2500:-51.47
D comp_deductible 500=25:+34.59,50:+24.03,100:+14.79,200:+8.19,250:+3.70,500:+0.00,1000:-3.70,2000:-7.66,2500:-10.83
C farmers|Farmers Insurance Exchange|398.00
L BI:111.83,PD:73.33,UMBI:28.33,UMPD:1.50,MED:13.33,COMP:34.00,COLL:133.17,FEE:2.50
F f0(100000/300000)=1.46,,,,,,,
F f1(applied)=0.8,0.8,0.8,0.8,0.8,0.8,0.8,
F f8(not applied)=1.0,1.0,1.0,1.0,1.0,1.0,1.0,
F f3(100000)=,1.2674,,,,,,
F f9(30000/60000)=,,1.2788,,,,,
F f6(500)=,,,,,1.0009,,
F f7(500)=,,,,,,1.1986,
D pd 100=15:-8.83,25:-5.00,50:-1.50,100:+0.00,250:+1.33,500:+3.17
D coll_deductible 500=250:+30.67,500:+0.00,750:-13.67,1000:-23.50,1500:-37.50,2500:-56.33,5000:-87.00
D comp_deductible 500=100:+23.67,250:+9.17,500:+0.00,750:-7.17,1000:-10.67,1500:-13.50,2500:-18.83,5000:-21.17
Q CA renters sel={"coverage_c":30000,"coverage_e":100000,"coverage_f":1000,"deductible":500}
format: Q state [line] sel=<coverage_selection priced, JSON> ; C=carrier|entity|monthly|ci lo-hi ; tighten_by=missing facts that most move the price — offer to re-quote with the user's answers ; L COV:$,.. = monthly $ per coverage ; F fid(selected)=v,v,.. = rating factor, one value per coverage in the L order, blank=not applied, single value=all coverages, suffix ?=estimated ~=derived none=exact ; D lever selected=option:±$/mo vs the carrier's monthly, others held at the selection (selected(asked X) = X is not an option; the price is at the selected rung shown) ; W = warning — e.g. an asked limit is not offered and the price covers the nearest offered rung instead ; B carrier|bundled $/mo|standalone $/mo|saves $/mo = this carrier priced the asked lines together; the per-line C prices ARE the bundled prices
factors: f0=Coverage C - Personal Property f1=Deductible f2=Coverage D - Loss of Use (% of C) f3=Additional Living Expense Term (months) f4=Contents Loss Settlement (ACV) f5=Enhanced Personal Property Coverage f6=Claims Free Discount f7=Multi-Policy Discount - Renter/auto f8=Multi-Policy Discount - Renter/life f9=Multi-Policy Discount - Renter/umbrella f10=Multi-Policy Discount - Renter/business f11=Multi-Policy Discount - Renter/boat f12=Multi-Policy Discount - Renter/motorhome f13=Multi-Policy Discount - Renter/recreational_vehicle f14=Multi-Policy Discount - Renter/cea f15=ZIP Code f16=Fireline Score f17=Experience Rating (points) f18=Coverage E - Personal Liability f19=Premises Rented to Others Solely Used as a Private Residence
assumptions: [{"assumed":5,"field":"protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"home_losses","high_impact":true}]
tighten_by: home_losses
C farmers|Fire Insurance Exchange|24.06
L PC1_PROPERTY:16.80,PC2_LIABILITY:6.54,FEE:0.42,FEE:0.30
F f0(30000)=1.087,,,
F f1(500)=1.0,,,
F f2(20)=1.0,,,
F f3(12)=1.0,,,
F f4(N)=1.0,,,
F f5(N)=1.0,,,
F f6(Y)=0.9,,,
F f7(Y - Farmers)=0.8,0.8,,
F f8(N)=1.0,1.0,,
F f9(N)=1.0,1.0,,
F f10(N)=1.0,1.0,,
F f11(N)=1.0,1.0,,
F f12(N)=1.0,1.0,,
F f13(N)=1.0,1.0,,
F f14(N)=1.0,1.0,,
F f15(90066)=1.423,,,
F f16(0)=1.0,,,
F f17(0)=1.0,,,
F f18(100000)=,1.0,,
F f19({})=,1.0,,
D deductible 500=100:+4.71,250:+1.48,500:+0.00,1000:-2.09,1500:-3.43,2500:-5.38
D coverage_c 30000=4000:-13.06,10000:-9.56,17000:-5.72,23000:-3.10,29000:-0.47,30000:+0.00,31000:+0.41,37000:+3.03,43000:+5.66,49000:+8.29,55000:+10.91,62000:+13.94,68000:+16.57,74000:+19.19,81000:+22.22,87000:+24.85,93000:+27.48,100000:+30.51,106000:+33.14,112000:+35.76,118000:+38.39,125000:+41.42,131000:+44.05,137000:+46.67,144000:+49.70,150000:+52.33
D coverage_e 100000=100000:+0.00,300000:+2.62,500000:+4.45,1000000:+8.55
B farmers|422.06|427.88|5.82
present: Lead with the best option for this user — its price and a one-line reason — then a comparison sorted cheapest-first (Carrier · Monthly · 6-month total; a markdown table when your surface renders it) and the annual dollar spread between cheapest and priciest — that spread is the reason to compare. A B row's per-line prices assume every bundled line is placed with that carrier; for a cross-carrier mix, compare standalone totals. These are Foresee's estimates of what each carrier will charge; the assumptions and tighten_by blocks say how they were made and how to sharpen them. Foresee never takes payment: when the user settles on a carrier (or asks to buy), give that carrier's carrier_quote_url as a clickable link — the purchase completes on the carrier's own quoting portal.

---

Ferramenta 2: live_carrier_quotes

Finalidade: confirmar estimativas de cotação nos próprios sites de cotação das seguradoras.

Esta ferramenta é idempotente: a primeira chamada comissiona os agentes de uso de computador; chamar novamente com os mesmos argumentos coleta o progresso e os resultados da primeira chamada.

Um despacho ao vivo envia os dados reais do usuário às seguradoras, que podem realizar uma consulta suave de crédito. O consentimento do usuário é obtido antes de a ferramenta ser chamada.

O Foresee apenas coleta cotações; ele não recebe pagamentos nem vincula apólices.

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Detalhes
profile	objeto	sim	Mesmos campos de quote_insurance — os fatos de classificação
lines	objeto	sim	Uma chave por linha a percorrer, cada valor é a solicitação dessa linha (ver abaixo); várias chaves comissionam percursos em pacote
user_authorization	string	sim	A afirmação do usuário no chat, verbatim (ex.: yes, go ahead)
identity	objeto	geralmente	Os dados do usuário.
carriers	string[]	não	Restringe o leque; padrão: todas as seguradoras com um percurso validado para as linhas + estado

lines

Linha	Ask	Por quê
auto	obrigatório — os mesmos quatro eixos de quote_insurance (bi, pd, coll_deductible, comp_deductible), como números reais	Os limites e franquias que os agentes perguntam nos formulários das seguradoras
home	nenhum — {"home": null}	O formulário da própria seguradora precifica seu pacote (valor da moradia a partir de sua estimativa de custo de reposição); os agentes relatam o que ela escolheu. Um ask fornecido é recusado de forma explícita, não silenciosamente ignorado
renters	obrigatório — coverage_c, coverage_e, coverage_f, deductible, como valores em dólares reais	Os agentes digitam os números do usuário no formulário em vez de aceitar os padrões; a Foresee nunca os inventa

Várias linhas de uma vez acionam caminhadas agrupadas: cada seguradora que cobre todas as linhas nomeadas é conduzida por seu próprio fluxo de cotação multi-linha e relata prêmios por linha, além de seu próprio total agrupado; uma seguradora que cobre apenas algumas das linhas é conduzida apenas por essas. As regras de ask por linha não mudam com o agrupamento.

identity

Campo	Tipo	Obrigatório	Detalhes
first_name	string	sim	Nome legal
last_name	string	sim	Sobrenome legal
dob	string, YYYY-MM-DD	sim
street	string	sim	Endereço (linha 1)
unit	string	não	Apartamento/unidade (linha 2)
city	string	sim
zip_code	string	não	Apenas quando diferente do perfil
email	string	sim	As seguradoras enviam a cotação para cá
phone	string	não

Resposta

Campo	Significado
status	in_progress / partial / complete — re-chame com os mesmos argumentos para coletar
agents	Uma entrada por seguradora (veja abaixo)
note	O que fazer em seguida, ex.: tempo para re-chamar, ou que os resultados de uma execução anterior foram retornados
authorization_recorded	No recibo: o registro de consentimento foi armazenado antes de qualquer seguradora ver o risco
skipped	Seguradoras NÃO acionadas, cada uma com o motivo (no_deterministic_walk, missing_facts com os fatos nomeados)
not_dispatched	Seguradoras precificadas pelo motor que esta execução não vai percorrer, com o porquê (held: …, no_walk, not_walked, offline, not_sold) — uma recomendação que a trilha de caminhada não pode confirmar nunca desaparece silenciosamente
needs	Em uma recusa de missing_facts: fatos por seguradora a coletar do usuário, com caminhos de schema exatos — e, para campos de vocabulário fechado, os values aceitos
assumptions	Fatos menores de formulário não declarados que as caminhadas resolveram como respostas de não-reivindicação: o caminho do perfil (field) e o valor enviado (assumed) — repasse todos com os resultados
confirmation	Por seguradora: a estimativa instantânea do motor ao lado do prêmio impresso na página — a estimativa agrupada quando várias linhas foram percorridas
error / detail	Toda recusa é um dict estruturado {"error", "detail"}

Cada entrada de agents:

Campo	Quando	Significado
carrier_key, carrier	sempre	Chave do roster + nome de exibição
status	sempre	in_progress / complete / failed
lines	sempre	As linhas que esta caminhada cobre — várias em uma caminhada agrupada
stage, eta_seconds_remaining	em andamento	Onde a caminhada está; tempo restante contra o fluxo típico da seguradora
quote.premium	cotado	Literalmente como a página da seguradora imprimiu ("$857.80") — nunca analisado, arredondado ou derivado
quote.term_months	cotado	O período que o prêmio impresso cobre
quote.premium_by_line	cotado, caminhada agrupada	O prêmio de cada linha como a página imprimiu, ao lado do total agrupado em quote.premium
quote.breakdown	cotado	Os itens de linha da própria página, seus próprios rótulos
quote.bound	cotado, caminhadas mais novas	Cobertura lida da página precificada — o que o formulário realmente vinculou, vs. o que foi pedido
quote.variants	cotado	Pacotes adicionais precificados que a página ofereceu
quote.quote_number	cotado	O número de recuperação da seguradora, quando a página mostra um
quote.evidence_recorded	cotado	Evidência de captura de tela existe no servidor (URIs internos nunca trafegam na rede)
declined: true + detail	recusado	A seguradora revisou os detalhes e se recusou a cotar. Uma resposta, não um erro — repasse-a
detail	falhou	As próprias palavras da caminhada sobre onde e por que parou

Recusas

Toda recusa é um objeto estruturado {"error", "detail"} — nada foi enviado a qualquer seguradora, a menos que a linha abaixo diga o contrário.

Código	Quando	O que fazer
profile_required	Fatos do domicílio enviados no nível superior, sem wrapper profile	Re-chame com os fatos envolvidos como mostrado na example_arguments da recusa
authorization_required	Chamado sem o consentimento do usuário	Explique os fatos de consentimento, obtenha um sim, passe-o literalmente em user_authorization
bad_identity	Um drivers_license_number com formato de SSN	SSNs nunca são coletados; envie o número da licença como impresso na licença
bad_profile	Um campo do perfil falha na validação	detail nomeia o campo
one_line_per_dispatch	Um mapa lines vazio	Nomeie pelo menos uma linha para percorrer
unknown_line	Uma linha sem caminhada (ex.: umbrella)	detail lista as linhas que a execução ativa conhece
coverage_selection_required	Uma caminhada de auto ou locatário sem limites e franquias completos	Re-chame com os números — as caminhadas digitam valores reais, nunca padrões
bad_ask	Uma caminhada de residência com um ask de cobertura	Envie {"home": null} — o formulário da própria seguradora precifica seu pacote
missing_facts	Nenhum formulário da seguradora solicitada pode ser preenchido a partir do perfil	Pergunte ao usuário pelos fatos needs[].fields[] (usando seus values onde servidos) e re-chame — veja abaixo
no_carriers	Nenhuma seguradora tem uma caminhada validada para essa linha + estado	Recorra a quote_insurance
launch_failed	Os agentes não conseguiram iniciar	Nada alcançou qualquer seguradora — tentar novamente é seguro

---

Exemplo: auto

Um domicílio em Fresno confirmando o próprio número da GEICO. O perfil carrega os fatos que o formulário da GEICO exige (propriedade, momento da compra, seguro anterior, idade da primeira habilitação…); identity é o candidato real; o ask são os mesmos quatro eixos de quote_insurance.

{
  "profile": {
    "zip_code": "93722",
    "dob": "1954-07-02",
    "gender": "Male",
    "marital_status": "Married",
    "education": "Bachelors",
    "employment_status": "Employed",
    "occupation": "Accountant or CPA",
    "home_ownership_status": "Own",
    "prior_insurance": {"insured": true, "limits": "not sure"},
    "auto": {
      "vehicles": [{
        "year": 2024, "make": "Ford", "model": "Maverick",
        "ownership": "Financed", "annual_mileage": 11000,
        "primary_use": "pleasure", "purchase_date": "2026-08"
      }],
      "drivers": [{
        "relation": "self", "age_first_licensed": 16,
        "years_licensed_outside_us": 0, "defensive_driving_course": true,
        "accidents": [], "violations": []
      }]
    }
  },
  "identity": {
    "first_name": "Cornelius", "last_name": "Beaumont", "dob": "1954-07-02",
    "street": "4381 W Spruce Ave", "city": "Fresno", "zip_code": "93722",
    "email": "cornelius.beaumont@example.com", "phone": "559-555-0164"
  },
  "lines": {"auto": {"bi": "100/300", "pd": 100, "coll_deductible": 500, "comp_deductible": 500}},
  "carriers": ["geico"],
  "user_authorization": "yes, go ahead and get me GEICO's real quote"
}

{
  "status": "in_progress",
  "authorization_recorded": true,
  "agents": [
    {
      "carrier_key": "geico",
      "carrier": "GEICO",
      "method": "browser_agent",
      "detail": "deterministic Foresee agent completing the carrier's own quote flow with the user's details",
      "eta_seconds": 480
    }
  ],
  "skipped": [],
  "note": "1 carrier(s) are being quoted live. Collect results by calling this tool again with the same arguments after a few minutes."
}

Re-chamar com os mesmos argumentos depois coleta a caminhada concluída. O prêmio é a própria string da página; breakdown são os próprios rótulos da página (a GEICO imprimiu dois pacotes lado a lado); term_months diz o que o número cobre — $857,80 por 6 meses, não por mês.

{
  "status": "complete",
  "agents": [
    {
      "carrier_key": "geico",
      "carrier": "GEICO",
      "method": "browser_agent",
      "status": "complete",
      "quote": {
        "premium": "$857.80",
        "currency": "USD",
        "term_months": 6,
        "quote_number": null,
        "breakdown": {
          "Less Coverage": "$857.80",
          "More Coverage": "$870.70"
        },
        "evidence_recorded": true
      }
    }
  ]
}