Agentic Dealer Network

Sync catalog changes

inventory_changes

Read-onlyIdempotent

State synchronization for a mirror built from network_snapshot: pass the sync_cursor and receive upserts (current rows in the same view) and tombstones since that position, with has_more and next_cursor. Bounded eventual consistency: take a fresh snapshot at least every 24 hours and whenever resync_required is true. Example: {"cursor": "<sync_cursor from network_snapshot>"}. Pass country=CA for Canadian dealers.

Input Schema

Name	Required	Description	Default
`view`	No
`cursor`	Yes
`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
`rooftop_slug`	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"
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "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_cursor": {
+          "maxLength": 2048,
+          "minLength": 8,
+          "type": "string"
+        },
+        "resync_required": {
+          "type": "boolean"
+        },
+        "round_upper": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "rows_emitted": {
+          "maximum": 500,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "rows_scanned": {
+          "maximum": 5000,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "scope": {
+          "anyOf": [
+            {
+              "pattern": "^network:(?:US|CA)$",
+              "type": "string"
+            },
+            {
+              "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
+              "type": "string"
+            }
+          ]
+        },
+        "tombstones": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "changed_at": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "identity": {
+                "maxLength": 30,
+                "minLength": 5,
+                "type": "string"
+              },
+              "rooftop_slug": {
+                "maxLength": 80,
+                "type": "string"
+              }
+            },
+            "required": [
+              "rooftop_slug",
+              "identity",
+              "changed_at"
+            ],
+            "type": "object"
+          },
+          "maxItems": 500,
+          "type": "array"
+        },
+        "upserts": {
+          "items": {
+            "anyOf": [
+              {
+                "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 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"
+                  }
+                ]
+              },
+              {
+                "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": [
+            "manifest",
+            "summary",
+            "full"
+          ]
+        }
+      },
+      "required": [
+        "scope",
+        "view",
+        "upserts",
+        "tombstones",
+        "has_more",
+        "next_cursor",
+        "catalog_version",
+        "resync_required",
+        "round_upper",
+        "rows_scanned",
+        "rows_emitted"
+      ],
+      "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"
+}

Changed2 schema fields 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"
+}

addedInput schema / properties / rooftop_slug

Added value: +{
+  "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
+  "type": "string"
+}

AddedSep 17, 2026

TDQS

A4.3/5.0

Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive behavior, and the description adds substantial context beyond them: the bounded eventual-consistency contract, the 24-hour resync obligation, and the fact that the stream mixes upserts with tombstones. This is exactly the operational context an agent needs to avoid stale reads.

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?

Front-loaded with the core contract, then consistency rules, then a concrete call example. Dense but every sentence carries information; the example is justified by the opaque cursor value, though the 24-hour rule and example could be tightened.

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, yet the description still usefully names the return shape (upserts, tombstones, has_more, next_cursor) plus the sync discipline, so an agent can drive the loop correctly. The main gap is the unexplained view parameter, which affects how much data each call returns.

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?

Schema coverage is only 25%, so the description must compensate; it explains cursor (its origin in network_snapshot) and country (CA for Canadian dealers, with the schema carrying the fuller enum semantics). It says nothing about the view enum (manifest/summary/full) or rooftop_slug, leaving two parameters undocumented in both places.

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 — state synchronization for a mirror built from network_snapshot — and explicitly frames itself as the incremental counterpart to a full snapshot. An agent can distinguish it from network_snapshot without opening either schema.

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

Usage Guidelines4/5

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

Tells the agent to pass the sync_cursor obtained from network_snapshot, and prescribes taking a fresh snapshot at least every 24 hours and whenever resync_required is true. That gives clear when-to-use context and effectively routes full refreshes to the sibling, though it never names the fallback tool explicitly.

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?