inventory_stats
Surface: network
Endpoint: https://gateway.agenticdealernetwork.com/mcp
Access: No credential required
Aggregate available inventory across the network in ONE call: counts, effective-price min/median/max and the top values per facet. Example: {"dimensions": ["make_model", "body_style"], "condition": "used", "rooftop_slugs": ["mms"]}. Geo (latitude and longitude, optional radius_miles) and oem_program_slug scope exactly as network_search. Pivot mode (group_by, up to 2 of the facets plus state, dealer_group, price_band, age_band) returns one row per group with count and medians; dimensions and group_by are mutually exclusive; format csv returns the rows as CSV. Pass country=CA for Canadian dealers.
Input
Categorical arrays are ORed within their field; separate filter fields are ANDed together. Aggregation has no pagination or sorting input.
| Name | Type | Required | Enum / description |
|---|---|---|---|
country | string | no | Enum: "US", "CA". Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles. |
condition | string | no | Enum: "new", "used". |
make | string or array | no | |
model | string or array | no | |
body_style | string or array | no | |
fuel_type | string or array | no | |
drivetrain | string or array | no | |
exterior_color | string or array | no | |
interior_color | string or array | no | |
transmission | string or array | no | |
trim | string | no | |
model_year_min | integer | no | |
model_year_max | integer | no | |
price_min | number | no | Minimum expiry-gated effective price. |
price_max | number | no | Maximum expiry-gated effective price. |
odometer_max | integer | no | |
passenger_capacity_min | integer | no | |
is_certified | boolean | no | |
listed_only | boolean | no | When true, only units with at least one stored photo and a vehicle detail page (vdp_url). Absent or false returns every available unit, including stock the dealer has not merchandised yet. |
oem_program_slug | string | no | |
latitude | number | no | |
longitude | number | no | |
radius_miles | number | no | |
dimensions | array | no | Enum: "make", "model", "make_model", "condition", "body_style", "fuel_type", "drivetrain", "exterior_color", "model_year", "rooftop". One to four unique facets. make_model values join nonblank make and model with one space; rooftop values are rooftop slugs. |
group_by | array | no | Enum: "make", "model", "make_model", "condition", "body_style", "fuel_type", "drivetrain", "exterior_color", "model_year", "rooftop", "state", "dealer_group", "price_band", "age_band". |
format | string | no | Enum: "json", "csv". |
rooftop_slugs | array | no | Restrict the single-snapshot aggregation to these network rooftops. |
exactly one of: dimensions, group_by
Output
one of 3 shapes
- Required: total, dimensions, price, catalog_watermark
- Required: total, pivot, price, catalog_watermark, catalog_version
- Required: csv, rows, total, price, catalog_watermark, catalog_version
Availability
Availability: every rooftop.