Contract
input_schema.json
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search keyword (e.g. 'Toyota Camry', 'Ford F-150', or a VIN)."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"to": {
"type": [
"number",
"null"
],
"description": "1-based index of the last listing on this page; null when the result set is empty."
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lot": {
"type": "string",
"description": "Bid.Cars' own lot identifier, e.g. '0-46020629'."
},
"tag": {
"type": "string",
"description": "A year-make-model-VIN slug, e.g. '2000-Toyota-Camry-2T1CG22P0YC332052'."
},
"vin": {
"type": "string"
},
"name": {
"type": "string",
"description": "The listing's title (year, make, model, trim), e.g. '2000 Toyota Camry, Solara SE'. Vehicle listing data, not a person's name."
},
"type": {
"type": "string",
"description": "'Automobile' on every listing observed."
},
"specs": {
"type": "object",
"properties": {
"hybrid": {
"type": [
"number",
"null"
],
"description": "Null on most listings captured; observed as the number 1 on a few, presumably a 0/1 hybrid flag, unconfirmed."
},
"key_info": {
"type": "string",
"description": "e.g. 'Present', 'Missing'."
},
"engine_rendered": {
"type": "string",
"description": "A human-readable engine summary, e.g. '2.2L, I4, 135/138HP'."
}
},
"description": "A subset of vendor-reported specs. transmission/drive_type/fuel_type are omitted here -- every listing observed reported them as uninterpreted codes (0, 0, and \"0\" respectively) with no documented meaning, so they carry no customer value (see verification.notes).",
"additionalProperties": false
},
"seller": {
"type": "string",
"description": "A shortened seller/insurer name, e.g. 'Progressive Cas...'."
},
"status": {
"type": "number",
"description": "A numeric listing-status code (2 on every listing observed, all ended). Meaning beyond that is not decoded by this response."
},
"location": {
"type": "string",
"description": "The auction yard's city/state, e.g. 'Savannah (GA)'."
},
"odometer": {
"type": "number",
"description": "Miles."
},
"final_bid": {
"type": "number"
},
"has_video": {
"type": "boolean",
"description": "Whether Bid.Cars has a video for this listing; this response does not include the video URL itself."
},
"loss_type": {
"type": "string",
"description": "e.g. 'Other', 'Collision'."
},
"name_long": {
"type": "string",
"description": "A variant of name, occasionally with more trim detail; also vehicle listing data."
},
"time_left": {
"type": "string",
"description": "Observed only as the literal string '0' -- every listing captured had already ended."
},
"start_code": {
"type": "string",
"description": "e.g. 'Run / Drive', 'Stationary'."
},
"seller_long": {
"type": "string",
"description": "The seller/insurer's full name, e.g. 'Progressive Casualty Insurance'. A business name, not an individual's."
},
"sold_before": {
"type": "number",
"description": "0/1 flag for whether this VIN has sold at auction before."
},
"has_360_view": {
"type": "boolean",
"description": "Whether Bid.Cars has a 360-degree view for this listing; this response does not include that URL itself."
},
"prebid_price": {
"type": "string",
"description": "A dollar-formatted string, e.g. '$25', '$3,150'."
},
"buy_now_price": {
"type": [
"string",
"null"
],
"description": "Null on almost every listing captured; observed once as a dollar-formatted string, e.g. '$3,500', for a true buy-now listing."
},
"estimated_max": {
"type": "number",
"description": "Estimated retail value, high end."
},
"estimated_min": {
"type": "number",
"description": "Estimated retail value, low end."
},
"sale_document": {
"type": "string",
"description": "e.g. 'Clear', 'Salvage', 'Bill of sale'."
},
"search_status": {
"type": "string",
"description": "'ended' on every listing observed; other values are plausible but unconfirmed."
},
"primary_damage": {
"type": "string",
"description": "e.g. 'Normal wear / tear', 'Front end', 'Left rear'."
},
"seller_trusted": {
"type": "number",
"description": "0/1 flag."
},
"title_has_lien": {
"type": "number",
"description": "0/1 flag; 0 on every listing observed."
},
"start_code_color": {
"type": "string",
"description": "e.g. 'green', 'orange' -- a UI severity hint for start_code."
},
"buy_now_close_time": {
"type": [
"number",
"string"
],
"description": "Observed as both the number 0 and the string '0' across different listings in the same fixture -- type is inconsistent in the raw data, not a capture error."
},
"final_bid_formatted": {
"type": "string",
"description": "A dollar-formatted string, e.g. '$325'."
},
"sale_document_split": {
"type": "string",
"description": "sale_document plus the title state, e.g. 'Salvage (Georgia)'."
},
"sale_document_state": {
"type": "string",
"description": "The US state named on the title."
},
"time_left_formatted": {
"type": "string",
"description": "Observed only as the literal string '0', same caveat as time_left."
},
"prebid_close_time_lang": {
"type": "object",
"properties": {
"en": {
"type": "string",
"description": "e.g. 'Fri 18 Sep, 15:30 GMT+2'."
}
},
"description": "The prebid close time in English only (other languages the vendor returns are dropped, see verification.notes).",
"additionalProperties": false
},
"sale_document_external": {
"type": "string",
"description": "A longer, state-qualified version of sale_document."
},
"sale_document_external_status": {
"type": "number",
"description": "A numeric code paired with sale_document_external (1, 2, and 5 observed); meaning beyond that is not decoded by this response."
}
},
"additionalProperties": false
},
"description": "The matching listings for this page (up to per_page entries). Empty on a keyword that matches nothing, observed directly (examples/nonsense-query-empty.json). No field in either fixture reports a total result count or total page count -- only this page's own listings and current_page/per_page are available."
},
"from": {
"type": [
"number",
"null"
],
"description": "1-based index of the first listing on this page; null when the result set is empty."
},
"per_page": {
"type": "number",
"description": "Page size; observed as 50 on both real calls."
},
"current_page": {
"type": "number",
"description": "Always 1 on both real calls observed."
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"description": "'success' on both real calls observed, including the empty-result case."
}
},
"description": "The search result, as returned at routing.responseResultPath ($.output).",
"additionalProperties": false
}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 23, 2026