Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "prepare_dealer_handoff"
⟨363 unchanged words⟩ default":null,"description":"Rebates the shopperexpectsexpects.(appliedTakenlikeoffcashthedownamount due, and off the taxed amount where the state allows it (not CA)","title":"Rebates"}},"title" ⟨1182 unchanged words⟩
Changed the definition of "prepare_dealer_handoff"
⟨136 unchanged words⟩ On synthetic data the package is labeled DEMO.ABeforeshortcalling,dealasksummarythe shopper for a phone number or email for the dealer (with their OK); the call fails without a phone, email, or a name plus preferred_contact. The deal (date, shopper name and contact, car, payment, status) isrecordedsavedonto the store's dealerdashboard;
Changed the definition of "prepare_dealer_handoff"
⟨136 unchanged words⟩ On synthetic data the package is labeled DEMO.Inputs,Aincludingshort deal summary (date, shoppercontactname,detailscar, payment, status) is recorded on the store's dealer dashboard; shopper phone and email are not stored.
Added "cancel_search", "get_new_matches", "prepare_dealer_handoff" and 2 more; changed the definition of "list_dealers" and "search_inventory" (12 tools before, 17 now)
All 20 fictional demo dealers with group and store counts (each dealer lists its stores with group_id,plusregion_id and store_id), the dealer hierarchy (Group, then Region, then Store), the 4 fictional dealer groups and a coverage ⟨15 unchanged words⟩
⟨378 unchanged words⟩ price) that estimate_out_the_door returns. Each result has group_id, region_id and store_id (dealer hierarchy; also filterable) and dealer_segment / dealer_type, third_row_type and sliding_doors. With payment
Changed the definition of "compare_payment_scenarios", "estimate_out_the_door", "get_payment_estimate" and 3 more
⟨42 unchanged words⟩ term_months, estimated_monthly_payment (rounded to $5) withathe unrounded value and an outward-rounded range,total_interest_estimate,total_cost_estimatetotal_cost_including_trade_equity (PRIMARY total: cash down plusall payments,plus net tradenotequitycounted)given
Added "compare_payment_scenarios"; changed the definition of "get_payment_estimate" and "search_inventory" (11 tools before, 12 now)
⟨65 unchanged words⟩ every assumption, plus the out-the-door figure it used, a one-line assumptions_summary and any dealer-advertised payment shown separately (not comparable unlessthe terms match). Totals: total_cost_estimate (cash down plus payments) and total_cost_including_trade_equity (also adds the net trade equity given up). For ONE set of terms only: to compare two or more down, term, trade or credit options, call compare_payment_scenarios once instead of calling this tool repeatedly. Use get_price_breakdown instead for the dealer's listed price ⟨17 unchanged words⟩ payment across many listings, use search_inventory withpayment_max. Notmax_monthly_paymentan(sameoffer
Certificate recorded, valid to 2027-01-16
Authorization not required
Added "get_payment_estimate" and "list_searchable_fields"; changed the definition of "estimate_out_the_door", "get_dealer", "get_listing" and 5 more (9 tools before, 11 now)
ItemizedUse this for the buyer's TOTAL price of ONE listing: an itemized out-the-door DEMO ESTIMATEusingfor the buyer's state, county and city, built with real public tax and fee rules for the 8states:coveredeverystates.lineLineshasincludeathesource
Unknown → Live
First tool surface recorded: 9 tools (server version 1.30.0)
https://moonshotlab1.com/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 12 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
before
{"$defs":{"AssistantRef":{"description":"Which assistant prepared the deal, for the dealer's reference.","properties":{"contact":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Contact"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"session_ref":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque session or conversation reference.","title":"Session Ref"}},"title":"AssistantRef","type":"object"},"HandoffContact":{"description":"Shopper contact, shared only with the shopper's consent. Not stored.","properties":{"email":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Email"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"notes":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"phone":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"title":"Phone"},"preferred_contact":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"email, phone or text","title":"Preferred Contact"}},"title":"HandoffContact","type":"object"},"PaymentScenario":{"description":"One what-if finance scenario. Omitted fields use the call's defaults ($0 down, 60 months, good credit).","properties":{"apr":{"anyOf":[{"maximum":36,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"APR percent; overrides credit_tier.","title":"Apr"},"cash":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to price paying cash: no loan or interest; omit apr, term_months, credit_tier and down_payment.","title":"Cash"},"credit_tier":{"anyOf":[{"enum":["excellent","good","fair","poor"],"type":"string"},{"type":"null"}],"default":null,"description":"Picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"down_payment":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD.","title":"Down Payment"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer qualifies for.","title":"Eligible Incentive Labels"},"name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Short label, e.g. '3k down 72 mo'.","title":"Name"},"payoff":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"term_months":{"anyOf":[{"maximum":96,"minimum":12,"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96.","title":"Term Months"},"trade_equity":{"anyOf":[{"maximum":500000,"minimum":-500000,"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown; no tax credit.","title":"Trade Equity"},"trade_value":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the state's trade-in tax credit).","title":"Trade Value"}},"title":"PaymentScenario","type":"object"}},"properties":{"assistant":{"anyOf":[{"$ref":"#/$defs/AssistantRef"},{"type":"null"}],"default":null,"description":"Optional assistant reference: name, session_ref, contact."},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county without 'County'.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's five-digit ZIP; alone it resolves state, county and city.","title":"Buyer Zip"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Conditional incentive label_raw values the shopper qualifies for.","title":"Eligible Incentive Labels"},"listing_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"dealer_key:VIN from search_inventory. Either this or vin is required.","title":"Listing Id"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"scenario":{"anyOf":[{"$ref":"#/$defs/PaymentScenario"},{"type":"null"}],"default":null,"description":"The financing scenario the shopper chose, same shape as one compare_payment_scenarios scenario (down_payment, term_months, credit_tier or apr, trade fields, or cash=true). Default: $0 down, 60 months, good credit."},"shopper_contact":{"anyOf":[{"$ref":"#/$defs/HandoffContact"},{"type":"null"}],"default":null,"description":"Optional, only with the shopper's consent: name, email, phone, preferred_contact, notes."},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown (no tax credit).","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (used when the scenario does not set it).","title":"Trade Value"},"trade_vehicle":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Short description of the trade, e.g. '2021 Ford F-150 XLT, 48k mi'.","title":"Trade Vehicle"},"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN, if listing_id is not known. Rejected if several dealers list it.","title":"Vin"}},"title":"prepare_dealer_handoffArguments","type":"object"}after
{"$defs":{"AddOnInterest":{"additionalProperties":false,"description":"Is the shopper interested in these products? No prices: the dealer goes over them with the shopper.","properties":{"gap":{"anyOf":[{"enum":["yes","no","unsure"],"type":"string"},{"type":"null"}],"default":null,"title":"Gap"},"maintenance":{"anyOf":[{"enum":["yes","no","unsure"],"type":"string"},{"type":"null"}],"default":null,"title":"Maintenance"},"other":{"anyOf":[{"enum":["yes","no","unsure"],"type":"string"},{"type":"null"}],"default":null,"title":"Other"},"other_description":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Other Description"},"service_contract":{"anyOf":[{"enum":["yes","no","unsure"],"type":"string"},{"type":"null"}],"default":null,"description":"Service contract or extended warranty","title":"Service Contract"}},"title":"AddOnInterest","type":"object"},"AssistantRef":{"description":"Which assistant prepared the deal, for the dealer's reference.","properties":{"contact":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Contact"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"session_ref":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque session or conversation reference.","title":"Session Ref"}},"title":"AssistantRef","type":"object"},"BuyerAddress":{"additionalProperties":false,"description":"Shopper's home address, shared with their OK. Used for tax and registration (county matters in Texas).\nSaved with the deal and visible only to that store, its region and group.","properties":{"city":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"City"},"county":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"County without 'County'","title":"County"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"title":"State"},"street":{"anyOf":[{"maxLength":160,"type":"string"},{"type":"null"}],"default":null,"title":"Street"},"street2":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"title":"Street2"},"zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"title":"Zip"}},"title":"BuyerAddress","type":"object"},"FinancingDetails":{"additionalProperties":false,"description":"Money the shopper is putting toward the car, as separate lines. Together they are the down payment.","properties":{"cash_down":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down at signing","title":"Cash Down"},"deposit":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Deposit already paid or to be paid to hold the car","title":"Deposit"},"pre_approval":{"anyOf":[{"$ref":"#/$defs/PreApproval"},{"type":"null"}],"default":null},"rebates":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Rebates the shopper expects (applied like cash down)","title":"Rebates"}},"title":"FinancingDetails","type":"object"},"HandoffContact":{"description":"How the dealer can reach the shopper. Ask the shopper first and share only with their OK. Give a phone or email, or at least a name plus preferred_contact.","properties":{"email":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Shopper email, e.g. name@example.com","title":"Email"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"notes":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"phone":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Shopper US phone with area code, e.g. 214-555-0100","title":"Phone"},"preferred_contact":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"email, phone or text","title":"Preferred Contact"}},"title":"HandoffContact","type":"object"},"PaymentScenario":{"description":"One what-if finance scenario. Omitted fields use the call's defaults ($0 down, 60 months, good credit).","properties":{"apr":{"anyOf":[{"maximum":36,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"APR percent; overrides credit_tier.","title":"Apr"},"cash":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to price paying cash: no loan or interest; omit apr, term_months, credit_tier and down_payment.","title":"Cash"},"credit_tier":{"anyOf":[{"enum":["excellent","good","fair","poor"],"type":"string"},{"type":"null"}],"default":null,"description":"Picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"down_payment":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD.","title":"Down Payment"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer qualifies for.","title":"Eligible Incentive Labels"},"name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Short label, e.g. '3k down 72 mo'.","title":"Name"},"payoff":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"term_months":{"anyOf":[{"maximum":96,"minimum":12,"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96.","title":"Term Months"},"trade_equity":{"anyOf":[{"maximum":500000,"minimum":-500000,"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown; no tax credit.","title":"Trade Equity"},"trade_value":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the state's trade-in tax credit).","title":"Trade Value"}},"title":"PaymentScenario","type":"object"},"PreApproval":{"additionalProperties":false,"description":"Only what the shopper already knows from a lender. Never ask for a Social Security number, date of birth or income.","properties":{"approved_amount":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Approved Amount"},"has_pre_approval":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Has Pre Approval"},"lender_name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Lender Name"},"rate_percent":{"anyOf":[{"maximum":40,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Rate Percent"}},"title":"PreApproval","type":"object"},"TradeDetails":{"additionalProperties":false,"description":"Optional trade-in details the shopper gives. Every field is optional; skip what the shopper does not know.","properties":{"color":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"title":"Color"},"make":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"title":"Make"},"model":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"title":"Model"},"odometer":{"anyOf":[{"maximum":999999,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Miles on the trade-in","title":"Odometer"},"payoff_amount":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"What the shopper still owes (same as payoff)","title":"Payoff Amount"},"payoff_lender":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Who the trade-in loan is with","title":"Payoff Lender"},"plate":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"License plate","title":"Plate"},"plate_state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"title":"Plate State"},"trim":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"title":"Trim"},"vin":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN of the trade-in","title":"Vin"},"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"title":"Year"}},"title":"TradeDetails","type":"object"}},"properties":{"add_on_interest":{"anyOf":[{"$ref":"#/$defs/AddOnInterest"},{"type":"null"}],"default":null,"description":"Optional: is the shopper interested in service_contract, gap, maintenance, other (yes, no or unsure)? No prices; the dealer covers these."},"assistant":{"anyOf":[{"$ref":"#/$defs/AssistantRef"},{"type":"null"}],"default":null,"description":"Optional assistant reference: name, session_ref, contact."},"buyer_address":{"anyOf":[{"$ref":"#/$defs/BuyerAddress"},{"type":"null"}],"default":null,"description":"Optional shopper address (street, city, state, zip, county), with their OK. Sets tax and registration; visible only to the deal's store, region and group."},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county without 'County'.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's five-digit ZIP; alone it resolves state, county and city.","title":"Buyer Zip"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Conditional incentive label_raw values the shopper qualifies for.","title":"Eligible Incentive Labels"},"financing_details":{"anyOf":[{"$ref":"#/$defs/FinancingDetails"},{"type":"null"}],"default":null,"description":"Optional separate deposit, cash_down and rebates (they add up to the down payment), plus pre_approval (has_pre_approval, lender_name, approved_amount, rate_percent; the rate is used for the payment unless scenario.apr is set). NEVER ask for a Social Security number or any part of one, date of birth or income."},"listing_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"dealer_key:VIN from search_inventory. Either this or vin is required.","title":"Listing Id"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"scenario":{"anyOf":[{"$ref":"#/$defs/PaymentScenario"},{"type":"null"}],"default":null,"description":"The financing scenario the shopper chose, same shape as one compare_payment_scenarios scenario (down_payment, term_months, credit_tier or apr, trade fields, or cash=true). Default: $0 down, 60 months, good credit."},"shopper_contact":{"anyOf":[{"$ref":"#/$defs/HandoffContact"},{"type":"null"}],"default":null,"description":"REQUIRED. Ask the shopper how the dealer should reach them, and share only with their OK: name, phone and/or email, preferred_contact (call, text or email), notes. Needs a phone or email, or a name plus preferred_contact."},"trade_details":{"anyOf":[{"$ref":"#/$defs/TradeDetails"},{"type":"null"}],"default":null,"description":"Optional trade-in details from the shopper: year, make, model, trim, vin, odometer, plate, plate_state, color, payoff_lender, payoff_amount."},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown (no tax credit).","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (used when the scenario does not set it).","title":"Trade Value"},"trade_vehicle":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Short description of the trade, e.g. '2021 Ford F-150 XLT, 48k mi'.","title":"Trade Vehicle"},"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN, if listing_id is not known. Rejected if several dealers list it.","title":"Vin"}},"title":"prepare_dealer_handoffArguments","type":"object"}⟨1063 unchanged words⟩ BEV.","title":"Fuel Type"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer group id (hierarchy: Group, then Region, then Store), e.g. meridian. See list_dealers.","title":"Group Id"},"include_near_misses":{"default":true,"description":"With ⟨376 unchanged words⟩ zip.","title":"Radius Miles"},"region_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Region inside a group, as group_id/region_id (e.g. meridian/dfw-metro) or a bare region id.","title":"Region Id"},"scenarios":{"anyOf":[{"items":{" ⟨151 unchanged words⟩ Not the full name.","title":"State"},"store_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Store id, dealer_key plus store ZIP, e.g. bluebonnetridge-75201.","title":"Store Id"},"term_months":{"anyOf":[{"type ⟨215 unchanged words⟩
DEMO. Cancel a saved search. Any shopper email stored for it is deleted.
DEMO. New cars that started matching a saved search after it was saved (or after `since`).
Use this when the shopper has picked a car and a deal structure and wants to take it to the dealer. Builds a structured dealer handoff package for ONE configured deal: vehicle and VIN, the full itemized out-the-door estimate (with excluded items such as optional add-ons), the chosen financing scenario with demo financing eligibility, trade and negative-equity details (loan-to-value), all warnings, the assistant name and session reference, a timestamp (UTC and America/Chicago) and an estimate-not-offer disclaimer. Returns the package as JSON plus a ready-to-send email body (email.subject, emai…
Optional and free. Registers your agent and returns an agent key (shown once) that gives it a durable, anonymous id in Moonshot Lab's bot analytics. Send it as the X-MoonshotLab-Agent-Key header, or add ?agent_key=<key> to the MCP URL. Nothing else changes: anonymous use keeps working, limits are the same, and no personal data is collected. Dealers only ever see aggregate demand by platform name.
DEMO. Save a car search and get alerted when new cars match. Returns a search_id (keep it; it is the only way to read or cancel the search) and an expiry (default 30 days, renewable). Check for new cars with get_new_matches, or give a callback_url. Shopper email alerts are optional and need explicit consent. On this demo, email sending is switched off (alerts are logged, not sent) and new arrivals are simulated.
⟨36 unchanged words⟩ overrides credit_tier.","title":"Apr"},"cash":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to price paying cash: no loan or interest; omit apr, term_months, credit_tier and down_payment.","title":"Cash"},"credit_tier":{"anyOf":[{"enum":["excellent", ⟨295 unchanged words⟩ ,"default":null,"description":"Buyer's five-digitZIP;ZIP.setsAlone it resolves buyer state, county and citywhen(echoedbuyer_stateinistax_location.resolutionomitted.with the source).","title":"Buyer Zip"},"listing_id" ⟨60 unchanged words⟩
⟨71 unchanged words⟩ and fee state. Defaults to the selling store'sstate. A ZIP alonestate,doesornotthechangestateitofhere.buyer_zip. States outside the 8 covered return a low-confidence ⟨14 unchanged words⟩ null"}],"default":null,"description":"Shopper'sBuyer's five-digitZIP, recorded withZIP.theAlonelocation.itPassresolvesbuyer_statebuyerandstate, countyorand cityas well; the ZIP alone does not(echoedsetinthemtax_location.resolutioninwiththisthetool.source).","title":"Buyer Zip"},"eligible_incentive_labels" ⟨207 unchanged words⟩
⟨52 unchanged words⟩ credit_tier) over term_months. Returns finance.estimated_monthly_payment rounded to $5,with monthly_payment_unrounded, monthly_payment_range (rounded outward, so it always contains the unrounded value), financing_eligibility (demo lender rules: minimum amount financed, max term by vehicle age and mileage, with flags), amount_financed_estimate, total_of_payments, finance_charge and every assumption, plus ⟨15 unchanged words⟩ comparable unless the terms match). Totals:total_cost_estimatetotal_cost_including_trade_equity (PRIMARY: cash down plus payments plus net trade equity given up) andtotal_cost_including_trade_equitycash_outlay_excluding_trade_equity (alsocashaddsdown plus payments); total_cost_estimate is a deprecated alias of thenetlatter,tradekeptequityforgivenoneup).version. For ONE set of terms only: to ⟨45 unchanged words⟩ across many listings, use search_inventory with max_monthly_payment (same ascanonical; payment_max is a deprecated alias). Estimate, not an offer; dealer sets ⟨10 unchanged words⟩
⟨99 unchanged words⟩ default":null,"description":"Buyer's five-digit ZIP.HereAlone itsetsresolves buyer state, county and citywhen(echoedbuyer_stateinistax_location.resolutionomitted.with the source).","title":"Buyer Zip"},"credit_tier" ⟨219 unchanged words⟩
⟨128 unchanged words⟩ payment_quote: dealer ad text, not a calculation. Each price_component has a plain label, source_text and method_text; fees and incentives carry tax_treatment (taxable or reduces_taxable_amount, whether it is inside the advertised price, and why).
⟨8 unchanged words⟩ store counts, plus the 4 fictional dealergroups.groups and a coverage summary: which metros have demo stores, with dealer, store and new/used listing counts per metro.
⟨287 unchanged words⟩ compare scenarios for one car, use compare_payment_scenarios. Every result has estimated_out_the_door (exact, same as estimate_out_the_door for the buyer location), availability (status, price_valid_until, last_updated, observed_at), seating_capacity, third_row and cargo_capacity_cu_ft (synthetic demo specs). sort=best_value score = 0.35 * cost_score + 0.30 * age_score + 0.35 * mileage_score (formula in best_value_formula). A zero result with zip returns coverage: nearest_store, nearest_new_inventory and nearest_qualifying_inventory with distance, match count and lowest out the door, plus a coverage_note. estimated_out_the_door on results and near_misses carries the same warnings and excluded_items (for example an optional add-on's name and price) that estimate_out_the_door returns. Each result has dealer_segment / dealer_type, third_row_type and sliding_doors. With payment inputs, estimated_payment has financing_eligibility, credit_tier and credit_tier_source (default when not given), negative_equity_rolled_in, loan_to_value_pct and warnings; the response has financing_summary. Pass financeable_only=true to drop listings the demo financing rules flag. Estimate, not an offer; dealer sets price, ⟨5 unchanged words⟩
before
{"$defs":{"FieldFilter":{"description":"One generic filter on any ontology field (see list_searchable_fields).","properties":{"field":{"description":"Dotted field path from list_searchable_fields, e.g. canonical.exterior_color.family, price_summary.doc_fee, incentives[].label_raw, store.name, payment.estimated_monthly. Shortcut names such as make, model, color, price, state also work.","title":"Field","type":"string"},"max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound for range (inclusive).","title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound for range (inclusive).","title":"Min"},"negate":{"default":false,"description":"True to invert the filter.","title":"Negate","type":"boolean"},"op":{"default":"eq","description":"eq exact (case-insensitive text); any_of with values; contains (text substring); range with min and/or max (numbers or ISO dates, inclusive); bool with value true/false; exists.","enum":["eq","any_of","contains","range","bool","exists"],"title":"Op","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Value for eq, contains, bool or exists.","title":"Value"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}]},"type":"array"},{"type":"null"}],"default":null,"description":"Values for any_of.","title":"Values"}},"required":["field"],"title":"FieldFilter","type":"object"},"PaymentScenario":{"description":"One what-if finance scenario. Omitted fields use the call's defaults ($0 down, 60 months, good credit).","properties":{"apr":{"anyOf":[{"maximum":36,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"APR percent; overrides credit_tier.","title":"Apr"},"credit_tier":{"anyOf":[{"enum":["excellent","good","fair","poor"],"type":"string"},{"type":"null"}],"default":null,"description":"Picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"down_payment":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD.","title":"Down Payment"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer qualifies for.","title":"Eligible Incentive Labels"},"name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Short label, e.g. '3k down 72 mo'.","title":"Name"},"payoff":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"term_months":{"anyOf":[{"maximum":96,"minimum":12,"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96.","title":"Term Months"},"trade_equity":{"anyOf":[{"maximum":500000,"minimum":-500000,"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown; no tax credit.","title":"Trade Equity"},"trade_value":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the state's trade-in tax credit).","title":"Trade Value"}},"title":"PaymentScenario","type":"object"}},"properties":{"apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"APR percent for payment estimates. If omitted, a demo APR by credit_tier is used.","title":"Apr"},"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"suv, sedan, pickup, hatchback, minivan or wagon. Use pickup for trucks.","title":"Body Style"},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city for payment tax lines.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county (without 'County') for payment tax lines.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state for payment tax and fees. Default: the selling store's state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's ZIP; sets buyer state and city when buyer_state is omitted. If no buyer location is given, zip is used, then the selling store (see payment_assumptions.buyer.source).","title":"Buyer Zip"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exact city of the selling store (for example Houston, Katy, Plano). Suburbs are separate cities, so for 'in or near a city' prefer zip plus radius_miles.","title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"new, used or cpo (certified pre-owned). used also returns cpo units.","title":"Condition"},"credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"excellent, good (default), fair or poor; picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer key from list_dealers, e.g. lonemesa.","title":"Dealer Key"},"down_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD for payment estimates. Default 0.","title":"Down Payment"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fwd, awd, rwd or 4wd.","title":"Drivetrain"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer says they qualify for; applied to payment estimates where a listing offers them. Off by default.","title":"Eligible Incentive Labels"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color family: white, black, silver, gray, blue, red, green or bronze.","title":"Exterior Color"},"filters":{"anyOf":[{"items":{"$ref":"#/$defs/FieldFilter"},"type":"array"},{"type":"null"}],"default":null,"description":"Generic filters on ANY ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment). All filters must match. See list_searchable_fields.","title":"Filters"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"gasoline, hybrid, plug_in_hybrid or electric. Use electric for EV or BEV.","title":"Fuel Type"},"include_near_misses":{"default":true,"description":"With a payment cap, also return up to 3 listings within $25 above it in near_misses, flagged above_target. Default true.","title":"Include Near Misses","type":"boolean"},"include_payment":{"default":false,"description":"True to add estimated_payment to every result without filtering on it.","title":"Include Payment","type":"boolean"},"limit":{"default":20,"description":"Results per page, 1 to 50. Each result is about 2 KB; 5 to 10 is usually enough.","title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, case-insensitive, e.g. Honda, Ford, Tesla. 14 makes are present.","title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum odometer miles.","title":"Max Mileage"},"max_monthly_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Same as payment_max: the shopper's monthly budget in USD, e.g. 300 for 'under $300/month'. The lower of the two wins if both are given.","title":"Max Monthly Payment"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model with its punctuation, case-insensitive: CR-V, F-150, Model 3, Mustang Mach-E.","title":"Model"},"offset":{"default":0,"description":"Paging offset.","title":"Offset","type":"integer"},"payment_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum estimated monthly finance payment in USD (demo estimate), e.g. 450.","title":"Payment Max"},"payment_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated monthly finance payment in USD (demo estimate).","title":"Payment Min"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum headline price in USD (before tax, title and dealer fees). For a budget that includes taxes and fees, check estimate_out_the_door.","title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum headline price in USD (before tax, title and dealer fees).","title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Radius in miles around zip.","title":"Radius Miles"},"scenarios":{"anyOf":[{"items":{"$ref":"#/$defs/PaymentScenario"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional what-if finance scenarios (up to 6). Each returned listing gets payment_scenarios with payment, amount financed, total interest and total cost per scenario. Filter and sort still use the main inputs.","title":"Scenarios"},"sort":{"default":"price_asc","description":"price_asc (default), price_desc, year_desc, mileage_asc, distance_asc (needs zip), payment_asc or payment_desc.","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter code of the selling store's state: TX, CA, FL, GA, AZ, IL, NY or OH. Not the full name.","title":"State"},"term_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96. Default 60.","title":"Term Months"},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity in USD if allowance and payoff are unknown (negative for upside-down); no tax credit is applied for it.","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the trade-in tax credit where the state allows it).","title":"Trade Value"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trim name, e.g. LX, EX-L, Lariat.","title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest model year.","title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest model year.","title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit US ZIP of the shopper. With radius_miles, filters by straight-line distance to the selling store and adds distance_miles to each result.","title":"Zip"}},"title":"search_inventoryArguments","type":"object"}after
{"$defs":{"FieldFilter":{"description":"One generic filter on any ontology field (see list_searchable_fields).","properties":{"field":{"description":"Dotted field path from list_searchable_fields, e.g. canonical.exterior_color.family, price_summary.doc_fee, incentives[].label_raw, store.name, payment.estimated_monthly. Shortcut names such as make, model, color, price, state also work.","title":"Field","type":"string"},"max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound for range (inclusive).","title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound for range (inclusive).","title":"Min"},"negate":{"default":false,"description":"True to invert the filter.","title":"Negate","type":"boolean"},"op":{"default":"eq","description":"eq exact (case-insensitive text); any_of with values; contains (text substring); range with min and/or max (numbers or ISO dates, inclusive); bool with value true/false; exists.","enum":["eq","any_of","contains","range","bool","exists"],"title":"Op","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Value for eq, contains, bool or exists.","title":"Value"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}]},"type":"array"},{"type":"null"}],"default":null,"description":"Values for any_of.","title":"Values"}},"required":["field"],"title":"FieldFilter","type":"object"},"PaymentScenario":{"description":"One what-if finance scenario. Omitted fields use the call's defaults ($0 down, 60 months, good credit).","properties":{"apr":{"anyOf":[{"maximum":36,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"APR percent; overrides credit_tier.","title":"Apr"},"cash":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to price paying cash: no loan or interest; omit apr, term_months, credit_tier and down_payment.","title":"Cash"},"credit_tier":{"anyOf":[{"enum":["excellent","good","fair","poor"],"type":"string"},{"type":"null"}],"default":null,"description":"Picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"down_payment":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD.","title":"Down Payment"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer qualifies for.","title":"Eligible Incentive Labels"},"name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Short label, e.g. '3k down 72 mo'.","title":"Name"},"payoff":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"term_months":{"anyOf":[{"maximum":96,"minimum":12,"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96.","title":"Term Months"},"trade_equity":{"anyOf":[{"maximum":500000,"minimum":-500000,"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown; no tax credit.","title":"Trade Equity"},"trade_value":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the state's trade-in tax credit).","title":"Trade Value"}},"title":"PaymentScenario","type":"object"}},"properties":{"apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"APR percent for payment estimates. If omitted, a demo APR by credit_tier is used.","title":"Apr"},"best_value_needs":{"anyOf":[{"items":{"enum":["seats","cargo","full_third_row","sliding_doors","low_mileage","newer","budget_headroom"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"With sort=best_value, shopper needs that also score: seats, cargo, full_third_row, sliding_doors, low_mileage, newer, budget_headroom (needs max_out_the_door). Score = 0.70 x base + 0.30 x mean need score; ranking_rationale shows each part.","title":"Best Value Needs"},"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"suv, sedan, pickup, hatchback, minivan or wagon. Use pickup for trucks.","title":"Body Style"},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city for payment tax lines.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county (without 'County') for payment tax lines.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state for payment tax and fees. Default: the selling store's state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's ZIP; fills any missing buyer state, county and city. If no buyer location is given, zip is used, then the selling store (see out_the_door_assumptions.buyer).","title":"Buyer Zip"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exact city of the selling store (for example Houston, Katy, Plano). Suburbs are separate cities, so for 'in or near a city' prefer zip plus radius_miles.","title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"new, used or cpo (certified pre-owned). used also returns cpo units.","title":"Condition"},"credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"excellent, good (default), fair or poor; picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer key from list_dealers, e.g. lonemesa.","title":"Dealer Key"},"dealer_segment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"franchise, independent_used or bhph (buy-here-pay-here). Each result shows dealer_segment and dealer_type.","title":"Dealer Segment"},"down_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD for payment estimates. Default 0.","title":"Down Payment"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fwd, awd, rwd or 4wd.","title":"Drivetrain"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer says they qualify for; applied to payment estimates where a listing offers them. Off by default.","title":"Eligible Incentive Labels"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color family: white, black, silver, gray, blue, red, green or bronze.","title":"Exterior Color"},"filters":{"anyOf":[{"items":{"$ref":"#/$defs/FieldFilter"},"type":"array"},{"type":"null"}],"default":null,"description":"Generic filters on ANY ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment). All filters must match. See list_searchable_fields.","title":"Filters"},"financeable_only":{"default":false,"description":"True to drop listings whose payment estimate fails the demo financing rules (minimum amount financed, max term by age and mileage) at these terms. Recommended with max_monthly_payment; financing_summary counts what was dropped.","title":"Financeable Only","type":"boolean"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"gasoline, hybrid, plug_in_hybrid or electric. Use electric for EV or BEV.","title":"Fuel Type"},"include_near_misses":{"default":true,"description":"With a payment cap, also return up to 3 listings within $25 above it in near_misses, flagged above_target. Default true.","title":"Include Near Misses","type":"boolean"},"include_payment":{"default":false,"description":"True to add estimated_payment to every result without filtering on it.","title":"Include Payment","type":"boolean"},"limit":{"default":20,"description":"Results per page, 1 to 50. Each result is about 2 KB; 5 to 10 is usually enough.","title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, case-insensitive, e.g. Honda, Ford, Tesla. 14 makes are present.","title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum odometer miles.","title":"Max Mileage"},"max_monthly_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Canonical monthly payment cap: the shopper's monthly budget in USD, e.g. 300 for 'under $300/month' (demo estimate).","title":"Max Monthly Payment"},"max_out_the_door":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum estimated out-the-door total in USD for the buyer location (tax, title, registration, dealer fees, minus trade). Exact, unrounded, and the same figure estimate_out_the_door returns for the same inputs.","title":"Max Out The Door"},"min_out_the_door":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated out-the-door total in USD (same basis as max_out_the_door).","title":"Min Out The Door"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model with its punctuation, case-insensitive: CR-V, F-150, Model 3, Mustang Mach-E.","title":"Model"},"offset":{"default":0,"description":"Paging offset.","title":"Offset","type":"integer"},"payment_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"DEPRECATED alias of max_monthly_payment (still accepted; the lower wins if both are given).","title":"Payment Max"},"payment_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated monthly finance payment in USD (demo estimate).","title":"Payment Min"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum headline price in USD (before tax, title and dealer fees). For a budget that includes taxes and fees, check estimate_out_the_door.","title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum headline price in USD (before tax, title and dealer fees).","title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Radius in miles around zip.","title":"Radius Miles"},"scenarios":{"anyOf":[{"items":{"$ref":"#/$defs/PaymentScenario"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional what-if finance scenarios (up to 6). Each returned listing gets payment_scenarios with payment, amount financed, total interest and total cost per scenario. Filter and sort still use the main inputs.","title":"Scenarios"},"seating_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum seats, e.g. 7 for a third row family vehicle (synthetic demo spec).","title":"Seating Min"},"sliding_doors":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for sliding rear doors (minivans).","title":"Sliding Doors"},"sort":{"default":"price_asc","description":"price_asc (default), price_desc, year_desc, mileage_asc, distance_asc (needs zip), payment_asc, payment_desc, otd_asc (estimated out the door) or best_value (documented score over out-the-door cost, age and mileage; each result gets ranking_rationale).","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter code of the selling store's state: TX, CA, FL, GA, AZ, IL, NY or OH. Not the full name.","title":"State"},"term_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96. Default 60.","title":"Term Months"},"third_row":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for third row seating only, false to exclude it (synthetic demo spec).","title":"Third Row"},"third_row_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"full (adult-usable, car-seat capable) or compact (small, occasional; e.g. Tiguan). Demo spec.","title":"Third Row Type"},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity in USD if allowance and payoff are unknown (negative for upside-down); no tax credit is applied for it.","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the trade-in tax credit where the state allows it).","title":"Trade Value"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trim name, e.g. LX, EX-L, Lariat.","title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest model year.","title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest model year.","title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit US ZIP of the shopper. With radius_miles, filters by straight-line distance to the selling store and adds distance_miles to each result.","title":"Zip"}},"title":"search_inventoryArguments","type":"object"}⟨225 unchanged words⟩ rounded to $5, with a range) and dealer_advertised_payment when the listing shows one; the response haspayment_assumptions.payment_assumptions andNotaanone-lineofferassumptions_summaryoftocredit;read back to the shopper. For 'under $300/month' pass max_monthly_payment=300. With a cap, near_misses lists up to 3 cars just above it, and a zero result returns to_reach_target (extra down payment, or a 72 or 84 month term). To compare scenarios for one car, use compare_payment_scenarios. Estimate, not an offer; dealer sets price, lender sets rate. Not penny-accurate.
before
{"$defs":{"FieldFilter":{"description":"One generic filter on any ontology field (see list_searchable_fields).","properties":{"field":{"description":"Dotted field path from list_searchable_fields, e.g. canonical.exterior_color.family, price_summary.doc_fee, incentives[].label_raw, store.name, payment.estimated_monthly. Shortcut names such as make, model, color, price, state also work.","title":"Field","type":"string"},"max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound for range (inclusive).","title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound for range (inclusive).","title":"Min"},"negate":{"default":false,"description":"True to invert the filter.","title":"Negate","type":"boolean"},"op":{"default":"eq","description":"eq exact (case-insensitive text); any_of with values; contains (text substring); range with min and/or max (numbers or ISO dates, inclusive); bool with value true/false; exists.","enum":["eq","any_of","contains","range","bool","exists"],"title":"Op","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Value for eq, contains, bool or exists.","title":"Value"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}]},"type":"array"},{"type":"null"}],"default":null,"description":"Values for any_of.","title":"Values"}},"required":["field"],"title":"FieldFilter","type":"object"}},"properties":{"apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"APR percent for payment estimates. If omitted, a demo APR by credit_tier is used.","title":"Apr"},"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"suv, sedan, pickup, hatchback, minivan or wagon. Use pickup for trucks.","title":"Body Style"},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city for payment tax lines.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county (without 'County') for payment tax lines.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state for payment tax and fees. Default: the selling store's state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's ZIP; sets buyer state and city when buyer_state is omitted.","title":"Buyer Zip"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exact city of the selling store (for example Houston, Katy, Plano). Suburbs are separate cities, so for 'in or near a city' prefer zip plus radius_miles.","title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"new, used or cpo (certified pre-owned). used also returns cpo units.","title":"Condition"},"credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"excellent, good (default), fair or poor; picks the demo APR when apr is omitted.","title":"Credit Tier"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer key from list_dealers, e.g. lonemesa.","title":"Dealer Key"},"down_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD for payment estimates. Default 0.","title":"Down Payment"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fwd, awd, rwd or 4wd.","title":"Drivetrain"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color family: white, black, silver, gray, blue, red, green or bronze.","title":"Exterior Color"},"filters":{"anyOf":[{"items":{"$ref":"#/$defs/FieldFilter"},"type":"array"},{"type":"null"}],"default":null,"description":"Generic filters on ANY ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment). All filters must match. See list_searchable_fields.","title":"Filters"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"gasoline, hybrid, plug_in_hybrid or electric. Use electric for EV or BEV.","title":"Fuel Type"},"include_payment":{"default":false,"description":"True to add estimated_payment to every result without filtering on it.","title":"Include Payment","type":"boolean"},"limit":{"default":20,"description":"Results per page, 1 to 50. Each result is about 2 KB; 5 to 10 is usually enough.","title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, case-insensitive, e.g. Honda, Ford, Tesla. 14 makes are present.","title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum odometer miles.","title":"Max Mileage"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model with its punctuation, case-insensitive: CR-V, F-150, Model 3, Mustang Mach-E.","title":"Model"},"offset":{"default":0,"description":"Paging offset.","title":"Offset","type":"integer"},"payment_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum estimated monthly finance payment in USD (demo estimate), e.g. 450.","title":"Payment Max"},"payment_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated monthly finance payment in USD (demo estimate).","title":"Payment Min"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum headline price in USD (before tax, title and dealer fees). For a budget that includes taxes and fees, check estimate_out_the_door.","title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum headline price in USD (before tax, title and dealer fees).","title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Radius in miles around zip.","title":"Radius Miles"},"sort":{"default":"price_asc","description":"price_asc (default), price_desc, year_desc, mileage_asc, distance_asc (needs zip), payment_asc or payment_desc.","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter code of the selling store's state: TX, CA, FL, GA, AZ, IL, NY or OH. Not the full name.","title":"State"},"term_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96. Default 60.","title":"Term Months"},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity in USD if allowance and payoff are unknown (negative for upside-down); no tax credit is applied for it.","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the trade-in tax credit where the state allows it).","title":"Trade Value"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trim name, e.g. LX, EX-L, Lariat.","title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest model year.","title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest model year.","title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit US ZIP of the shopper. With radius_miles, filters by straight-line distance to the selling store and adds distance_miles to each result.","title":"Zip"}},"title":"search_inventoryArguments","type":"object"}after
{"$defs":{"FieldFilter":{"description":"One generic filter on any ontology field (see list_searchable_fields).","properties":{"field":{"description":"Dotted field path from list_searchable_fields, e.g. canonical.exterior_color.family, price_summary.doc_fee, incentives[].label_raw, store.name, payment.estimated_monthly. Shortcut names such as make, model, color, price, state also work.","title":"Field","type":"string"},"max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound for range (inclusive).","title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound for range (inclusive).","title":"Min"},"negate":{"default":false,"description":"True to invert the filter.","title":"Negate","type":"boolean"},"op":{"default":"eq","description":"eq exact (case-insensitive text); any_of with values; contains (text substring); range with min and/or max (numbers or ISO dates, inclusive); bool with value true/false; exists.","enum":["eq","any_of","contains","range","bool","exists"],"title":"Op","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Value for eq, contains, bool or exists.","title":"Value"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}]},"type":"array"},{"type":"null"}],"default":null,"description":"Values for any_of.","title":"Values"}},"required":["field"],"title":"FieldFilter","type":"object"},"PaymentScenario":{"description":"One what-if finance scenario. Omitted fields use the call's defaults ($0 down, 60 months, good credit).","properties":{"apr":{"anyOf":[{"maximum":36,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"APR percent; overrides credit_tier.","title":"Apr"},"credit_tier":{"anyOf":[{"enum":["excellent","good","fair","poor"],"type":"string"},{"type":"null"}],"default":null,"description":"Picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"down_payment":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD.","title":"Down Payment"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer qualifies for.","title":"Eligible Incentive Labels"},"name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Short label, e.g. '3k down 72 mo'.","title":"Name"},"payoff":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"term_months":{"anyOf":[{"maximum":96,"minimum":12,"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96.","title":"Term Months"},"trade_equity":{"anyOf":[{"maximum":500000,"minimum":-500000,"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity if allowance and payoff are unknown; no tax credit.","title":"Trade Equity"},"trade_value":{"anyOf":[{"maximum":500000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the state's trade-in tax credit).","title":"Trade Value"}},"title":"PaymentScenario","type":"object"}},"properties":{"apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"APR percent for payment estimates. If omitted, a demo APR by credit_tier is used.","title":"Apr"},"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"suv, sedan, pickup, hatchback, minivan or wagon. Use pickup for trucks.","title":"Body Style"},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city for payment tax lines.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county (without 'County') for payment tax lines.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state for payment tax and fees. Default: the selling store's state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's ZIP; sets buyer state and city when buyer_state is omitted. If no buyer location is given, zip is used, then the selling store (see payment_assumptions.buyer.source).","title":"Buyer Zip"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exact city of the selling store (for example Houston, Katy, Plano). Suburbs are separate cities, so for 'in or near a city' prefer zip plus radius_miles.","title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"new, used or cpo (certified pre-owned). used also returns cpo units.","title":"Condition"},"credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"excellent, good (default), fair or poor; picks the demo APR when apr is omitted. Credit tiers (demo APR new / used): excellent about 720 and up (6.0% / 8.5%); good about 660 to 719 (7.5% / 11.0%); fair about 620 to 659 (11.5% / 16.0%); poor below about 620 (15.5% / 20.0%).","title":"Credit Tier"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer key from list_dealers, e.g. lonemesa.","title":"Dealer Key"},"down_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD for payment estimates. Default 0.","title":"Down Payment"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fwd, awd, rwd or 4wd.","title":"Drivetrain"},"eligible_incentive_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"label_raw values of conditional incentives the buyer says they qualify for; applied to payment estimates where a listing offers them. Off by default.","title":"Eligible Incentive Labels"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color family: white, black, silver, gray, blue, red, green or bronze.","title":"Exterior Color"},"filters":{"anyOf":[{"items":{"$ref":"#/$defs/FieldFilter"},"type":"array"},{"type":"null"}],"default":null,"description":"Generic filters on ANY ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment). All filters must match. See list_searchable_fields.","title":"Filters"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"gasoline, hybrid, plug_in_hybrid or electric. Use electric for EV or BEV.","title":"Fuel Type"},"include_near_misses":{"default":true,"description":"With a payment cap, also return up to 3 listings within $25 above it in near_misses, flagged above_target. Default true.","title":"Include Near Misses","type":"boolean"},"include_payment":{"default":false,"description":"True to add estimated_payment to every result without filtering on it.","title":"Include Payment","type":"boolean"},"limit":{"default":20,"description":"Results per page, 1 to 50. Each result is about 2 KB; 5 to 10 is usually enough.","title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, case-insensitive, e.g. Honda, Ford, Tesla. 14 makes are present.","title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum odometer miles.","title":"Max Mileage"},"max_monthly_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Same as payment_max: the shopper's monthly budget in USD, e.g. 300 for 'under $300/month'. The lower of the two wins if both are given.","title":"Max Monthly Payment"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model with its punctuation, case-insensitive: CR-V, F-150, Model 3, Mustang Mach-E.","title":"Model"},"offset":{"default":0,"description":"Paging offset.","title":"Offset","type":"integer"},"payment_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum estimated monthly finance payment in USD (demo estimate), e.g. 450.","title":"Payment Max"},"payment_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated monthly finance payment in USD (demo estimate).","title":"Payment Min"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum headline price in USD (before tax, title and dealer fees). For a budget that includes taxes and fees, check estimate_out_the_door.","title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum headline price in USD (before tax, title and dealer fees).","title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Radius in miles around zip.","title":"Radius Miles"},"scenarios":{"anyOf":[{"items":{"$ref":"#/$defs/PaymentScenario"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional what-if finance scenarios (up to 6). Each returned listing gets payment_scenarios with payment, amount financed, total interest and total cost per scenario. Filter and sort still use the main inputs.","title":"Scenarios"},"sort":{"default":"price_asc","description":"price_asc (default), price_desc, year_desc, mileage_asc, distance_asc (needs zip), payment_asc or payment_desc.","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter code of the selling store's state: TX, CA, FL, GA, AZ, IL, NY or OH. Not the full name.","title":"State"},"term_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96. Default 60.","title":"Term Months"},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity in USD if allowance and payoff are unknown (negative for upside-down); no tax credit is applied for it.","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the trade-in tax credit where the state allows it).","title":"Trade Value"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trim name, e.g. LX, EX-L, Lariat.","title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest model year.","title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest model year.","title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit US ZIP of the shopper. With radius_miles, filters by straight-line distance to the selling store and adds distance_miles to each result.","title":"Zip"}},"title":"search_inventoryArguments","type":"object"}Use this to compare several financing what-ifs for ONE listing side by side in one call (for example cash down, term, credit tier or APR, trade-in, incentives). Each scenario reruns the itemized out-the-door estimate and returns estimated_out_the_door, amount_financed_estimate, apr_percent and apr_source, term_months, estimated_monthly_payment (rounded to $5) with a range, total_interest_estimate, total_cost_estimate (cash down plus all payments, trade not counted) and total_cost_including_trade_equity (also adds the net trade equity given up; use it to compare trade and no-trade options), pl…
⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Shopper's city, e.g. Chicago. Some city taxes depend on it; it can also imply the county.","title":"Buyer City"},"buyer_county":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Shopper's county name without the word County, e.g. Harris, Cook, Orange. Improves local tax lines.","title":"Buyer County"},"buyer_state":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Shopper's two-letter state; sets the tax and fee state. Defaults to the selling store's state. A ZIP alone does not change it here. States outside the 8 covered return a low-confidence estimate without tax and government fees.","title":"Buyer State"},"buyer_zip":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Shopper's five-digit ZIP, recorded with the location. Pass buyer_state and county or city as well; the ZIP alone does not set them in this tool.","title":"Buyer Zip"},"eligible_incentive_labels":{" ⟨6 unchanged words⟩ type":"null"}],"default":null,"description":"label_raw values of conditional incentives from get_price_breakdown that the shopper qualifies for (case-insensitive).","title":"Eligible Incentive Labels"},"financed": ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"True if the purchase will be financed, false for cash. Some fees and incentives depend on it; if omitted they are flagged as uncertain.","title":"Financed"},"lender_name":{"anyOf" ⟨2 unchanged words⟩ type":"null"}],"default":null,"description":"Lender holding the trade-in loan (optional, not stored).","title":"Lender Name"},"listing_id":{"description":"dealer_key:VIN from search_inventory.","title":"Listing Id","type":"string" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Loan payoff in USD still owed on the trade-in.","title":"Payoff"},"plate_transfer":{"default":false,"description":"True to transfer existing plates where the state allows it.","title":"Plate Transfer","type":"boolean" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"State where the car will be registered, if different from buyer_state.","title":"Registration State"},"trade_value":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Trade-in allowance in USD offered or expected for the shopper's car.","title":"Trade Value"},"vehicle_weight_lbs":{" ⟨3 unchanged words⟩ {"type":"null"}],"default":null,"description":"Vehicle weight, used by weight-based registration fees.","title":"Vehicle Weight Lbs"}}," ⟨6 unchanged words⟩
Fictional dealer profile: registry entity, stores (selling locations) with fictional addresses and 555 phone numbers, group, state rules and a page of inventory. Not a real business; do not tell anyone to call or visit.
{"properties":{"dealer_key":{"description":"Dealer key from list_dealers or a search result, e.g. bluebonnetridge.","title":"Dealer Key","type":"string"},"inventory_limit":{"default":20,"description":"Inventory rows to include.","title":"Inventory Limit","type":"integer"},"inventory_offset":{"default":0,"description":"Paging offset for inventory.","title":"Inventory Offset","type":" ⟨7 unchanged words⟩
⟨7 unchanged words⟩ (method 'synthetic'). listing_id is dealer_key:VIN (as returned by search_inventory) or the urn. The vehicle-to-store link is in listing.selling_location (link_status, selling_location_id, candidates, flags such as group_site_lists_sister_store or multi_store_unstated); the dealer block is the advertising dealer. For price and fees in a compact form, use get_price_breakdown.
{"properties":{"listing_id":{"description":"dealer_key:VIN from search_inventory, or the listing urn.","title":"Listing Id","type":"string" ⟨6 unchanged words⟩
Media block for a listing: self-generated SVG placeholderimageimagesURLslabeled DEMO (photo, video poster, spin), withrights notes. They are not photos of a real car. No video or 360 viewer exists in the demo.
{"properties":{"limit":{"default":50,"description":"Maximum items, 0 to 100.","title":"Limit","type":"integer"},"listing_id":{"description":"dealer_key:VIN from search_inventory.","title":"Listing Id","type":"string" ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filter by item type: photo, video (poster image only) or spin_exterior.","title":"Types"}},"required":[ ⟨5 unchanged words⟩
Schema links,vocabulariesschema version, covered states,coveredcondition values, search sorts and the value-wrapperformat.format ({v, m, c, src}). For the list of filterable fields and allowed values, use list_searchable_fields.
PriceUsecomponentsthis to see what the dealer LISTS for ONE listing, as published: headline price, MSRP (new cars), price_components, dealer fees (doc fee and others) and fee bundles (parts marked part_of_bundle,all-buyernotvsdouble counted),conditionalflagsincentivessuch as whether the advertised price already includes fees, options, incentives split into all_buyer (already in the price) and conditional (not in the price), and the state'spublic tax and feerulesRULES with data-flag checks. It takes no buyer inputs and computes no tax amounts or total. Use estimate_out_the_door next for the buyer's total with tax, title, registration and fees, and get_payment_estimate for a monthly payment. Pass conditional incentive label_raw values to those tools as eligible_incentive_labels only if the shopper qualifies. A dealer-advertised monthly payment, when present, is a price_components item of type payment_quote: dealer ad text, not a calculation.
{"properties":{"listing_id":{"description":"dealer_key:VIN from search_inventory.","title":"Listing Id","type":"string" ⟨6 unchanged words⟩
Ready-made demo trade-in scenarios (one per state)thatwithcantrade_valuebeandpassedpayoff toestimate_out_the_door.pass to estimate_out_the_door or get_payment_estimate.
⟨18 unchanged words⟩ , AZ, IL, NY and OH).conditionResults are not real vehicles for sale; say so when you show them. Each result has listing_id (dealer_key:VIN),newvehicle basics,usedheadline_priceor(beforecpo.tax,sort:titleprice_ascand fees),price_descdealer_name, andyear_descselling_location: the store that holds the unit,mileage_ascwith address and phone. link_status is linked,distance_asc.or ambiguouszipwhenplusthe listing does not say which of the dealer's stores holds it (see selling_location_candidates). A unit can be held at a sister store run by another dealer in the same group; operated_by_dealer_id then differs from dealer_id. Matching is exact on vocabularies, so a total of 0 often means a wrong value: check the parameter descriptions, widen radius_miles or drop a filter; a zero total also returns hints. The named parameters are shortcuts. filters reaches every other attribute: for example {"field": "canonical.vin", "op": "eq", "value": "<VIN>"} finds a VIN, {"field": "price_summary.doc_fee", "op": "range", "max": 300}, {"field": "incentives[].label_raw", "op": "eq", "value": "Military Appreciation"}. Payment search: payment_max / payment_min filter on a DEMO monthly finance estimate computed per listing from its itemized out-the-door estimate (tax, title, registration, dealer fees) for the buyer location, minus down payment and trade equity, at a demo APR bystraight-linecreditdistancetier unless apr is given. Each result then has estimated_payment (rounded to $5, with a range) and thesellingresponsestore.haslimitpayment_assumptions.isNotcappedanatoffer50.of credit; not penny-accurate.
before
{"properties":{"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Body Style"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Condition"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dealer Key"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Drivetrain"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Fuel Type"},"limit":{"default":20,"title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Max Mileage"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Model"},"offset":{"default":0,"title":"Offset","type":"integer"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Radius Miles"},"sort":{"default":"price_asc","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Zip"}},"title":"search_inventoryArguments","type":"object"}after
{"$defs":{"FieldFilter":{"description":"One generic filter on any ontology field (see list_searchable_fields).","properties":{"field":{"description":"Dotted field path from list_searchable_fields, e.g. canonical.exterior_color.family, price_summary.doc_fee, incentives[].label_raw, store.name, payment.estimated_monthly. Shortcut names such as make, model, color, price, state also work.","title":"Field","type":"string"},"max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound for range (inclusive).","title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound for range (inclusive).","title":"Min"},"negate":{"default":false,"description":"True to invert the filter.","title":"Negate","type":"boolean"},"op":{"default":"eq","description":"eq exact (case-insensitive text); any_of with values; contains (text substring); range with min and/or max (numbers or ISO dates, inclusive); bool with value true/false; exists.","enum":["eq","any_of","contains","range","bool","exists"],"title":"Op","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Value for eq, contains, bool or exists.","title":"Value"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}]},"type":"array"},{"type":"null"}],"default":null,"description":"Values for any_of.","title":"Values"}},"required":["field"],"title":"FieldFilter","type":"object"}},"properties":{"apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"APR percent for payment estimates. If omitted, a demo APR by credit_tier is used.","title":"Apr"},"body_style":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"suv, sedan, pickup, hatchback, minivan or wagon. Use pickup for trucks.","title":"Body Style"},"buyer_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's city for payment tax lines.","title":"Buyer City"},"buyer_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's county (without 'County') for payment tax lines.","title":"Buyer County"},"buyer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's two-letter state for payment tax and fees. Default: the selling store's state.","title":"Buyer State"},"buyer_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Buyer's ZIP; sets buyer state and city when buyer_state is omitted.","title":"Buyer Zip"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exact city of the selling store (for example Houston, Katy, Plano). Suburbs are separate cities, so for 'in or near a city' prefer zip plus radius_miles.","title":"City"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"new, used or cpo (certified pre-owned). used also returns cpo units.","title":"Condition"},"credit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"excellent, good (default), fair or poor; picks the demo APR when apr is omitted.","title":"Credit Tier"},"dealer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer key from list_dealers, e.g. lonemesa.","title":"Dealer Key"},"down_payment":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cash down in USD for payment estimates. Default 0.","title":"Down Payment"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fwd, awd, rwd or 4wd.","title":"Drivetrain"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color family: white, black, silver, gray, blue, red, green or bronze.","title":"Exterior Color"},"filters":{"anyOf":[{"items":{"$ref":"#/$defs/FieldFilter"},"type":"array"},{"type":"null"}],"default":null,"description":"Generic filters on ANY ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment). All filters must match. See list_searchable_fields.","title":"Filters"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"gasoline, hybrid, plug_in_hybrid or electric. Use electric for EV or BEV.","title":"Fuel Type"},"include_payment":{"default":false,"description":"True to add estimated_payment to every result without filtering on it.","title":"Include Payment","type":"boolean"},"limit":{"default":20,"description":"Results per page, 1 to 50. Each result is about 2 KB; 5 to 10 is usually enough.","title":"Limit","type":"integer"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, case-insensitive, e.g. Honda, Ford, Tesla. 14 makes are present.","title":"Make"},"max_mileage":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum odometer miles.","title":"Max Mileage"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model with its punctuation, case-insensitive: CR-V, F-150, Model 3, Mustang Mach-E.","title":"Model"},"offset":{"default":0,"description":"Paging offset.","title":"Offset","type":"integer"},"payment_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum estimated monthly finance payment in USD (demo estimate), e.g. 450.","title":"Payment Max"},"payment_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated monthly finance payment in USD (demo estimate).","title":"Payment Min"},"payoff":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Loan payoff owed on the trade-in, USD.","title":"Payoff"},"price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum headline price in USD (before tax, title and dealer fees). For a budget that includes taxes and fees, check estimate_out_the_door.","title":"Price Max"},"price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum headline price in USD (before tax, title and dealer fees).","title":"Price Min"},"radius_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Radius in miles around zip.","title":"Radius Miles"},"sort":{"default":"price_asc","description":"price_asc (default), price_desc, year_desc, mileage_asc, distance_asc (needs zip), payment_asc or payment_desc.","title":"Sort","type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter code of the selling store's state: TX, CA, FL, GA, AZ, IL, NY or OH. Not the full name.","title":"State"},"term_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Loan term in months, 12 to 96. Default 60.","title":"Term Months"},"trade_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net trade equity in USD if allowance and payoff are unknown (negative for upside-down); no tax credit is applied for it.","title":"Trade Equity"},"trade_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Trade-in allowance in USD (gets the trade-in tax credit where the state allows it).","title":"Trade Value"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trim name, e.g. LX, EX-L, Lariat.","title":"Trim"},"year_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest model year.","title":"Year Max"},"year_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest model year.","title":"Year Min"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit US ZIP of the shopper. With radius_miles, filters by straight-line distance to the selling store and adds distance_miles to each result.","title":"Zip"}},"title":"search_inventoryArguments","type":"object"}Use this to answer 'what would my monthly payment be' for ONE listing. It runs the same itemized out-the-door calculation as estimate_out_the_door (always treated as financed) and turns it into a DEMO monthly finance payment: out-the-door total minus down payment and trade equity, amortized at the APR (or a demo APR by credit_tier) over term_months. Returns finance.estimated_monthly_payment rounded to $5, monthly_payment_range, amount_financed_estimate, total_of_payments, finance_charge and every assumption, plus the out-the-door figure it used and any dealer-advertised payment shown separate…
Every filterable ontology field (vehicle, listing, store, dealer, price, fee, incentive, media, payment) with its type, range or allowed values, shortcut names, the operators (eq, any_of, contains, range, bool, exists, negate) and example filters for search_inventory. The full compact list is about 30 KB, so narrow it with prefix or query.