Contract
input_schema.json
{
"type": "object",
"required": [
"vin"
],
"properties": {
"vin": {
"type": "string",
"description": "Vehicle Identification Number (VIN) of an active CARFAX listing. Obtain from search_used_car_listings results."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"description": "The dealer's postal code, as text."
},
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "The dealer's trade name (a public business, e.g. 'Fred Beans Nissan')."
},
"logos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The logo's internal id."
},
"url": {
"type": [
"string",
"null"
],
"description": "Always null in the shaped output (logo URL withheld)."
},
"primary": {
"type": "string",
"description": "Display-priority flag, observed as the string '0'."
}
},
"additionalProperties": true
},
"description": "The dealer's logo image(s); present on both real calls."
},
"phone": {
"type": "string",
"description": "The dealer's posted phone number, digits only with no formatting (e.g. '2672142726')."
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. 'PA'."
},
"photos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The photo's internal id."
},
"url": {
"type": [
"string",
"null"
],
"description": "Always null in the shaped output (photo URL withheld)."
},
"primary": {
"type": "string",
"description": "Display-priority flag, observed as the string '0'."
}
},
"additionalProperties": true
},
"description": "The dealer's lot photos; present on one real call only."
},
"address": {
"type": "string",
"description": "The dealer's street address."
},
"carfaxId": {
"type": "string",
"description": "The data vendor's internal id for the dealer, e.g. 'EWHOZYPEF1'."
},
"ddcValue": {
"type": "number",
"description": "A numeric score carried in the payload (observed 1.5 and 2.4); its exact vendor meaning is not documented in the captured fixtures."
},
"feeBadge": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Plain-language fee note (observed 'Price includes fees')."
},
"isValid": {
"type": "boolean",
"description": "Whether the fee-badge statement holds."
}
},
"additionalProperties": true
},
"latitude": {
"type": "string",
"description": "The dealer's latitude as TEXT (observed as a digit string, not a JSON number)."
},
"groupName": {
"type": "string",
"description": "The owning dealer group's name (e.g. 'Fred Beans Automotive Group'); present on one real call only."
},
"longitude": {
"type": "string",
"description": "The dealer's longitude as TEXT (observed as a digit string, not a JSON number)."
},
"badgeDetails": {
"type": "object",
"properties": {
"badgeUrls": {
"type": "object",
"properties": {
"svg": {
"type": [
"string",
"null"
],
"description": "Always null (withheld URL); present when the dealer's badge has an SVG asset."
},
"small": {
"type": [
"string",
"null"
],
"description": "Always null (withheld URL)."
}
},
"description": "Badge image URLs. Always null in the shaped output: the image URLs are deliberately not passed through.",
"additionalProperties": true
},
"badgeAltText": {
"type": "object",
"properties": {
"en": {
"type": "string",
"description": "English alt text, e.g. 'CARFAX Top-Rated Dealer'."
}
},
"description": "Localized alt text keyed by language; only English ('en') observed in the fixtures.",
"additionalProperties": true
},
"topRatedYear": {
"type": "string",
"description": "Year of the Top-Rated designation (e.g. '2025'); present when the dealer's badge is Top-Rated."
},
"eligibleBadges": {
"type": "array",
"items": {
"type": "string"
},
"description": "Badge identifiers the dealer is eligible for (observed 'TOPRATED', 'LIFETIME', 'ADVANTAGE')."
},
"badgeExperience": {
"type": "string",
"description": "Badge identifier (observed 'TOPRATED', 'ADVANTAGE')."
}
},
"description": "The dealer's CARFAX badge and its image metadata.",
"additionalProperties": true
},
"inventoryUrl": {
"type": [
"string",
"null"
],
"description": "The dealer's website URL; always null in the shaped output (URL withheld)."
},
"additionalFee": {
"type": "number",
"description": "An additional dealer fee in USD reported with the listing (observed 490 and 895)."
},
"businessHours": {
"type": "array",
"items": {
"type": "object",
"properties": {
"friday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"monday": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The vendor's internal id for this day's hours."
},
"open": {
"type": [
"string",
"null"
],
"description": "Opening time ('HH:MM', 24-hour), or null when closed that day."
},
"close": {
"type": [
"string",
"null"
],
"description": "Closing time ('HH:MM', 24-hour), or null when closed that day."
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"sunday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
],
"description": "Observed null for the Civic-listing dealer (closed Sunday)."
},
"close": {
"type": [
"string",
"null"
],
"description": "Observed null for the Civic-listing dealer (closed Sunday)."
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"tuesday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"saturday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"thursday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
},
"wednesday": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "One element per day of the week; each element is keyed by the weekday (monday..sunday) and holds that day's open/close times. Sunday's open and close were observed null on one real call (that dealership was closed on Sunday), so every day's open/close is typed to allow null -- a dealer can close any day."
},
"cfxMicrositeUrl": {
"type": [
"string",
"null"
],
"description": "The dealer's vendor-hosted review page URL; always null in the shaped output (URL withheld)."
},
"showPriceHistory": {
"type": "boolean",
"description": "Whether the listing shows a price history; present on one real call only."
},
"dealerReviewCount": {
"type": "number",
"description": "Number of customer reviews (e.g. 684); present on one real call only."
},
"sellMyCarEligible": {
"type": "boolean",
"description": "Whether the dealer participates in the vendor's sell-my-car program; present on one real call only."
},
"dealerInventoryUrl": {
"type": [
"string",
"null"
],
"description": "Always null in the shaped output (URL withheld)."
},
"dealerReviewRating": {
"type": "number",
"description": "A customer-review star rating (observed 5); present on one real call only."
},
"dealerAverageRating": {
"type": "number",
"description": "Average customer rating out of 5 (e.g. 4.7); present on one real call only."
},
"dealerLicenseNumber": {
"type": "string",
"description": "The dealer's state-issued license number (e.g. 'UCAR048175'); present on one real call only."
},
"franchisePartnerships": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The vehicle-make franchise name (e.g. 'NISSAN') -- a business brand, not a person."
},
"certify": {
"type": "boolean",
"description": "Whether the franchise is a certified partnership."
}
},
"additionalProperties": true
},
"description": "Vehicle-make franchise partnerships. Present on one real call only (the Civic-listing dealer); absent when the dealer has none."
}
},
"description": "The dealership record for the listing's seller.",
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real active-listing calls observed."
}
},
"description": "The dealer-details result for an active listing, as returned at routing.responseResultPath ($.output). Both fixtures behind this schema are active-listing successes; the payload's field set varies by dealer, so no top-level field is guaranteed present.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.01365 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 25, 2026