Agentic Dealer Network MCP
Provides AI agents with access to live franchised-dealer automotive inventory, stateless quotes, and consented salesperson handoffs via the Model Context Protocol. It supports anonymous public reads for searching and quoting, while requiring an agent key for managing durable deal threads and lead submissions.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://gateway.agenticdealernetwork.com/mcpWhat its tools do
12 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (10)
Can change data (2)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to agenticdealernetwork.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search franchised-dealer vehicle inventory
- Retrieve stateless vehicle quotes
- Submit consented leads to dealerships
- Manage durable deal threads and holds
Source and maintenance
Vendor evidenceRegistry 0.5.0
Protocol and capabilities
- Server
- com.agenticdealernetwork/adn-gateway 0.5.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 12 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
12 advertised
network_directory — List dealerships
Advertised read-onlyOpen-world
Directory of active ADN rooftops: slug, name, dealer group, OEM programs, location metadata, and per-rooftop manifest URL. Pass country=CA for Canadian dealers.
network_directory input schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
}
},
"additionalProperties": false
}network_directory output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"rooftops",
"total"
],
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"rooftops": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"slug",
"country",
"dealer_group",
"oem_programs",
"available_units",
"new_units",
"used_units",
"top_makes",
"priced_count",
"price_median",
"freshness"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"name": {
"type": "string",
"maxLength": 200
},
"slug": {
"type": "string",
"maxLength": 80
},
"hours": {
"type": "object"
},
"phone": {
"type": "string",
"maxLength": 30
},
"state": {
"type": "string",
"maxLength": 50
},
"address": {
"type": "string",
"maxLength": 200
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"freshness": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"new_units": {
"type": [
"integer",
"null"
],
"minimum": 0,
"description": "null when the rooftop is not part of network aggregation (network opt-out)"
},
"top_makes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 3
},
"used_units": {
"type": [
"integer",
"null"
],
"minimum": 0,
"description": "null when the rooftop is not part of network aggregation (network opt-out)"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"website_url": {
"type": "string",
"maxLength": 300
},
"dealer_group": {
"type": "object",
"required": [
"name",
"slug"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"slug": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
},
"manifest_url": {
"type": "string",
"maxLength": 300
},
"oem_programs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 20
},
"price_median": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "null when the rooftop is not part of network aggregation (network opt-out)"
},
"priced_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"description": "null when the rooftop is not part of network aggregation (network opt-out)"
},
"available_units": {
"type": [
"integer",
"null"
],
"minimum": 0,
"description": "null when the rooftop is not part of network aggregation (network opt-out)"
}
},
"additionalProperties": false
},
"maxItems": 500
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}network_directory annotations
{
"title": "List dealerships",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}network_search — Search network inventory
Advertised read-onlyOpen-world
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.
network_search input schema
{
"type": "object",
"properties": {
"make": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"sort": {
"enum": [
"price_asc",
"price_desc",
"year_desc",
"mileage_asc",
"distance"
],
"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 and longitude (radius_miles defaults to 50)."
},
"trim": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"view": {
"enum": [
"summary",
"manifest",
"full"
],
"default": "summary"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "1–500 with view manifest; 1–50 for summary and full (server-enforced)"
},
"model": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"format": {
"enum": [
"json",
"csv"
],
"default": "json"
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "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": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"condition": {
"enum": [
"new",
"used"
]
},
"fuel_type": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"price_max": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "Maximum expiry-gated effective price: an unexpired special price when present, otherwise asking price."
},
"price_min": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "Minimum expiry-gated effective price: an unexpired special price when present, otherwise asking price."
},
"body_style": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"drivetrain": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"listed_only": {
"type": "boolean",
"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."
},
"is_certified": {
"type": "boolean"
},
"odometer_max": {
"type": "integer",
"minimum": 0
},
"radius_miles": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"rooftop_slug": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
"description": "Restrict results to one rooftop, as listed by network_directory. A slug that matches no rooftop returns no results rather than an error."
},
"transmission": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"rooftop_slugs": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
},
"maxItems": 20,
"minItems": 1,
"description": "Restrict results to these network rooftops.",
"uniqueItems": true
},
"exterior_color": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"interior_color": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"model_year_max": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"model_year_min": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"oem_program_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"passenger_capacity_min": {
"type": "integer",
"maximum": 20,
"minimum": 1
}
},
"description": "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.",
"additionalProperties": false
}network_search output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"total",
"count",
"units",
"catalog_watermark",
"has_more",
"catalog_version"
],
"properties": {
"csv": {
"type": "string"
},
"hint": {
"type": "object",
"required": [
"tool",
"arguments",
"reason"
],
"properties": {
"tool": {
"enum": [
"inventory_stats",
"network_snapshot"
]
},
"reason": {
"enum": [
"page_cap",
"deep_offset"
]
},
"arguments": {
"type": "object"
}
},
"additionalProperties": false
},
"view": {
"enum": [
"summary",
"manifest",
"full"
]
},
"count": {
"type": "integer",
"minimum": 0
},
"total": {
"type": "integer",
"minimum": 0
},
"units": {
"type": "array",
"items": {
"anyOf": [
{
"allOf": [
{
"not": {
"anyOf": [
{
"required": [
"photo_urls"
]
},
{
"required": [
"options"
]
},
{
"required": [
"description"
]
},
{
"required": [
"date_in_stock"
]
}
]
},
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"hero_photo_url",
"photo_count",
"options_count",
"description_snippet",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"photo_count": {
"type": "integer",
"maximum": 60,
"minimum": 0
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"options_count": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"hero_photo_url": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"description_snippet": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get."
},
{
"type": "object",
"required": [
"rooftop_slug",
"rooftop_name"
],
"properties": {
"distance_km": {
"type": [
"number",
"null"
],
"minimum": 0
},
"rooftop_name": {
"type": "string",
"maxLength": 200
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"distance_miles": {
"type": [
"number",
"null"
],
"minimum": 0
}
}
}
]
},
{
"type": "object",
"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"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"model": {
"type": "string",
"maxLength": 80
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
]
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"date_in_stock": {
"type": [
"string",
"null"
],
"format": "date"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
]
}
},
"additionalProperties": false
},
{
"allOf": [
{
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"options": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 100
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"photo_urls": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 60
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 10000
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here."
},
{
"type": "object",
"required": [
"rooftop_slug",
"rooftop_name"
],
"properties": {
"distance_km": {
"type": [
"number",
"null"
],
"minimum": 0
},
"rooftop_name": {
"type": "string",
"maxLength": 200
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"distance_miles": {
"type": [
"number",
"null"
],
"minimum": 0
}
}
}
]
}
]
},
"maxItems": 500
},
"format": {
"enum": [
"json",
"csv"
]
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": "integer",
"minimum": 0
},
"catalog_version": {
"type": "string"
},
"catalog_watermark": {
"type": [
"string",
"null"
],
"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."
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}network_search annotations
{
"title": "Search network inventory",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inventory_stats — Count and summarize network inventory
Advertised read-onlyOpen-world
Aggregate available inventory across the network in ONE call: counts, effective-price min/median/max and the top values per facet. Example: {"dimensions": ["make_model", "body_style"], "condition": "used", "rooftop_slugs": ["mms"]}. Geo (latitude and longitude, optional radius_miles) and oem_program_slug scope exactly as network_search. Pivot mode (group_by, up to 2 of the facets plus state, dealer_group, price_band, age_band) returns one row per group with count and medians; dimensions and group_by are mutually exclusive; format csv returns the rows as CSV. Pass country=CA for Canadian dealers.
inventory_stats input schema
{
"type": "object",
"properties": {
"make": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"trim": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"format": {
"enum": [
"json",
"csv"
]
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
},
"group_by": {
"type": "array",
"items": {
"enum": [
"make",
"model",
"make_model",
"condition",
"body_style",
"fuel_type",
"drivetrain",
"exterior_color",
"model_year",
"rooftop",
"state",
"dealer_group",
"price_band",
"age_band"
]
},
"maxItems": 2,
"minItems": 1,
"uniqueItems": true
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"condition": {
"enum": [
"new",
"used"
]
},
"fuel_type": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"price_max": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "Maximum expiry-gated effective price."
},
"price_min": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "Minimum expiry-gated effective price."
},
"body_style": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"dimensions": {
"type": "array",
"items": {
"enum": [
"make",
"model",
"make_model",
"condition",
"body_style",
"fuel_type",
"drivetrain",
"exterior_color",
"model_year",
"rooftop"
]
},
"maxItems": 4,
"minItems": 1,
"description": "One to four unique facets. make_model values join nonblank make and model with one space; rooftop values are rooftop slugs.",
"uniqueItems": true
},
"drivetrain": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"listed_only": {
"type": "boolean",
"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."
},
"is_certified": {
"type": "boolean"
},
"odometer_max": {
"type": "integer",
"minimum": 0
},
"radius_miles": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"transmission": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"rooftop_slugs": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
},
"maxItems": 20,
"minItems": 1,
"description": "Restrict the single-snapshot aggregation to these network rooftops.",
"uniqueItems": true
},
"exterior_color": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"interior_color": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
]
},
"model_year_max": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"model_year_min": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"oem_program_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"passenger_capacity_min": {
"type": "integer",
"maximum": 20,
"minimum": 1
}
},
"description": "Categorical arrays are ORed within their field; separate filter fields are ANDed together. Aggregation has no pagination or sorting input. Server-enforced: latitude requires longitude; longitude requires latitude; radius_miles requires latitude and longitude. Exactly one of dimensions | group_by is required. Additional argument rules are enforced server-side.",
"additionalProperties": false
}inventory_stats output schema
{
"type": "object",
"properties": {
"data": {
"oneOf": [
{
"type": "object",
"required": [
"total",
"dimensions",
"price",
"catalog_watermark"
],
"properties": {
"price": {
"type": "object",
"required": [
"currency",
"priced_count",
"min",
"max",
"median"
],
"properties": {
"max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"currency": {
"type": "string"
},
"priced_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": 0
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"dimensions": {
"type": "object",
"properties": {
"make": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"model": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"rooftop": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"condition": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"fuel_type": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"body_style": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"drivetrain": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"make_model": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"model_year": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
},
"exterior_color": {
"type": "object",
"required": [
"values",
"other_count",
"missing_count"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"other_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
}
},
"description": "values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.",
"additionalProperties": false
}
},
"description": "Contains one property for each requested dimension.",
"additionalProperties": false
},
"catalog_watermark": {
"type": [
"string",
"null"
]
},
"rooftop_slugs_covered": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"total",
"pivot",
"price",
"catalog_watermark",
"catalog_version"
],
"properties": {
"pivot": {
"type": "object",
"required": [
"group_by",
"rows",
"other",
"missing"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"priced_count",
"price_min",
"price_median",
"price_max",
"odometer_median",
"days_in_stock_median"
],
"properties": {
"make": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0
},
"model": {
"type": "string"
},
"state": {
"type": "string"
},
"rooftop": {
"type": "string"
},
"age_band": {
"type": "string"
},
"condition": {
"type": "string"
},
"fuel_type": {
"type": "string"
},
"price_max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"price_min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"body_style": {
"type": "string"
},
"drivetrain": {
"type": "string"
},
"make_model": {
"type": "string"
},
"model_year": {
"type": "string"
},
"price_band": {
"type": "string"
},
"dealer_group": {
"type": "string"
},
"price_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"priced_count": {
"type": "integer",
"minimum": 0
},
"exterior_color": {
"type": "string"
},
"odometer_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"dealer_group_name": {
"type": [
"string",
"null"
]
},
"days_in_stock_median": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 200
},
"other": {
"oneOf": [
{
"type": "object",
"required": [
"count",
"priced_count",
"price_min",
"price_median",
"price_max",
"odometer_median",
"days_in_stock_median"
],
"properties": {
"make": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0
},
"model": {
"type": "string"
},
"state": {
"type": "string"
},
"rooftop": {
"type": "string"
},
"age_band": {
"type": "string"
},
"condition": {
"type": "string"
},
"fuel_type": {
"type": "string"
},
"price_max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"price_min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"body_style": {
"type": "string"
},
"drivetrain": {
"type": "string"
},
"make_model": {
"type": "string"
},
"model_year": {
"type": "string"
},
"price_band": {
"type": "string"
},
"dealer_group": {
"type": "string"
},
"price_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"priced_count": {
"type": "integer",
"minimum": 0
},
"exterior_color": {
"type": "string"
},
"odometer_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"dealer_group_name": {
"type": [
"string",
"null"
]
},
"days_in_stock_median": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"missing": {
"type": "object",
"properties": {
"make": {
"type": "integer"
},
"model": {
"type": "integer"
},
"state": {
"type": "integer"
},
"rooftop": {
"type": "integer"
},
"age_band": {
"type": "integer"
},
"condition": {
"type": "integer"
},
"fuel_type": {
"type": "integer"
},
"body_style": {
"type": "integer"
},
"drivetrain": {
"type": "integer"
},
"make_model": {
"type": "integer"
},
"model_year": {
"type": "integer"
},
"price_band": {
"type": "integer"
},
"dealer_group": {
"type": "integer"
},
"exterior_color": {
"type": "integer"
}
},
"additionalProperties": false
},
"group_by": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
"price": {
"type": "object",
"required": [
"currency",
"priced_count",
"min",
"max",
"median"
],
"properties": {
"max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"currency": {
"type": "string"
},
"priced_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": 0
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"catalog_version": {
"type": "string"
},
"catalog_watermark": {
"type": [
"string",
"null"
]
},
"rooftop_slugs_covered": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"csv",
"rows",
"total",
"price",
"catalog_watermark",
"catalog_version"
],
"properties": {
"csv": {
"type": "string"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"priced_count",
"price_min",
"price_median",
"price_max",
"odometer_median",
"days_in_stock_median"
],
"properties": {
"make": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0
},
"model": {
"type": "string"
},
"state": {
"type": "string"
},
"rooftop": {
"type": "string"
},
"age_band": {
"type": "string"
},
"condition": {
"type": "string"
},
"fuel_type": {
"type": "string"
},
"price_max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"price_min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"body_style": {
"type": "string"
},
"drivetrain": {
"type": "string"
},
"make_model": {
"type": "string"
},
"model_year": {
"type": "string"
},
"price_band": {
"type": "string"
},
"dealer_group": {
"type": "string"
},
"price_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"priced_count": {
"type": "integer",
"minimum": 0
},
"exterior_color": {
"type": "string"
},
"odometer_median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"dealer_group_name": {
"type": [
"string",
"null"
]
},
"days_in_stock_median": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 201
},
"price": {
"type": "object",
"required": [
"currency",
"priced_count",
"min",
"max",
"median"
],
"properties": {
"max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"median": {
"type": [
"number",
"null"
],
"minimum": 0
},
"currency": {
"type": "string"
},
"priced_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": 0
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"catalog_version": {
"type": "string"
},
"catalog_watermark": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
]
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}inventory_stats annotations
{
"title": "Count and summarize network inventory",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inventory_get — Get vehicle details
Advertised read-onlyOpen-world
Fetch one available unit by identity (VIN) from a named rooftop (rooftop_slug from network_search results). Returns the full detail shape — ordered photo gallery, options, plain-text description; embed the first few photo_urls as markdown images when presenting the vehicle. Unknown or ineligible identity/rooftop returns unit_not_found. 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.
inventory_get input schema
{
"type": "object",
"required": [
"identity",
"rooftop_slug"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"description": "Optional consistency assertion: must equal the rooftop's country; omit it unless you are checking."
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}inventory_get output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"unit"
],
"properties": {
"unit": {
"allOf": [
{
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"options": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 100
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"photo_urls": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 60
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 10000
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here."
},
{
"not": {
"required": [
"date_in_stock"
]
}
}
]
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}inventory_get annotations
{
"title": "Get vehicle details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}network_snapshot — Export the catalog
Advertised read-onlyOpen-world
Export the whole network catalog (or one rooftop with rooftop_slug) as one gzip artifact instead of paging: returns a descriptor with a generation URL, strong ETag, row and byte counts, expiry and (when available) sync_cursor; small results are inlined as rows_inline. Views: manifest (identity, pricing, key attributes; default), summary (the network_search row), full (the inventory_get row). Formats: csv (default), json. Example: {"view": "manifest", "format": "csv"}. Re-download only when the ETag changes; poll inventory_changes with sync_cursor to stay current. Pass country=CA for Canadian dealers.
network_snapshot input schema
{
"type": "object",
"properties": {
"view": {
"enum": [
"manifest",
"summary",
"full"
],
"default": "manifest"
},
"format": {
"enum": [
"csv",
"json"
],
"default": "csv"
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
},
"rooftop_slug": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
}
},
"additionalProperties": false
}network_snapshot output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"snapshot_id",
"schema_version",
"scope",
"view",
"format",
"generated_at",
"as_of_business_date",
"rows",
"bytes",
"bytes_compressed",
"etag",
"url",
"expires_at",
"catalog_version"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"etag": {
"type": "string"
},
"rows": {
"type": "integer",
"minimum": 0
},
"view": {
"enum": [
"manifest",
"summary",
"full"
]
},
"bytes": {
"type": "integer",
"minimum": 0
},
"scope": {
"anyOf": [
{
"type": "string",
"pattern": "^network:(?:US|CA)$"
},
{
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
}
]
},
"format": {
"enum": [
"csv",
"json"
]
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"rows_inline": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshot_id": {
"type": "string",
"pattern": "^[0-9a-f]{24}$"
},
"sync_cursor": {
"type": "string"
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"schema_version": {
"const": 1
},
"catalog_version": {
"type": "string"
},
"bytes_compressed": {
"type": "integer",
"minimum": 0
},
"as_of_business_date": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}network_snapshot annotations
{
"title": "Export the catalog",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inventory_changes — Sync catalog changes
Advertised read-onlyOpen-world
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.
inventory_changes input schema
{
"type": "object",
"required": [
"cursor"
],
"properties": {
"view": {
"enum": [
"manifest",
"summary",
"full"
]
},
"cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 8
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
},
"rooftop_slug": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
}
},
"additionalProperties": false
}inventory_changes output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"scope",
"view",
"upserts",
"tombstones",
"has_more",
"next_cursor",
"catalog_version",
"resync_required",
"round_upper",
"rows_scanned",
"rows_emitted"
],
"properties": {
"view": {
"enum": [
"manifest",
"summary",
"full"
]
},
"scope": {
"anyOf": [
{
"type": "string",
"pattern": "^network:(?:US|CA)$"
},
{
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
}
]
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"upserts": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"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"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"model": {
"type": "string",
"maxLength": 80
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
]
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"date_in_stock": {
"type": [
"string",
"null"
],
"format": "date"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
]
}
},
"additionalProperties": false
},
{
"allOf": [
{
"not": {
"anyOf": [
{
"required": [
"photo_urls"
]
},
{
"required": [
"options"
]
},
{
"required": [
"description"
]
},
{
"required": [
"date_in_stock"
]
}
]
},
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"hero_photo_url",
"photo_count",
"options_count",
"description_snippet",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"photo_count": {
"type": "integer",
"maximum": 60,
"minimum": 0
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"options_count": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"hero_photo_url": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"description_snippet": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get."
},
{
"type": "object",
"required": [
"rooftop_slug",
"rooftop_name"
],
"properties": {
"distance_km": {
"type": [
"number",
"null"
],
"minimum": 0
},
"rooftop_name": {
"type": "string",
"maxLength": 200
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"distance_miles": {
"type": [
"number",
"null"
],
"minimum": 0
}
}
}
]
},
{
"allOf": [
{
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"options": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 100
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"photo_urls": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 60
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 10000
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here."
},
{
"type": "object",
"required": [
"rooftop_slug",
"rooftop_name"
],
"properties": {
"distance_km": {
"type": [
"number",
"null"
],
"minimum": 0
},
"rooftop_name": {
"type": "string",
"maxLength": 200
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"distance_miles": {
"type": [
"number",
"null"
],
"minimum": 0
}
}
}
]
}
]
},
"maxItems": 500
},
"has_more": {
"type": "boolean"
},
"tombstones": {
"type": "array",
"items": {
"type": "object",
"required": [
"rooftop_slug",
"identity",
"changed_at"
],
"properties": {
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"changed_at": {
"type": "string",
"format": "date-time"
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
},
"maxItems": 500
},
"next_cursor": {
"type": "string",
"maxLength": 2048,
"minLength": 8
},
"round_upper": {
"type": "string",
"format": "date-time"
},
"rows_emitted": {
"type": "integer",
"maximum": 500,
"minimum": 0
},
"rows_scanned": {
"type": "integer",
"maximum": 5000,
"minimum": 0
},
"catalog_version": {
"type": "string"
},
"resync_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}inventory_changes annotations
{
"title": "Sync catalog changes",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inventory_comparables — Compare a vehicle's price to like units
Advertised read-onlyOpen-world
Price context for one vehicle against like units across the network (same make, model, exact model year, condition; optional trim and geo). Example: {"identity": "<VIN>", "rooftop_slug": "mms"} or {"make": "Subaru", "model": "Outback", "model_year": 2024, "condition": "used"}. Returns count, price quartiles, the subject's rank and up to 5 cheapest peers. Advertised prices only; call quote_preview for a total. Pass country=CA for Canadian dealers.
inventory_comparables input schema
{
"type": "object",
"properties": {
"make": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"trim": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string",
"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."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"identity": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"condition": {
"enum": [
"new",
"used"
]
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"radius_miles": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"rooftop_slug": {
"type": "string",
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
},
"model_year_expand": {
"enum": [
0,
1
],
"type": "integer",
"default": 0
}
},
"description": "Server-enforced: latitude requires longitude; longitude requires latitude; radius_miles requires latitude and longitude. Exactly one of identity | make+model+model_year is required. Additional argument rules are enforced server-side.",
"additionalProperties": false
}inventory_comparables output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"filters_applied",
"count",
"priced_count",
"price",
"subject",
"cheapest",
"low_sample",
"disclosure",
"catalog_version"
],
"properties": {
"count": {
"type": "integer",
"minimum": 0
},
"price": {
"type": "object",
"required": [
"min",
"p25",
"median",
"p75",
"max"
],
"properties": {
"max": {
"type": [
"number",
"null"
],
"minimum": 0
},
"min": {
"type": [
"number",
"null"
],
"minimum": 0
},
"p25": {
"type": [
"number",
"null"
],
"minimum": 0
},
"p75": {
"type": [
"number",
"null"
],
"minimum": 0
},
"median": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
"market": {
"type": "object",
"required": [
"country",
"currency",
"odometer_unit"
],
"properties": {
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"currency": {
"type": "string"
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
}
},
"additionalProperties": false
},
"subject": {
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"identity",
"rooftop_slug",
"price",
"rank",
"ties"
],
"properties": {
"rank": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"ties": {
"type": "integer",
"minimum": 0
},
"price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"identity": {
"type": "string"
},
"rooftop_slug": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"cheapest": {
"type": "array",
"items": {
"allOf": [
{
"not": {
"anyOf": [
{
"required": [
"photo_urls"
]
},
{
"required": [
"options"
]
},
{
"required": [
"description"
]
},
{
"required": [
"date_in_stock"
]
}
]
},
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model",
"hero_photo_url",
"photo_count",
"options_count",
"description_snippet",
"odometer_unit",
"price_basis"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"msrp": {
"type": [
"number",
"null"
],
"minimum": 0
},
"trim": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"doors": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"model": {
"type": "string",
"maxLength": 80
},
"engine": {
"type": [
"string",
"null"
],
"maxLength": 120
},
"vdp_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"city_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"currency": {
"type": [
"string",
"null"
],
"maxLength": 3
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"odometer": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"condition": {
"enum": [
"new",
"used"
],
"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."
},
"fuel_type": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"video_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"body_style": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"drivetrain": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"provenance": {
"type": "object",
"required": [
"merch_updated_at",
"enriched_fields"
],
"properties": {
"enriched_fields": {
"type": "array",
"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,
"uniqueItems": true
},
"merch_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
},
"highway_mpg": {
"type": [
"integer",
"null"
],
"maximum": 999,
"minimum": 1
},
"photo_count": {
"type": "integer",
"maximum": 60,
"minimum": 0
},
"price_basis": {
"type": "string",
"const": "dealer_published"
},
"asking_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"is_certified": {
"type": [
"boolean",
"null"
]
},
"stock_number": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"transmission": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"odometer_unit": {
"enum": [
"mi",
"km"
],
"type": "string"
},
"options_count": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"special_price": {
"type": [
"number",
"null"
],
"minimum": 0
},
"exterior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"hero_photo_url": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"interior_color": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"special_expiry": {
"type": [
"string",
"null"
],
"format": "date",
"maxLength": 10
},
"effective_price": {
"type": [
"number",
"null"
],
"minimum": 0,
"description": "An unexpired special price when present, otherwise asking price; null when neither is available."
},
"carfax_one_owner": {
"type": [
"boolean",
"null"
]
},
"engine_cylinders": {
"type": [
"integer",
"null"
],
"maximum": 16,
"minimum": 1
},
"carfax_report_url": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"passenger_capacity": {
"type": [
"integer",
"null"
],
"maximum": 20,
"minimum": 1
},
"description_snippet": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"engine_displacement": {
"type": [
"string",
"null"
],
"maxLength": 80,
"minLength": 1
},
"effective_price_source": {
"enum": [
"special_price",
"asking_price",
null
],
"description": "The field selected for effective_price, or null when effective_price is null."
}
},
"description": "The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get."
},
{
"type": "object",
"required": [
"rooftop_slug",
"rooftop_name"
],
"properties": {
"distance_km": {
"type": [
"number",
"null"
],
"minimum": 0
},
"rooftop_name": {
"type": "string",
"maxLength": 200
},
"rooftop_slug": {
"type": "string",
"maxLength": 80
},
"distance_miles": {
"type": [
"number",
"null"
],
"minimum": 0
}
}
}
]
},
"maxItems": 5
},
"disclosure": {
"enum": [
"Advertised prices only; call quote_preview for an estimated total.",
"Advertised prices only, as published by the dealer."
]
},
"low_sample": {
"type": "boolean"
},
"priced_count": {
"type": "integer",
"minimum": 0
},
"catalog_version": {
"type": "string"
},
"filters_applied": {
"type": "object",
"required": [
"make",
"model",
"model_year",
"model_year_expand",
"currency"
],
"properties": {
"make": {
"type": "string"
},
"trim": {
"type": [
"string",
"null"
]
},
"model": {
"type": "string"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"condition": {
"enum": [
"new",
"used"
]
},
"model_year": {
"type": "integer"
},
"radius_miles": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"model_year_expand": {
"enum": [
0,
1
],
"type": "integer"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}inventory_comparables annotations
{
"title": "Compare a vehicle's price to like units",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}stores — Get dealership details
Advertised read-onlyOpen-world
One named rooftop's store record: name, dealer group, OEM programs, location/contact metadata, and fee schedule. Pass rooftop_slug. Whether a specific unit's listed price already includes a fee varies per unit — quote_preview returns the estimated total. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer.
stores input schema
{
"type": "object",
"required": [
"rooftop_slug"
],
"properties": {
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}stores output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"store"
],
"properties": {
"store": {
"allOf": [
{
"type": "object",
"required": [
"name",
"slug",
"country",
"dealer_group",
"oem_programs"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"name": {
"type": "string",
"maxLength": 200
},
"slug": {
"type": "string",
"maxLength": 80
},
"hours": {
"type": "object"
},
"phone": {
"type": "string",
"maxLength": 30
},
"state": {
"type": "string",
"maxLength": 50
},
"address": {
"type": "string",
"maxLength": 200
},
"country": {
"enum": [
"US",
"CA"
],
"type": "string"
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 1
},
"website_url": {
"type": "string",
"maxLength": 300
},
"dealer_group": {
"type": "object",
"required": [
"name",
"slug"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"slug": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
},
"manifest_url": {
"type": "string",
"maxLength": 300
},
"oem_programs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 20
}
},
"description": "The public projection of one rooftop's store metadata. NULL holders are omitted, never fabricated."
},
{
"type": "object",
"properties": {
"fee_schedule": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"label",
"category",
"fee_type",
"amount"
],
"properties": {
"code": {
"type": "string",
"maxLength": 60
},
"label": {
"type": "string",
"maxLength": 200
},
"amount": {
"type": "number",
"minimum": 0
},
"taxable": {
"type": "boolean"
},
"category": {
"enum": [
"fee",
"tax",
"title_reg"
]
},
"fee_type": {
"enum": [
"flat",
"percent"
]
},
"applies_to": {
"enum": [
"new",
"used",
"all"
]
},
"jurisdiction": {
"type": [
"string",
"null"
],
"maxLength": 60
},
"effective_from": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
},
"maxItems": 100
}
}
}
]
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}stores annotations
{
"title": "Get dealership details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}quote_preview — Preview an out-the-door price
Advertised read-onlyOpen-world
Read-only out-the-door price preview for one available unit at a named rooftop (pass rooftop_slug): base price plus itemized fees and taxes — fees already included in the listed price are flagged included_in_price and add nothing on top. Persists nothing; free to call while browsing. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. 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.
quote_preview input schema
{
"type": "object",
"required": [
"identity",
"rooftop_slug"
],
"properties": {
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}quote_preview output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"unit",
"pricing",
"assumptions",
"freshness_disclosure"
],
"properties": {
"unit": {
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"model": {
"type": "string",
"maxLength": 80
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"condition": {
"enum": [
"new",
"used"
]
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
}
},
"additionalProperties": false
},
"pricing": {
"type": "object",
"required": [
"base_price",
"fees_total",
"tax_total",
"otd_total",
"currency",
"line_items"
],
"properties": {
"currency": {
"const": "USD"
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"label",
"reason"
],
"properties": {
"code": {
"enum": [
"sales_tax",
"title",
"registration"
]
},
"label": {
"type": "string",
"maxLength": 40
},
"reason": {
"const": "varies_by_location"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"otd_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"tax_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"base_price": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"fees_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"label",
"category",
"fee_type",
"amount",
"taxable"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"basis": {
"enum": [
"firm",
"estimated"
]
},
"label": {
"type": "string",
"maxLength": 200
},
"amount": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"taxable": {
"type": "boolean"
},
"category": {
"type": "string",
"maxLength": 40
},
"fee_type": {
"enum": [
"flat",
"percent"
]
},
"included_in_price": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"pricing_coverage": {
"enum": [
"otd_estimate",
"partial_estimate"
]
},
"pricing_disclosure": {
"type": "string",
"maxLength": 500
}
},
"dependentRequired": {
"excluded": [
"pricing_coverage",
"pricing_disclosure"
],
"pricing_coverage": [
"excluded",
"pricing_disclosure"
],
"pricing_disclosure": [
"pricing_coverage",
"excluded"
]
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 50
},
"freshness_disclosure": {
"type": "object",
"required": [
"generated_at",
"inventory_last_seen_at",
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"inventory_last_seen_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}quote_preview annotations
{
"title": "Preview an out-the-door price",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}deal_quote — Request a quote
Advertised destructiveOpen-world
Out-the-door quote for one available unit at a named rooftop. Anonymous calls are stateless; authenticated calls persist a deal thread. Anonymous calls persist nothing; quote_preview is the read-only equivalent for browsing. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. 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.
deal_quote input schema
{
"type": "object",
"required": [
"identity",
"rooftop_slug"
],
"properties": {
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Required when authenticated (durable quote); ignored meaningfully only with an agent key."
}
},
"additionalProperties": false
}deal_quote output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"durable",
"thread_id",
"quote_id",
"expires_at",
"unit",
"pricing",
"assumptions",
"freshness_disclosure"
],
"properties": {
"unit": {
"type": "object",
"required": [
"identity",
"condition",
"model_year",
"make",
"model"
],
"properties": {
"make": {
"type": "string",
"maxLength": 80
},
"model": {
"type": "string",
"maxLength": 80
},
"identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
},
"condition": {
"enum": [
"new",
"used"
]
},
"model_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
}
},
"additionalProperties": false
},
"durable": {
"type": "boolean"
},
"pricing": {
"type": "object",
"required": [
"base_price",
"fees_total",
"tax_total",
"otd_total",
"currency",
"line_items"
],
"properties": {
"currency": {
"const": "USD"
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"label",
"reason"
],
"properties": {
"code": {
"enum": [
"sales_tax",
"title",
"registration"
]
},
"label": {
"type": "string",
"maxLength": 40
},
"reason": {
"const": "varies_by_location"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"otd_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"tax_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"base_price": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"fees_total": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"label",
"category",
"fee_type",
"amount",
"taxable"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"basis": {
"enum": [
"firm",
"estimated"
]
},
"label": {
"type": "string",
"maxLength": 200
},
"amount": {
"type": "string",
"pattern": "^-?[0-9]+\\.[0-9]{2}$",
"description": "Exact decimal amount with two places (never a JSON float)."
},
"taxable": {
"type": "boolean"
},
"category": {
"type": "string",
"maxLength": 40
},
"fee_type": {
"enum": [
"flat",
"percent"
]
},
"included_in_price": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"pricing_coverage": {
"enum": [
"otd_estimate",
"partial_estimate"
]
},
"pricing_disclosure": {
"type": "string",
"maxLength": 500
}
},
"dependentRequired": {
"excluded": [
"pricing_coverage",
"pricing_disclosure"
],
"pricing_coverage": [
"excluded",
"pricing_disclosure"
],
"pricing_disclosure": [
"pricing_coverage",
"excluded"
]
},
"additionalProperties": false
},
"quote_id": {
"oneOf": [
{
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
{
"type": "null"
}
]
},
"thread_id": {
"oneOf": [
{
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
{
"type": "null"
}
]
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"assumptions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 50
},
"freshness_disclosure": {
"type": "object",
"required": [
"generated_at",
"inventory_last_seen_at",
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"inventory_last_seen_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}deal_quote annotations
{
"title": "Request a quote",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}lead_prepare — Ask the dealership to reach out — prepare
Advertised read-onlyOpen-world
Prepare a named dealership's exact contact disclosure and a short-lived signed binding.
lead_prepare input schema
{
"type": "object",
"required": [
"rooftop_slug",
"unit_identity",
"customer",
"channels"
],
"properties": {
"channels": {
"type": "array",
"items": {
"enum": [
"email",
"phone"
]
},
"maxItems": 2,
"minItems": 1,
"uniqueItems": true
},
"comments": {
"type": "string",
"maxLength": 2000
},
"customer": {
"type": "object",
"anyOf": [
{
"required": [
"email"
]
},
{
"required": [
"phone"
]
}
],
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"email": {
"type": "string",
"pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
"maxLength": 254,
"minLength": 6
},
"phone": {
"type": "string",
"pattern": "^(?=(?:[^0-9]*[0-9]){7,15}[^0-9]*$)\\+?[0-9()\\-. ]+$",
"maxLength": 30,
"minLength": 7
}
},
"additionalProperties": false
},
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"include_quote": {
"type": "boolean",
"default": true,
"description": "Set false when the shopper was not shown a quote: the disclosure then makes no price claim and quote_included is false."
},
"unit_identity": {
"type": "string",
"maxLength": 30,
"minLength": 5
}
},
"description": "customer.email requires channels to include email. customer.phone requires channels to include phone.",
"additionalProperties": false
}lead_prepare output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"disclosure_text",
"binding",
"expires_at",
"quote_included"
],
"properties": {
"binding": {
"type": "string",
"maxLength": 16384,
"minLength": 1
},
"expires_at": {
"type": "string",
"format": "date-time",
"maxLength": 40
},
"quote_included": {
"type": "boolean"
},
"disclosure_text": {
"type": "string",
"maxLength": 5000,
"minLength": 10
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}lead_prepare annotations
{
"title": "Ask the dealership to reach out — prepare",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lead_submit — Ask the dealership to reach out — confirm
Advertised destructiveOpen-world
Submit the shopper's bound contact request to the named dealership.
lead_submit input schema
{
"type": "object",
"required": [
"rooftop_slug",
"binding",
"disclosure_text",
"customer"
],
"properties": {
"binding": {
"type": "string",
"maxLength": 16384,
"minLength": 1
},
"comments": {
"type": "string",
"maxLength": 2000
},
"customer": {
"type": "object",
"anyOf": [
{
"required": [
"email"
]
},
{
"required": [
"phone"
]
}
],
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"email": {
"type": "string",
"pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
"maxLength": 254,
"minLength": 6
},
"phone": {
"type": "string",
"pattern": "^(?=(?:[^0-9]*[0-9]){7,15}[^0-9]*$)\\+?[0-9()\\-. ]+$",
"maxLength": 30,
"minLength": 7
}
},
"additionalProperties": false
},
"rooftop_slug": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"disclosure_text": {
"type": "string",
"maxLength": 5000,
"minLength": 10
}
},
"additionalProperties": false
}lead_submit output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"required": [
"lead_id",
"status"
],
"properties": {
"status": {
"const": "accepted"
},
"lead_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"maxLength": 36
}
},
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"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": {
"type": "string",
"maxLength": 500
},
"retryable": {
"type": "boolean"
},
"auth_help_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"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."
},
"retry_after_seconds": {
"type": "integer",
"minimum": 0
}
},
"description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"by_rooftop"
],
"properties": {
"by_rooftop": {
"type": "object",
"maxProperties": 500,
"additionalProperties": {
"type": "object",
"required": [
"status",
"last_ingest_at"
],
"properties": {
"status": {
"enum": [
"fresh",
"stale",
"no_data"
]
},
"last_ingest_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"maxLength": 40
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}lead_submit annotations
{
"title": "Ask the dealership to reach out — confirm",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 574 ms
- 95th percentile latency
- 574 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 574 ms · metadata changed · 12 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http agentic-dealer-network-mcp https://gateway.agenticdealernetwork.com/mcpCodex
Codex configuration
codex mcp add agentic-dealer-network-mcp --url https://gateway.agenticdealernetwork.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"agentic-dealer-network-mcp": {
"url": "https://gateway.agenticdealernetwork.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"agentic-dealer-network-mcp": {
"type": "streamableHttp",
"url": "https://gateway.agenticdealernetwork.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"agentic-dealer-network-mcp": {
"type": "http",
"url": "https://gateway.agenticdealernetwork.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http agentic-dealer-network-mcp https://gateway.agenticdealernetwork.com/mcpClaude Desktop
Claude Desktop configuration
https://gateway.agenticdealernetwork.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"agentic-dealer-network-mcp": {
"serverUrl": "https://gateway.agenticdealernetwork.com/mcp"
}
}
}Let your agent find its tools
Find servers like Agentic Dealer Network MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Agentic Dealer Network MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.