Foresee

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

ドキュメント

AIエージェント向け: サイトインデックスは /llms.txt、全文は /llms-full.txt にあります。

Foresee は、AIアシスタントがすべての保険会社と補償オプションにわたって住宅保険と自動車保険を比較できるように、即時的で正確かつ詳細な見積もりを提供します。

Foresee の利用方法

Foresee は2つの MCP サーバーをホストしています:

PII を提供せずに簡単で手間のかからない見積もりを希望するユーザーは、次を使用します:

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

見積もりを保険会社に直接確認したいユーザーは、Foresee のコンピュータ利用エージェントを次の方法で起動できます:

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

どちらのサーバーも認証は不要です。

ツール

Foresee は MCP サーバー上で2つのツールを公開しています:

ツール	目的	agents.	mcp.
quote_insurance	即時的で正確かつ詳細な見積もりを生成	✅	✅
live_carrier_quotes	保険会社に見積もりを確認	✅	❌

ツール 1: quote_insurance

目的: Foresee がサポートする保険会社から、現在サービスを提供している商品ラインと州にわたって、1回の呼び出しで即時的で項目別の見積もりを生成します。

入力パラメータ

パラメータ	型	必須	詳細
profile	object	はい	Profile を参照
lines	object	はい	キーは価格設定する商品ライン (auto、home、renters)。値はそのラインの補償オプション (Coverage options を参照)
carriers	string[]	いいえ	デフォルトは「全保険会社」
include_failures	boolean	いいえ	true

プロフィール

コアプロフィール

コア入力 profile に加えて、自動車保険と住宅・賃貸保険用の追加ブロックがあります。 必須フィールドは、年齢 (または dob)、ZIP、および (自動車保険の場合) 車両詳細のみです。

省略された任意フィールドは 宣言された前提 になります: 控えめな代替値を選択し、assumptions として報告されます — 例: auto.vehicles[].annual_mileage = 12000、価格に最も影響を与える前提をリストした tighten_by エントリ付き。prior_insurance は同じ商品ラインの保険を意味し、companion_policies は異なる商品ラインの保険を意味します。

フィールド	型	必須
zip_code	string	はい
age	integer	はい
dob	string、YYYY-MM-DD	age の代替として受け入れ
city	string	いいえ
gender	string	いいえ
marital_status	string	いいえ
education	string	いいえ
employment_status	string	いいえ
occupation	string	いいえ
credit_range	string	いいえ
home_ownership_status	string	いいえ
residence_type	string	いいえ
military_affiliation	string	いいえ
memberships	string[]	いいえ
effective_date	string	いいえ
prior_insurance	object	いいえ
companion_policies	object[] — {line, carrier}	いいえ

companion_policies は世帯がすでに保有している保険をリストし、それぞれにそれを引き受けている保険会社を記載します — {"line": "home", "carrier": "State Farm"}。保険会社の複数保険割引は、その保険会社が引き受ける保険にのみ適用されるため、保険会社が記載されていない保有保険には割引が適用されず、見積もりは tighten_by で保険会社を尋ねます。

自動車保険プロフィール

フィールド	型	必須
auto.vehicles[].year	integer	はい
auto.vehicles[].make	string	はい
auto.vehicles[].model	string	はい
auto.vehicles[].ownership	string	いいえ
auto.vehicles[].annual_mileage	integer	いいえ
auto.vehicles[].primary_use	string	いいえ
auto.vehicles[].garaging_zip	string	いいえ
auto.drivers[].relation	string	いいえ (最初のものは self)
auto.drivers[].dob	string	いいえ
auto.drivers[].years_licensed	integer	いいえ
auto.drivers[].accidents	object[]	いいえ
auto.drivers[].violations	object[]	いいえ
auto.drivers[].sr22_required	boolean	いいえ

accidents と violations は日付付きエントリのリストです — {"on": "2025-01", "kind": "speeding"}、{"on": "2023-06-15", "at_fault": true} — 空のリストは無事故・無違反を意味します。on が欠落しているエントリ (または kind が欠落している違反) は拒否され、そのパスが示されます。

住宅・賃貸保険プロフィール

フィールド	型	必須
property.year_built	integer	いいえ
property.construction_type	string	いいえ
property.roof_type	string	いいえ
property.square_feet	integer	いいえ
property.protection_class	string	いいえ
property.replacement_cost	integer	いいえ
property.devices	string[]	いいえ
property.losses	object[]	いいえ

補償オプション

lines の各キーは、その商品ラインの補償オプションを受け取ります。サーバーのデフォルトで価格設定されるものはありません。渡したオプションのみが価格設定されます。

自動車

オプション	型	必須	補償内容
bi	string	はい	対人賠償責任: あなたが他人に与えた傷害。1人あたり/1事故あたりの限度額 ($000単位)、例: "100/300"
pd	integer	はい	対物賠償責任: あなたが他人の車や財産に与えた損害。限度額 ($000単位)、例: 100
coll_deductible	integer	はい	衝突: 過失の有無にかかわらず、事故による自分の車の損害。1回の請求あたりに支払う免責金額 (ドル)
comp_deductible	integer	はい	包括: 事故以外の原因による自分の車の損害 — 盗難、火災、雹、破壊行為、動物との衝突。1回の請求あたりに支払う免責金額 (ドル)
um	string	いいえ	無保険・低額保険車両: 過失のある運転手が保険に加入していない、または保険が不十分な場合のあなたの傷害。1人あたり/1事故あたりの限度額 ($000単位)、例: "100/300"
medpay	integer	いいえ	医療費補償: 過失の有無にかかわらず、あなたと同乗者の医療費。限度額 (ドル)、例: 5000

住宅

オプション	型	必須	補償内容
coverage_a	integer	はい	住居: 家屋自体の再建。限度額 (ドル)、通常は再調達価格
coverage_e	integer	はい	個人賠償責任: 敷地内外で法的責任を負う傷害または損害。限度額 (ドル)
coverage_f	integer	はい	他人への医療費支払い: 敷地内での負傷後の来客の医療費。過失の有無は問わない。限度額 (ドル)
aop_deductible	integer	はい	その他全危険免責金額: 地震など独自の免責金額がある危険を除くすべての危険について、1回の請求あたりに支払う金額 (ドル)

補償 B (他の構造物 — 独立したガレージやフェンスなど)、C (家財 — あなたの所有物)、D (使用損失 — 家に住めない間の生活費) はドルで尋ねられず、sel で価格設定された補償 A の比率として返されます。

賃貸

オプション	型	必須	補償内容
coverage_c	integer	はい	家財: あなたの所有物。限度額 (ドル)
coverage_e	integer	はい	個人賠償責任: 法的責任を負う傷害または損害。限度額 (ドル)
coverage_f	integer	はい	他人への医療費支払い: 自宅での負傷後の来客の医療費。過失の有無は問わない。限度額 (ドル)
deductible	integer	はい	補償が開始される前に1回の請求あたりに支払う金額 (ドル)
coverage_d	integer	いいえ	使用損失: 修理中に退去しなければならない場合の追加生活費。限度額 (ドル)

レスポンス形式

価格設定された結果はすべて structuredContent に含まれ、content は空です。レーティング詳細は dense フィールドです: コンパクトな機械テキストで、1行に1セクション、以下の response ブロックに示されています。その隣には、by_line の下に商品ラインごとの主要フィールド (monthly、confidence_interval、carrier_quote_url、warnings、rated_vs_asked を持つ保険会社、さらに assumptions、tighten_by、failures)、および上部に presentation (価格の提示方法)、bundle と skipped があります。拒否 (profile_required、coverage_required) は dense のないプレーンな JSON です。

プレフィックス	頻度	意味
Q	商品ラインごとに1回	価格設定された内容: 州、商品ライン、補償選択
assumptions:	商品ラインごとに1回	Foresee が行った前提。high_impact: true は、このフィールドが見積もりに大きく影響することを意味します
tighten_by:	商品ラインごとに1回	価格に最も影響する欠落情報のプロフィールパス
not_priced:	該当する場合	除外された保険会社とその理由
C	保険会社ごとに1回	保険会社、引受会社、月額保険料 (点推定値と信頼区間)
W	必要に応じて	上記の保険会社に関する注記 (例: オンライン見積もりページなし)
L	保険会社ごとに1回	補償ごとの月額費用。すべての保険会社で同じ補償を意味するコードで表示 (BI、PD、UMBI、MEDPAY、COMP、COLL…)。A+B は両方をカバーする1つの保険料、FEE は定額料金
D	保険会社ごと	価格ラダー: 各補償レバーについて、提供されるすべての段を、選択内容を維持したまま月額見積もりに対する ±$/月として表示。+0.00 は選択された段を示します。(asked X) = X は提供されておらず、価格は最も近い提供段に設定されます。D から再価格設定してください。再呼び出しは不要です

---

例: 自動車

ZIP 90066 に住む41歳、2021年型ホンダ・シビック。

Mercury は通常の保険会社セルを表示します。Travelers は2つの可能な引受会社を通じてレーティングするため、そのセルには ci セグメント (配置スパン) が含まれます。USAA は保険会社自身の理由で not_priced に配置されます。

{
  "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"]
}

省略されたすべてのプロフィールフィールドは宣言された前提として返されます — 以下の太字の assumptions: ブロックは上記の薄いリクエストによって引き起こされ、tighten_by: は価格に最も影響する9つの回答をリストします。Mercury は通常の保険会社セルを表示します。Travelers は2つの可能な引受会社を通じてレーティングするため、そのセルには ci セグメント (配置スパン) が含まれます。USAA は保険会社自身の理由で not_priced に配置されます。

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
assumptions: [{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":12000,"field":"auto.vehicles[].annual_mileage","high_impact":true},{"assumed":"Commute","field":"auto.vehicles[].primary_use","high_impact":true},{"assumed":15,"field":"auto.vehicles[].one_way_miles","high_impact":true},{"assumed":5,"field":"auto.vehicles[].commute_days","high_impact":false},{"assumed":16,"field":"auto.drivers[].age_first_licensed","high_impact":true,"note":"CA Good Driver discount (at least 20% off every CA price here, INS §1861.025) is granted on this assumption: it rates the applicant as licensed 3+ years. If they were first licensed less than 3 years ago, these prices are understated — send auto.drivers[].age_first_licensed (or date_first_licensed / years_licensed on the same driver) and re-quote."},{"assumed":[],"field":"auto.drivers[].accidents","high_impact":true},{"assumed":[],"field":"auto.drivers[].violations","high_impact":true},{"assumed":false,"field":"prior_insurance.insured","high_impact":true},{"assumed":null,"field":"home_ownership_status","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: auto.vehicles[].annual_mileage,auto.vehicles[].primary_use,auto.vehicles[].one_way_miles,auto.drivers[].age_first_licensed,auto.drivers[].accidents,auto.drivers[].violations,prior_insurance.insured,occupation,memberships
not_priced: usaa:USAA: military families only — set military_affiliation to quote.
C mercury|Mercury Insurance Company|235.11
L BI:56.33,PD:44.10,UMBI:16.85,MEDPAY:0.97,COMP:17.49,COLL:99.38
D bi 100/300=30/60:-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=15:-7.99,25:-6.39,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,COMP:15.50,COLL:114.33,UMBI:19.50
D bi 100/300=15/30:-61.67,25/50:-39.33,30/60:-32.83,50/100:-13.50,100/300:+0.00,250/500:+12.50,500/500:+16.67,1000/1000:+52.67
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
D coll_deductible 500=100:+22.17,250:+13.17,500:+0.00,1000:-19.33,1500:-34.50,2500:-56.50,5000:-86.00
D comp_deductible 500=0:+11.17,50:+9.67,100:+8.00,250:+2.17,500:+0.00,1000:-1.67,1500:-3.67,2500:-6.50,5000:-10.50

---

例: 住宅

上記と同じ41歳が、1998年築の木造住宅 (再調達価格 $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 は B/C/D を価格設定された補償 A の比率としてエコーします。各保険会社の L は基本保険料 (HO_BASE) に手数料を加えたものです。住居の事実は assumptions:/tighten_by: にあります — ここでは屋根の種類、防火クラス、および無事故の損失履歴です。

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}
assumptions: [{"assumed":"Asphalt Shingle","field":"property.roof_type","high_impact":false},{"assumed":1,"field":"property.stories","high_impact":false},{"assumed":2,"field":"property.bathrooms","high_impact":false},{"assumed":1,"field":"property.units","high_impact":false},{"assumed":"owner occupied","field":"property.occupancy","high_impact":false},{"assumed":5,"field":"property.protection_class","high_impact":true},{"assumed":"Attached","field":"property.garage","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.protection_class,property.losses
C mercury|CALIFORNIA AUTOMOBILE INS CO|123.67
L HO_BASE:118.76,FEE:3.75,FEE:1.16,FEE:0.01
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 HO_BASE:144.50,FEE:1.60
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

---

例: 賃貸

同じ ZIP の別の世帯: 27歳の賃貸人:

{
  "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}
assumptions: [{"assumed":2000,"field":"property.year_built","high_impact":false},{"assumed":5,"field":"property.protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.losses
not_priced: usaa:USAA: military families only — set military_affiliation to quote.
C farmers|Fire Insurance Exchange|29.88
L RENTERS_BASE:29.17,FEE:0.42,FEE:0.30
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

---

例: 自動車 + 賃貸

同じ27歳の賃貸人が、今度は車を所有。空の violations と accidents リストは無事故・無違反を意味するため、運転記録の質問は assumptions: を完全に残します。

{
  "profile": {
    "zip_code": "90066",
    "age": 27,
    "prior_insurance": {"insured": true, "carrier": "GEICO", "since": "2019"},
    "auto": {"drivers": [{"violations": [], "accidents": []}],
             "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"]
}

記録、走行距離、保険履歴を提供したため、自動車の assumptions: は8項目に縮小し、tighten_by: は5項目になります。賃貸セクションは独自の住居代替値を宣言します。Mercury は自動車のみを価格設定し、Farmers は両方の商品ラインを価格設定します。

Q CA auto sel={"bi":"100/300","coll_deductible":500,"comp_deductible":500,"pd":100}
assumptions: [{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":"Commute","field":"auto.vehicles[].primary_use","high_impact":true},{"assumed":15,"field":"auto.vehicles[].one_way_miles","high_impact":true},{"assumed":5,"field":"auto.vehicles[].commute_days","high_impact":false},{"assumed":16,"field":"auto.drivers[].age_first_licensed","high_impact":true,"note":"CA Good Driver discount (at least 20% off every CA price here, INS §1861.025) is granted on this assumption: it rates the applicant as licensed 3+ years. If they were first licensed less than 3 years ago, these prices are understated — send auto.drivers[].age_first_licensed (or date_first_licensed / years_licensed on the same driver) and re-quote."},{"assumed":null,"field":"home_ownership_status","high_impact":false},{"assumed":null,"field":"occupation","high_impact":true},{"assumed":null,"field":"memberships","high_impact":true}]
tighten_by: auto.vehicles[].primary_use,auto.vehicles[].one_way_miles,auto.drivers[].age_first_licensed,occupation,memberships
C mercury|Mercury Insurance Company|289.94
L BI:66.80,PD:52.55,UMBI:17.38,MEDPAY:1.05,COMP:23.50,COLL:128.67
D bi 100/300=30/60:-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=15:-9.52,25:-7.61,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,MEDPAY:13.33,COMP:34.00,COLL:133.17,FEE:2.50
D bi 100/300=30/60:-23.83,50/100:-14.67,100/300:+0.00,250/500:+9.83,500/500:+23.83,500/1000:+29.83
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}
assumptions: [{"assumed":5,"field":"property.protection_class","high_impact":false},{"assumed":"Single","field":"marital_status","high_impact":false},{"assumed":[],"field":"property.losses","high_impact":true}]
tighten_by: property.losses
not_priced: mercury:no filed-rate renters program served in CA yet
C farmers|Fire Insurance Exchange|29.88
L RENTERS_BASE:29.17,FEE:0.42,FEE:0.30
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

---

ツール 2: live_carrier_quotes

目的: 保険会社自身の見積もりサイトで見積もりを確認します。

このツールは冪等です: 最初の呼び出しでコンピュータ利用エージェントを起動し、同じ引数で再度呼び出すと、最初の呼び出しの進捗と結果を収集します。

ライブ配信はユーザーの実際の詳細を保険会社に送信し、保険会社はソフトな信用調査を行う場合があります。ツールが呼び出される前にユーザーの同意が収集されます。

Foresee は見積もりの収集のみを行い、支払いを受け付けたり保険を拘束したりしません。

入力パラメータ

パラメータ	型	必須	詳細
profile	object	はい	quote_insurance と同じフィールド — 評価に必要な事実
lines	object	はい	歩行対象のラインごとに1つのキー、各値はそのラインの依頼内容（下記参照）。複数のキーでバンドル歩行を依頼
user_authorization	string	はい	チャット内でのユーザーの同意文言をそのまま（例: yes, go ahead）
identity	object	通常	ユーザーの詳細情報
carriers	string[]	いいえ	対象キャリアを制限。デフォルトは、ライン＋州に対して検証済み歩行を持つすべてのキャリア

lines

ライン	依頼内容	理由
auto	必須 — quote_insurance と同じ4つの軸（bi、pd、coll_deductible、comp_deductible）を実数値で	エージェントがキャリアのフォームに入力する限度額と免責額
home	なし — {"home": null}	キャリア自身のフォームがパッケージ価格を決定（建物金額は再調達価格の見積もりから）。エージェントは選択された内容を報告。依頼内容を指定すると黙って無視されず、明確に拒否される
renters	必須 — coverage_c、coverage_e、coverage_f、deductible を実ドル額で	エージェントはフォームのデフォルト値ではなくユーザーの数値を入力。Foresee が勝手に数値を生成することはない

複数のキーを同時に指定するとバンドル歩行が実行される。指定されたすべてのラインを扱う各キャリアは、複数ラインの見積もりフローを実行し、ラインごとの保険料とバンドル合計を報告する。一部のラインのみを扱うキャリアは、そのラインのみで歩行する。ラインごとの依頼ルールはバンドルでも変わらない。

identity

フィールド	型	必須	詳細
first_name	string	はい	法的姓
last_name	string	はい	法的名
dob	string、YYYY-MM-DD	はい
street	string	はい	住所（1行目）
unit	string	いいえ	アパート/部屋番号（2行目）
city	string	はい
zip_code	string	いいえ	プロフィールと異なる場合のみ
email	string	はい	キャリアはここに見積もりを送信
phone	string	いいえ

レスポンス

フィールド	意味
status	in_progress / partial / complete — 同じ引数で再呼び出しして結果を収集
agents	キャリアごとに1エントリ（下記参照）
note	次にすべきこと（再呼び出しのタイミング、前回実行の結果が返された場合など）
authorization_recorded	領収書上: 同意記録はキャリアがリスク情報を見る前に保存された
skipped	未送信のキャリアとその理由（no_deterministic_walk、missing_facts に事実を明記）
not_dispatched	今回のディスパッチで歩行しないエンジン価格設定キャリアとその理由（held: …、no_walk、not_walked、offline、not_sold） — 歩行レーンで確認できない推奨が黙って消えることはない
needs	missing_facts 拒否時: ユーザーから収集すべきキャリアごとの事実と正確なスキーマパス。閉じた語彙のフィールドには受け入れ可能な values も
assumptions	未表明の軽微なフォーム事実で、歩行が「なし」の申告に解決したもの: プロフィールパス（field）と送信値（assumed）— 結果とともにすべてを伝える
error / detail	すべての拒否は構造化された {"error", "detail"} 辞書

各 agents エントリ:

フィールド	タイミング	意味
carrier_key、carrier	常に	ロスターキー＋表示名
status	常に	in_progress / complete / failed
lines	常に	この歩行がカバーするライン — バンドル歩行では複数
stage、eta_seconds_remaining	進行中	歩行の現在位置。キャリアの標準フローに対する残り時間
quote.premium	見積もり済み	キャリアのページに印刷された文言をそのまま（"$857.80"）— 解析・丸め・導出は一切しない
quote.term_months	見積もり済み	印刷された保険料がカバーする期間
quote.premium_by_line	見積もり済み、バンドル歩行	ページに印刷された各ラインの保険料。quote.premium のバンドル合計と併記
quote.breakdown	見積もり済み	ページ自身の明細項目とラベル
quote.bound	見積もり済み、新しい歩行	価格設定済みページから読み取った補償内容 — フォームが実際に確定した内容と依頼内容の比較
quote.variants	見積もり済み	ページが提示した追加の価格設定済みパッケージ
quote.quote_number	見積もり済み	ページに表示される場合のキャリアの照会番号
quote.evidence_recorded	見積もり済み	スクリーンショットの証拠がサーバー側に存在（内部URIは通信経路に載らない）
declined: true + detail	辞退	キャリアが詳細を確認し、見積もりを拒否。エラーではなく回答 — そのまま伝える
detail	失敗	歩行自体の言葉で、どこでなぜ停止したか

拒否

すべての拒否は構造化された {"error", "detail"} オブジェクト — 下記の行に明記がない限り、いかなるキャリアにも何も送信されていない。

コード	タイミング	対応
profile_required	世帯情報がトップレベルで送信され、profile ラッパーがない	拒否の example_arguments に示されたとおりに情報をラップして再呼び出し
authorization_required	ユーザーの同意なしに呼び出された	同意の事実を説明し、同意を得て、その文言を user_authorization にそのまま渡す
bad_identity	drivers_license_number が SSN の形式	SSN は収集しない。免許証に印刷された免許番号を送信
bad_profile	プロフィールフィールドが検証に失敗	detail がフィールド名を指定
one_line_per_dispatch	空の lines マップ	歩行対象のラインを少なくとも1つ指定
unknown_line	歩行がないライン（例: umbrella）	detail がライブディスパッチが認識するラインを列挙
coverage_selection_required	自動車または賃貸人保険の歩行で限度額と免責額が不完全	数値を指定して再呼び出し — 歩行はデフォルト値ではなく実値を入力
bad_ask	住宅保険の歩行に補償額の依頼が指定された	{"home": null} を送信 — キャリア自身のフォームがパッケージ価格を決定
missing_facts	要求されたキャリアのフォームをプロフィールから入力できない	ユーザーに needs[].fields[] の事実を尋ね（該当する場合は values を使用）、再呼び出し — 下記参照
no_carriers	そのライン＋州に対して検証済み歩行を持つキャリアがない	quote_insurance にフォールバック
launch_failed	エージェントが開始できなかった	いかなるキャリアにも到達していない — 再試行は安全

---

例: 自動車保険

フレズノの世帯が GEICO 自身の見積もりを確認。プロフィールには GEICO のフォームが要求する事実（所有形態、購入時期、以前の保険、初回免許取得年齢など）が含まれる。identity が実際の申請者。依頼内容は quote_insurance と同じ4つの軸。

{
  "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."
}

後で同じ引数で再呼び出しすると、完了した歩行を収集できる。 保険料はページ自身の文字列。breakdown はページ自身のラベル（GEICO は2つのパッケージを並べて表示）。term_months はその金額がカバーする内容を示す — $857.80 6か月あたりであり、月額ではない。

{
  "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
      }
    }
  ]
}