AI Storefront
Browse the documentation

Rating-Territory Dispersion Panel

How dispersed used-vehicle prices are by state for a segment or nameplate: percentiles, standard deviation, coefficient of variation and the tail, territory by territory.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Rating-Territory Dispersion Panel product page.

At a glance

Price $14.99 per run.
Tool name generate_rating_territory_dispersion
Scope reports:rating-territory-dispersion-panel
Built for Insurance Adjuster, Market Researcher

What it does

The rating-territory panel for one segment (a body type) or one nameplate (a make, optionally a model), optionally a model-year band: every US state where it sold, most dispersed first, each read from its latest month with 30 or more priced sales: the priced sample (n), the Low end, median and High end of the advertised asking price at exit (the 25th, 50th and 75th percentiles), the 95th percentile, the standard deviation, the coefficient of variation (standard deviation over the mean), the tail above the median (the 95th percentile minus the median), and the minimum and maximum; the nation as the reference. A read names the most and least dispersed territories, the pair of states that share a median but not a tail, the run of medians and tails, and how many states are more dispersed than the nation. A 12-month window adds each state's coefficient of variation month by month and the full state-by-month panel as a CSV. From the Sold Summary API: a sale is inferred when a listing leaves a dealer website and every price is the advertised asking price at exit, which runs above settlement and negotiated values, so the panel is a relative read between territories, never claim severities or an actual-cash-value level. Use when an actuary, insurer or researcher asks how dispersed vehicle values are by state, which territories carry the heaviest tails, or how two states with the same price level differ in spread. Do NOT use for one exact car as of a loss month (use Settlement Anchor Band), for a total-loss value with comparables (use Total Loss Report), or for where a nameplate is cheapest by state (use Regional Arbitrage Map). State grain, not ZIP or radius; territories are listed but not ranked. PRICING: $14.99 per run.

Arguments

Argument What it is Example
body_type Recommended The segment: SUV, Sedan, Pickup, Hatchback, Minivan, Coupe, Wagon, Convertible, Cargo Van or Passenger Van. Pass a body type or a make. SUV
make Recommended A make (e.g. Ford) instead of a body type; add a model for one nameplate. Ford
model Optional Model (e.g. F-150). Use with make. F-150
year_range Optional Model years to include, e.g. 2018-2024, for the insured fleet's age range. Leave blank for every model year. 2018-2024
inventory_type Optional Which market: used (the default), new, or certified pre-owned. used
months Optional The window in months, ending at the latest data month: 3 by default, 1 to 12. Each state is read from its latest month in the window with 30 or more priced sales; 12 adds the dispersion trend. 3

What comes back

Asking for it in a chat client

Rating-territory price dispersion for used SUVs by state

How dispersed are used F-150 prices across states?

Running it from a backend

Grant an agent the reports:rating-territory-dispersion-panel scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_rating_territory_dispersion",
    "arguments": {
      "body_type": "SUV",
      "inventory_type": "used",
      "months": 3
    }
  }
}

See Server-side access for the token exchange and how to read the response.