network_search
Surface: network
Endpoint: https://gateway.agenticdealernetwork.com/mcp
Access: No credential required
Browse available inventory across the network, one page at a time. For counts or distributions call inventory_stats; to copy the catalog call network_snapshot (one download replaces hundreds of pages). Results are slim summary rows; embed hero_photo_url as a markdown image when presenting a vehicle, and call inventory_get with rooftop_slug for its full photo gallery. Optional OEM program scope; optional geographic radius — latitude and longitude together; radius_miles defaults to 50 (max 500) and needs both. Rooftops without coordinates are excluded from geo-scoped results. Pass country=CA for Canadian dealers. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.
Input
Categorical arrays are ORed within their field; separate filter fields are ANDed together. The default ordering is price_asc.
| 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: an unexpired special price when present, otherwise asking price. |
price_max | number | no | Maximum expiry-gated effective price: an unexpired special price when present, otherwise asking 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 | |
rooftop_slug | string | no | Restrict results to one rooftop, as listed by network_directory. A slug that matches no rooftop returns no results rather than an error. |
rooftop_slugs | array | no | Restrict results to these network rooftops. |
latitude | number | no | |
longitude | number | no | |
radius_miles | number | no | |
sort | string | no | Enum: "price_asc", "price_desc", "year_desc", "mileage_asc", "distance". Optional ordering; defaults to price_asc. The sort key uses NULLS LAST and is deterministically terminated by rooftop and unit ids. distance requires latitude and longitude (radius_miles defaults to 50). |
view | string | no | Enum: "summary", "manifest", "full". |
format | string | no | Enum: "json", "csv". |
limit | integer | no | 1–500 with view manifest; 1–50 for summary and full (server-enforced) |
offset | integer | no | Zero-based row offset. Results are totally ordered and stable for an unchanged catalog, but pagination is NOT snapshot-isolated: ingestion between two page requests shifts offsets, so a traversal may duplicate or omit rows. To copy the catalog consistently: record catalog_watermark AND total from the first page, compare both on every subsequent page, and restart the traversal if either changes. Narrowing by rooftop_slug shortens each traversal and so reduces the chance of a restart. Offsets beyond 10000 are rejected; narrow the query instead. |
Output
Top-level properties: total, count, catalog_watermark, catalog_version, has_more, next_offset, view, format, market, csv, hint, units
Availability
Availability: every rooftop.