Dealer Details (by VIN)
omnial/get-dealer-details
Given a VIN from an active CARFAX listing, returns the dealership selling it: the dealer's trade name, street address, phone number, per-day business hours, customer rating and review count, badge status, and its lot photos and logo.
activeper callv2
Price
Up to $0.0137 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/get-dealer-details" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/get-dealer-details" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/get-dealer-details", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/get-dealer-details", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0137 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
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
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 (e.g. 1.5 or 2.4); its exact vendor meaning is not documented."
},
"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; typically only English ('en').",
"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. The payload's field set varies by dealer, so no top-level field is guaranteed present.",
"additionalProperties": true
}