Agentic Dealer Network

Search network inventory

network_search

Read-onlyIdempotent

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 Schema

Name	Required	Description	Default
`make`	No
`sort`	No	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).
`trim`	No
`view`	No		summary
`limit`	No	1–500 with view manifest; 1–50 for summary and full (server-enforced)
`model`	No
`format`	No		json
`offset`	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.
`country`	No	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.	US
`latitude`	No
`condition`	No
`fuel_type`	No
`longitude`	No
`price_max`	No	Maximum expiry-gated effective price: an unexpired special price when present, otherwise asking price.
`price_min`	No	Minimum expiry-gated effective price: an unexpired special price when present, otherwise asking price.
`body_style`	No
`drivetrain`	No
`listed_only`	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.
`is_certified`	No
`odometer_max`	No
`radius_miles`	No
`rooftop_slug`	No	Restrict results to one rooftop, as listed by network_directory. A slug that matches no rooftop returns no results rather than an error.
`transmission`	No
`rooftop_slugs`	No	Restrict results to these network rooftops.
`exterior_color`	No
`interior_color`	No
`model_year_max`	No
`model_year_min`	No
`oem_program_slug`	No
`passenger_capacity_min`	No

Output Schema

Name	Required	Description
`data`	No
`error`	No	Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message "unknown thread_id" (anti-enumeration).
`freshness`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 10, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "data": {
+      "additionalProperties": false,
+      "properties": {
+        "catalog_version": {
+          "type": "string"
+        },
+        "catalog_watermark": {
+          "description": "Opaque revision token for the network catalog. Changes whenever an inventory ingestion is applied anywhere in the network; monotonic per catalog but carries NO timestamp semantics — compare for equality only. Null before the first ingest. Covers ingestion only: administrative reconfiguration (rooftop activation, exclusion rules, coordinates) can shift result rows without changing this token — most such events also change total, which the traversal recipe compares as well.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "count": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "csv": {
+          "type": "string"
+        },
+        "format": {
+          "enum": [
+            "json",
+            "csv"
+          ]
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "hint": {
+          "additionalProperties": false,
+          "properties": {
+            "arguments": {
+              "type": "object"
+            },
+            "reason": {
+              "enum": [
+                "page_cap",
+                "deep_offset"
+              ]
+            },
+            "tool": {
+              "enum": [
+                "inventory_stats",
+                "network_snapshot"
+              ]
+            }
+          },
+          "required": [
+            "tool",
+            "arguments",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "market": {
+          "additionalProperties": false,
+          "properties": {
+            "country": {
+              "enum": [
+                "US",
+                "CA"
+              ],
+              "type": "string"
+            },
+            "currency": {
+              "type": "string"
+            },
+            "odometer_unit": {
+              "enum": [
+                "mi",
+                "km"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "country",
+            "currency",
+            "odometer_unit"
+          ],
+          "type": "object"
+        },
+        "next_offset": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "total": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "units": {
+          "items": {
+            "anyOf": [
+              {
+                "allOf": [
+                  {
+                    "description": "The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get.",
+                    "not": {
+                      "anyOf": [
+                        {
+                          "required": [
+                            "photo_urls"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "options"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "description"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "date_in_stock"
+                          ]
+                        }
+                      ]
+                    },
+                    "properties": {
+                      "asking_price": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "body_style": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "carfax_one_owner": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      },
+                      "carfax_report_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "city_mpg": {
+                        "maximum": 999,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "condition": {
+                        "description": "Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.",
+                        "enum": [
+                          "new",
+                          "used"
+                        ]
+                      },
+                      "currency": {
+                        "maxLength": 3,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "description_snippet": {
+                        "maxLength": 200,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "doors": {
+                        "maximum": 10,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "drivetrain": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "effective_price": {
+                        "description": "An unexpired special price when present, otherwise asking price; null when neither is available.",
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "effective_price_source": {
+                        "description": "The field selected for effective_price, or null when effective_price is null.",
+                        "enum": [
+                          "special_price",
+                          "asking_price",
+                          null
+                        ]
+                      },
+                      "engine": {
+                        "maxLength": 120,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "engine_cylinders": {
+                        "maximum": 16,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "engine_displacement": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "exterior_color": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "fuel_type": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "hero_photo_url": {
+                        "maxLength": 300,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "highway_mpg": {
+                        "maximum": 999,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "identity": {
+                        "maxLength": 30,
+                        "minLength": 5,
+                        "type": "string"
+                      },
+                      "interior_color": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "is_certified": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      },
+                      "make": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "model": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "model_year": {
+                        "maximum": 2100,
+                        "minimum": 1950,
+                        "type": "integer"
+                      },
+                      "msrp": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "odometer": {
+                        "minimum": 0,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "odometer_unit": {
+                        "enum": [
+                          "mi",
+                          "km"
+                        ],
+                        "type": "string"
+                      },
+                      "options_count": {
+                        "maximum": 100,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "passenger_capacity": {
+                        "maximum": 20,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "photo_count": {
+                        "maximum": 60,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "price_basis": {
+                        "const": "dealer_published",
+                        "type": "string"
+                      },
+                      "provenance": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "enriched_fields": {
+                            "items": {
+                              "enum": [
+                                "photo_urls",
+                                "options",
+                                "description",
+                                "vdp_url",
+                                "video_url",
+                                "city_mpg",
+                                "highway_mpg",
+                                "doors",
+                                "passenger_capacity",
+                                "engine_cylinders",
+                                "engine_displacement",
+                                "carfax_one_owner",
+                                "carfax_report_url",
+                                "is_certified",
+                                "trim",
+                                "body_style",
+                                "transmission",
+                                "drivetrain",
+                                "asking_price"
+                              ]
+                            },
+                            "maxItems": 19,
+                            "type": "array",
+                            "uniqueItems": true
+                          },
+                          "merch_updated_at": {
+                            "format": "date-time",
+                            "maxLength": 40,
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "merch_updated_at",
+                          "enriched_fields"
+                        ],
+                        "type": "object"
+                      },
+                      "special_expiry": {
+                        "format": "date",
+                        "maxLength": 10,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "special_price": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "stock_number": {
+                        "maxLength": 40,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "transmission": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "trim": {
+                        "maxLength": 120,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "vdp_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "video_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "identity",
+                      "condition",
+                      "model_year",
+                      "make",
+                      "model",
+                      "hero_photo_url",
+                      "photo_count",
+                      "options_count",
+                      "description_snippet",
+                      "odometer_unit",
+                      "price_basis"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "distance_km": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "distance_miles": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "rooftop_name": {
+                        "maxLength": 200,
+                        "type": "string"
+                      },
+                      "rooftop_slug": {
+                        "maxLength": 80,
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "rooftop_slug",
+                      "rooftop_name"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "asking_price": {
+                    "minimum": 0,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "body_style": {
+                    "maxLength": 80,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "condition": {
+                    "enum": [
+                      "new",
+                      "used"
+                    ]
+                  },
+                  "currency": {
+                    "maxLength": 3,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "date_in_stock": {
+                    "format": "date",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "effective_price": {
+                    "minimum": 0,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "effective_price_source": {
+                    "enum": [
+                      "special_price",
+                      "asking_price",
+                      null
+                    ]
+                  },
+                  "identity": {
+                    "maxLength": 30,
+                    "minLength": 5,
+                    "type": "string"
+                  },
+                  "is_certified": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "make": {
+                    "maxLength": 80,
+                    "type": "string"
+                  },
+                  "model": {
+                    "maxLength": 80,
+                    "type": "string"
+                  },
+                  "model_year": {
+                    "maximum": 2100,
+                    "minimum": 1950,
+                    "type": "integer"
+                  },
+                  "msrp": {
+                    "minimum": 0,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "odometer": {
+                    "minimum": 0,
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
+                  },
+                  "odometer_unit": {
+                    "enum": [
+                      "mi",
+                      "km"
+                    ],
+                    "type": "string"
+                  },
+                  "price_basis": {
+                    "const": "dealer_published",
+                    "type": "string"
+                  },
+                  "rooftop_slug": {
+                    "maxLength": 80,
+                    "type": "string"
+                  },
+                  "special_expiry": {
+                    "format": "date",
+                    "maxLength": 10,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "special_price": {
+                    "minimum": 0,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "stock_number": {
+                    "maxLength": 40,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "trim": {
+                    "maxLength": 120,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "vdp_url": {
+                    "maxLength": 500,
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "rooftop_slug",
+                  "identity",
+                  "stock_number",
+                  "condition",
+                  "is_certified",
+                  "model_year",
+                  "make",
+                  "model",
+                  "trim",
+                  "currency",
+                  "asking_price",
+                  "special_price",
+                  "special_expiry",
+                  "effective_price",
+                  "effective_price_source",
+                  "msrp",
+                  "odometer",
+                  "odometer_unit",
+                  "body_style",
+                  "date_in_stock",
+                  "vdp_url",
+                  "price_basis"
+                ],
+                "type": "object"
+              },
+              {
+                "allOf": [
+                  {
+                    "description": "The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here.",
+                    "properties": {
+                      "asking_price": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "body_style": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "carfax_one_owner": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      },
+                      "carfax_report_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "city_mpg": {
+                        "maximum": 999,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "condition": {
+                        "description": "Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.",
+                        "enum": [
+                          "new",
+                          "used"
+                        ]
+                      },
+                      "currency": {
+                        "maxLength": 3,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "description": {
+                        "maxLength": 10000,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "doors": {
+                        "maximum": 10,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "drivetrain": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "effective_price": {
+                        "description": "An unexpired special price when present, otherwise asking price; null when neither is available.",
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "effective_price_source": {
+                        "description": "The field selected for effective_price, or null when effective_price is null.",
+                        "enum": [
+                          "special_price",
+                          "asking_price",
+                          null
+                        ]
+                      },
+                      "engine": {
+                        "maxLength": 120,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "engine_cylinders": {
+                        "maximum": 16,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "engine_displacement": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "exterior_color": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "fuel_type": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "highway_mpg": {
+                        "maximum": 999,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "identity": {
+                        "maxLength": 30,
+                        "minLength": 5,
+                        "type": "string"
+                      },
+                      "interior_color": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "is_certified": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      },
+                      "make": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "model": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "model_year": {
+                        "maximum": 2100,
+                        "minimum": 1950,
+                        "type": "integer"
+                      },
+                      "msrp": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "odometer": {
+                        "minimum": 0,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "odometer_unit": {
+                        "enum": [
+                          "mi",
+                          "km"
+                        ],
+                        "type": "string"
+                      },
+                      "options": {
+                        "items": {
+                          "maxLength": 100,
+                          "type": "string"
+                        },
+                        "maxItems": 100,
+                        "type": [
+                          "array",
+                          "null"
+                        ]
+                      },
+                      "passenger_capacity": {
+                        "maximum": 20,
+                        "minimum": 1,
+                        "type": [
+                          "integer",
+                          "null"
+                        ]
+                      },
+                      "photo_urls": {
+                        "items": {
+                          "maxLength": 300,
+                          "type": "string"
+                        },
+                        "maxItems": 60,
+                        "type": [
+                          "array",
+                          "null"
+                        ]
+                      },
+                      "price_basis": {
+                        "const": "dealer_published",
+                        "type": "string"
+                      },
+                      "provenance": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "enriched_fields": {
+                            "items": {
+                              "enum": [
+                                "photo_urls",
+                                "options",
+                                "description",
+                                "vdp_url",
+                                "video_url",
+                                "city_mpg",
+                                "highway_mpg",
+                                "doors",
+                                "passenger_capacity",
+                                "engine_cylinders",
+                                "engine_displacement",
+                                "carfax_one_owner",
+                                "carfax_report_url",
+                                "is_certified",
+                                "trim",
+                                "body_style",
+                                "transmission",
+                                "drivetrain",
+                                "asking_price"
+                              ]
+                            },
+                            "maxItems": 19,
+                            "type": "array",
+                            "uniqueItems": true
+                          },
+                          "merch_updated_at": {
+                            "format": "date-time",
+                            "maxLength": 40,
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "merch_updated_at",
+                          "enriched_fields"
+                        ],
+                        "type": "object"
+                      },
+                      "special_expiry": {
+                        "format": "date",
+                        "maxLength": 10,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "special_price": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "stock_number": {
+                        "maxLength": 40,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "transmission": {
+                        "maxLength": 80,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "trim": {
+                        "maxLength": 120,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "vdp_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "video_url": {
+                        "maxLength": 500,
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "identity",
+                      "condition",
+                      "model_year",
+                      "make",
+                      "model",
+                      "odometer_unit",
+                      "price_basis"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "distance_km": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "distance_miles": {
+                        "minimum": 0,
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "rooftop_name": {
+                        "maxLength": 200,
+                        "type": "string"
+                      },
+                      "rooftop_slug": {
+                        "maxLength": 80,
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "rooftop_slug",
+                      "rooftop_name"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              }
+            ]
+          },
+          "maxItems": 500,
+          "type": "array"
+        },
+        "view": {
+          "enum": [
+            "summary",
+            "manifest",
+            "full"
+          ]
+        }
+      },
+      "required": [
+        "total",
+        "count",
+        "units",
+        "catalog_watermark",
+        "has_more",
+        "catalog_version"
+      ],
+      "type": "object"
+    },
+    "error": {
+      "additionalProperties": false,
+      "description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
+      "properties": {
+        "auth_help_url": {
+          "description": "Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.",
+          "format": "uri",
+          "maxLength": 500,
+          "type": "string"
+        },
+        "code": {
+          "enum": [
+            "rooftop_not_found",
+            "rooftop_inactive",
+            "unit_not_found",
+            "invalid_params",
+            "rate_limited",
+            "upstream_unavailable",
+            "capability_unavailable",
+            "identity_required",
+            "quota_exceeded",
+            "unit_held",
+            "quote_expired",
+            "rooftop_paused",
+            "handoff_duplicate",
+            "idempotency_conflict",
+            "price_unavailable",
+            "snapshot_expired",
+            "artifact_too_large",
+            "cursor_invalid",
+            "cursor_expired",
+            "ambiguous_identity",
+            "unsupported_in_country"
+          ]
+        },
+        "message": {
+          "maxLength": 500,
+          "type": "string"
+        },
+        "retry_after_seconds": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "type": "object"
+    },
+    "freshness": {
+      "additionalProperties": false,
+      "properties": {
+        "by_rooftop": {
+          "additionalProperties": {
+            "additionalProperties": false,
+            "properties": {
+              "last_ingest_at": {
+                "format": "date-time",
+                "maxLength": 40,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "status": {
+                "enum": [
+                  "fresh",
+                  "stale",
+                  "no_data"
+                ]
+              }
+            },
+            "required": [
+              "status",
+              "last_ingest_at"
+            ],
+            "type": "object"
+          },
+          "maxProperties": 500,
+          "type": "object"
+        }
+      },
+      "required": [
+        "by_rooftop"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedOct 10, 2026

addedInput schema / properties / listed_only

Added value: +{
+  "description": "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.",
+  "type": "boolean"
+}

Changed1 schema field changedOct 8, 2026

addedInput schema / properties / rooftop_slugs

Added value: +{
+  "description": "Restrict results to these network rooftops.",
+  "items": {
+    "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
+    "type": "string"
+  },
+  "maxItems": 20,
+  "minItems": 1,
+  "type": "array",
+  "uniqueItems": true
+}

Changed1 schema field changedSep 18, 2026

addedInput schema / properties / country

Added value: +{
+  "default": "US",
+  "description": "Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.",
+  "enum": [
+    "US",
+    "CA"
+  ],
+  "type": "string"
+}

Changed7 schema fields changedSep 17, 2026

removedInput schema / allOf

Removed value: -[
-  {
-    "if": {
-      "properties": {
-        "sort": {
-          "const": "distance"
-        }
-      },
-      "required": [
-        "sort"
-      ]
-    },
-    "then": {
-      "required": [
-        "latitude",
-        "longitude"
-      ]
-    }
-  }
-]

removedInput schema / dependentRequired

Removed value: -{
-  "latitude": [
-    "longitude"
-  ],
-  "longitude": [
-    "latitude"
-  ],
-  "radius_miles": [
-    "latitude",
-    "longitude"
-  ]
-}

changedInput schema / description

Previous value: -"Categorical arrays are ORed within their field; separate filter fields are ANDed together. The default ordering is price_asc."New value: +"Categorical arrays are ORed within their field; separate filter fields are ANDed together. The default ordering is price_asc. Server-enforced: latitude requires longitude; longitude requires latitude; radius_miles requires latitude and longitude. sort = distance requires latitude and longitude. Additional argument rules are enforced server-side."

addedInput schema / properties / format

Added value: +{
+  "default": "json",
+  "enum": [
+    "json",
+    "csv"
+  ]
+}

addedInput schema / properties / limit / description

Added value: +"1–500 with view manifest; 1–50 for summary and full (server-enforced)"

changedInput schema / properties / limit / maximum
```
Previous value: -50New value: +500
```

addedInput schema / properties / view

Added value: +{
+  "default": "summary",
+  "enum": [
+    "summary",
+    "manifest",
+    "full"
+  ]
+}

Changed4 schema fields changedSep 16, 2026

changedInput schema / allOf

Previous value: -[
-  {
-    "if": {
-      "properties": {
-        "sort": {
-          "const": "distance"
-        }
-      },
-      "required": [
-        "sort"
-      ]
-    },
-    "then": {
-      "required": [
-        "latitude",
-        "longitude",
-        "radius_miles"
-      ]
-    }
-  }
-]New value: +[
+  {
+    "if": {
+      "properties": {
+        "sort": {
+          "const": "distance"
+        }
+      },
+      "required": [
+        "sort"
+      ]
+    },
+    "then": {
+      "required": [
+        "latitude",
+        "longitude"
+      ]
+    }
+  }
+]

changedInput schema / dependentRequired / latitude

Previous value: -[
-  "longitude",
-  "radius_miles"
-]New value: +[
+  "longitude"
+]

changedInput schema / dependentRequired / longitude

Previous value: -[
-  "latitude",
-  "radius_miles"
-]New value: +[
+  "latitude"
+]

changedInput schema / properties / sort / description

Previous value: -"Optional ordering; defaults to price_asc. The sort key uses NULLS LAST and is deterministically terminated by rooftop and unit ids. distance requires latitude, longitude, and radius_miles."New value: +"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)."

Changed22 schema fields changedAug 17, 2026

addedInput schema / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "sort": {
+          "const": "distance"
+        }
+      },
+      "required": [
+        "sort"
+      ]
+    },
+    "then": {
+      "required": [
+        "latitude",
+        "longitude",
+        "radius_miles"
+      ]
+    }
+  }
+]

addedInput schema / description

Added value: +"Categorical arrays are ORed within their field; separate filter fields are ANDed together. The default ordering is price_asc."

addedInput schema / properties / body_style

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

addedInput schema / properties / drivetrain

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

addedInput schema / properties / exterior_color

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

addedInput schema / properties / fuel_type

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

addedInput schema / properties / interior_color

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

removedInput schema / properties / make / maxLength
```
Removed value: -80
```
removedInput schema / properties / make / minLength
```
Removed value: -1
```

addedInput schema / properties / make / oneOf

Added value: +[
+  {
+    "maxLength": 80,
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "items": {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    "maxItems": 10,
+    "minItems": 1,
+    "type": "array"
+  }
+]

removedInput schema / properties / make / type
```
Removed value: -"string"
```
removedInput schema / properties / model / maxLength
```
Removed value: -80
```
removedInput schema / properties / model / minLength
```
Removed value: -1
```

addedInput schema / properties / model / oneOf

Added value: +[
+  {
+    "maxLength": 80,
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "items": {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    "maxItems": 10,
+    "minItems": 1,
+    "type": "array"
+  }
+]

removedInput schema / properties / model / type
```
Removed value: -"string"
```

addedInput schema / properties / odometer_max

Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / passenger_capacity_min

Added value: +{
+  "maximum": 20,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / price_max / description

Added value: +"Maximum expiry-gated effective price: an unexpired special price when present, otherwise asking price."

addedInput schema / properties / price_min / description

Added value: +"Minimum expiry-gated effective price: an unexpired special price when present, otherwise asking price."

addedInput schema / properties / sort

Added value: +{
+  "description": "Optional ordering; defaults to price_asc. The sort key uses NULLS LAST and is deterministically terminated by rooftop and unit ids. distance requires latitude, longitude, and radius_miles.",
+  "enum": [
+    "price_asc",
+    "price_desc",
+    "year_desc",
+    "mileage_asc",
+    "distance"
+  ]
+}

addedInput schema / properties / transmission

Added value: +{
+  "oneOf": [
+    {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "items": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 1,
+      "type": "array"
+    }
+  ]
+}

addedInput schema / properties / trim

Added value: +{
+  "maxLength": 120,
+  "minLength": 1,
+  "type": "string"
+}

First observedAug 10, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/openWorld/idempotent/non-destructive, so the safety profile is covered. The description adds genuine behavioral context beyond that: rooftops without coordinates are silently excluded from geo-scoped results, listed prices may omit doc/government fees and tax, and totals must be qualified when pricing_coverage is partial_estimate. It does not itself disclose the pagination non-isolation risk (that lives in the offset schema), which keeps it short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first sentence, followed by sibling routing and then caveats. Dense but every sentence carries payload; the only mild cost is that multiple concerns (routing, presentation, pricing, geo) are packed into one block.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return shape needn't be explained. Given the complexity (30 params, geo scoping, pagination), the description covers the operationally risky areas (geo exclusions, price disclosure, coverage flags) well, though it omits the pagination stability caveat and some filter semantics that live only in the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 30 parameters and only 30% schema description coverage, the schema does most of the work but many fields (make/model/trim/color enums, price gates) are undocumented anywhere. The description compensates for the trickiest ones — geo scope (lat+lon together, radius_miles default 50/max 500), oem_program_slug, and country=CA — but leaves the bulk of the filter surface unaddressed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Browse available inventory across the network') and immediately distinguishes itself from siblings by naming inventory_stats, network_snapshot, and inventory_get with the conditions that select each. An agent can pick this tool without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit routing: counts/distributions → inventory_stats; catalog copy → network_snapshot; photo gallery → inventory_get with rooftop_slug; estimated total → quote_preview. Both when-to-use and when-not-to-use are stated, leaving nothing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Agentic Dealer Network tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?