deal_quote

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.

destructive

Argument	Type	Description
identity*	string
rooftop_slug*	string
idempotency_key	string	Required when authenticated (durable quote); ignored meaningfully only with an agent key.

Input schema (JSON)

{
  "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
}

inventory_changes

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.

read-only

Argument	Type	Description
view	any
cursor*	string
country	string	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.
rooftop_slug	string

Input schema (JSON)

{
  "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_comparables

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.

read-only

Argument	Type	Description
make	string
trim	string
model	string
country	string	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.
currency	string
identity	string
latitude	number
condition	any
longitude	number

inventory_get

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.

read-only

Argument	Type	Description
country	string	Optional consistency assertion: must equal the rooftop's country; omit it unless you are checking.
identity*	string
rooftop_slug*	string

Input schema (JSON)

{
  "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_stats

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.

read-only

Argument	Type	Description
make	any
trim	string
model	any
format	any
country	string	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.
group_by	array
latitude	number
condition	any

lead_prepare

Prepare a named dealership's exact contact disclosure and a short-lived signed binding.

read-only

Argument	Type	Description
channels*	array
comments	string
customer*	object
rooftop_slug*	string
include_quote	boolean	Set false when the shopper was not shown a quote: the disclosure then makes no price claim and quote_included is false.
unit_identity*	string

Input schema (JSON)

{
  "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_submit

Submit the shopper's bound contact request to the named dealership.

destructive

Argument	Type	Description
binding*	string
comments	string
customer*	object
rooftop_slug*	string
disclosure_text*	string

Input schema (JSON)

{
  "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
}

network_directory

Directory of active ADN rooftops: slug, name, dealer group, OEM programs, location metadata, and per-rooftop manifest URL. Pass country=CA for Canadian dealers.

read-only

Argument	Type	Description
limit	integer
offset	integer
country	string	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.

Input schema (JSON)

{
  "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_search

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.

read-only

Argument	Type	Description
make	any
sort	any	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	string
view	any
limit	integer	1–500 with view manifest; 1–50 for summary and full (server-enforced)
model	any

network_snapshot

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.

read-only

Argument	Type	Description
view	any
format	any
country	string	Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.
rooftop_slug	string

Input schema (JSON)

{
  "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
}

quote_preview

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.

read-only

Argument	Type	Description
identity*	string
rooftop_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "identity",
    "rooftop_slug"
  ],
  "properties": {
    "identity": {
      "type": "string",
      "maxLength": 30,
      "minLength": 5
    },
    "rooftop_slug": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

stores

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.

read-only

Argument	Type	Description
rooftop_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "rooftop_slug"
  ],
  "properties": {
    "rooftop_slug": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

Agentic Dealer Network

Try it

deal_quote Destructive

Agentic Dealer Network

Try it

deal_quote Destructive

Tools (12)