Contract
input_schema.json
{
"type": "object",
"required": [
"body_type"
],
"properties": {
"zip": {
"type": "string",
"description": "5-digit US ZIP code for search location."
},
"body_type": {
"type": "string",
"description": "Vehicle body type filter. Accepted values: SUV, Sedan, Truck, Pickup, Minivan, Coupe, Convertible, Wagon, Hatchback."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "An opaque identifier for this specific listing."
},
"vin": {
"type": "string"
},
"fees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee": {
"type": "number",
"description": "USD amount."
},
"feeType": {
"type": "string"
}
},
"additionalProperties": true
}
},
"fuel": {
"type": "string"
},
"make": {
"type": "string"
},
"trim": {
"type": "string"
},
"year": {
"type": "number"
},
"badge": {
"type": "string",
"description": "A short deal-quality label, e.g. 'GREAT'."
},
"model": {
"type": "string"
},
"dealer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "The dealership's business name."
},
"state": {
"type": "string"
},
"feeBadge": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'Price includes fees'."
},
"isValid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"dealerReviewDate": {
"type": "string"
},
"dealerReviewCount": {
"type": "number"
},
"dealerReviewRating": {
"type": "number"
},
"dealerAverageRating": {
"type": "number"
},
"dealerReviewComments": {
"type": "string",
"description": "The most recent public customer review's text."
},
"dealerReviewReviewer": {
"type": "string",
"description": "Anonymized on every real call observed, e.g. '2018 VOLKSWAGEN TIGUAN S Owner' -- not a real name."
},
"dealerBadgingExperience": {
"type": "string",
"description": "e.g. 'TOPRATED'."
}
},
"description": "The selling dealer's public business identity. Street address, phone number, and precise coordinates are intentionally not included -- see this tool's own verification notes.",
"additionalProperties": true
},
"engine": {
"type": "string"
},
"cabType": {
"type": "string",
"description": "Truck cab style, e.g. 'Crew Cab' -- 'Unspecified' on a non-truck."
},
"cpoData": {
"type": "object",
"properties": {
"cpo_body": {
"type": "string"
},
"make_name": {
"type": "string",
"description": "The manufacturer's CPO program brand, e.g. 'Volkswagen'."
},
"cpo_header": {
"type": "string"
},
"cpo_bullet_1": {
"type": "string"
},
"cpo_bullet_2": {
"type": "string"
},
"cpo_bullet_3": {
"type": "string"
}
},
"description": "Present only on certified pre-owned listings.",
"additionalProperties": true
},
"mileage": {
"type": "number"
},
"mpgCity": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCombined instead."
},
"subTrim": {
"type": "string"
},
"bodytype": {
"type": "string"
},
"oneOwner": {
"type": "boolean"
},
"onePrice": {
"type": "number",
"description": "A total walk-in price figure, USD, generally higher than listPrice."
},
"bedLength": {
"type": "string",
"description": "Truck bed length, e.g. 'Short Bed' -- 'Unspecified' on a non-truck."
},
"certified": {
"type": "boolean",
"description": "Whether this is a certified pre-owned vehicle."
},
"drivetype": {
"type": "string"
},
"firstSeen": {
"type": "string",
"description": "Date this listing first appeared."
},
"listPrice": {
"type": "number",
"description": "The dealer's listed asking price, USD."
},
"allInPrice": {
"type": "boolean",
"description": "Whether the quoted price already includes dealer fees."
},
"dealerType": {
"type": "string",
"description": "e.g. 'NEW' for a new-car franchise dealer."
},
"imageCount": {
"type": "number",
"description": "Number of photos available for this listing."
},
"mpgHighway": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCombined instead."
},
"topOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Notable equipped features, e.g. 'Heated Seats', 'Remote Start'."
},
"mpgCombined": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCity/mpgHighway instead."
},
"noAccidents": {
"type": "boolean"
},
"personalUse": {
"type": "boolean"
},
"reliability": {
"type": "object",
"properties": {
"costBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"riskBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"averageCost": {
"type": "number",
"description": "Estimated average annual repair cost, USD."
},
"reliabilityPlacement": {
"type": "number",
"description": "A percentile ranking."
},
"overallReliabilityBadge": {
"type": "string",
"description": "e.g. 'GOOD'."
}
},
"additionalProperties": true
},
"stockNumber": {
"type": "string",
"description": "The dealer's own inventory reference number for this vehicle."
},
"chicletBadge": {
"type": "string",
"description": "A short highlight label, e.g. 'Low Mileage', 'High Demand'."
},
"currentPrice": {
"type": "number",
"description": "The current asking price, USD -- equal to listPrice on every real call observed."
},
"displacement": {
"type": "string"
},
"ownerHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'CARFAX 1-Owner'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "General location of this owner, not a person's identity."
},
"state": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"purchaseDate": {
"type": "string"
},
"endOwnershipDate": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"priceHistory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"listPrice": {
"type": "number"
},
"difference": {
"type": "number",
"description": "USD change from the previous entry."
}
},
"additionalProperties": true
},
"description": "Observed on the second fixture only -- a list of price changes for this listing."
},
"transmission": {
"type": "string"
},
"vehiclePrice": {
"type": "number",
"description": "A separate vendor-computed price figure, USD, distinct from listPrice on real calls observed."
},
"exteriorColor": {
"type": "string"
},
"interiorColor": {
"type": "string"
},
"listingStatus": {
"type": "string"
},
"reliabilityV2": {
"type": "object",
"properties": {
"reliabilityImpactFactors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"subText": {
"type": "string"
},
"descriptiveText": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Plain-language reliability factors, e.g. repair cost and oil-change history."
}
},
"additionalProperties": true
},
"onePriceArrows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'No Accidents Reported', '1-Owner Vehicle'."
},
"arrow": {
"type": "string",
"description": "'UP' or 'DOWN', direction of price impact."
},
"order": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Short reasons the vehicle qualifies for its onePrice figure."
},
"serviceHistory": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"number": {
"type": "number",
"description": "Count of documented service records."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string"
},
"state": {
"type": "string"
},
"source": {
"type": "string",
"description": "The servicing business's name and location, e.g. 'City Volkswagen of Evanston, Evanston, IL, '."
},
"description": {
"type": "string"
},
"odometerReading": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"serviceRecords": {
"type": "boolean",
"description": "Whether documented service records exist for this vehicle."
},
"accidentHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'No Accident or Damage Reported'."
},
"accidentSummary": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"distanceToDealer": {
"type": "number",
"description": "Miles from the search location."
},
"vehicleCondition": {
"type": "string",
"description": "e.g. 'Used'."
},
"vehicleUseHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'Personal Use'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"useType": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"averageMilesPerYear": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"monthlyPaymentEstimate": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "The vehicle's price used for the estimate, USD."
},
"loanAmount": {
"type": "number",
"description": "USD."
},
"interestRate": {
"type": "number",
"description": "Assumed annual rate, percent."
},
"termInMonths": {
"type": "number"
},
"monthlyPayment": {
"type": "number",
"description": "USD."
},
"downPaymentAmount": {
"type": "number",
"description": "USD."
},
"downPaymentPercent": {
"type": "number"
}
},
"description": "A standard-assumptions monthly payment estimate for this listing.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The page of matching listings returned by this call (24 on both real calls)."
},
"searchArea": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"description": "The ZIP code the search actually ran against (echoes the input)."
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"radius": {
"type": "number",
"description": "Search radius in miles."
},
"latitude": {
"type": "number",
"description": "Resolved center-point latitude."
},
"longitude": {
"type": "number",
"description": "Resolved center-point longitude."
},
"dynamicRadii": {
"type": "array",
"items": {
"type": "number"
},
"description": "Wider fallback radii (miles) the search can expand to, observed as [50, 100, 200] on both real calls."
}
},
"description": "The resolved search location both fixtures echo back.",
"additionalProperties": true
},
"totalListingCount": {
"type": "number",
"description": "The total number of matching listings in the market, NOT the number of listings in this response's `listings` array (both real calls returned 24 listings while reporting a much larger total, e.g. 40798) -- this call does not paginate through it."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The search result, as returned at routing.responseResultPath ($.output).",
"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