Auction Vehicle Search by Keyword (Bid.Cars)
omnial/search-by-keyword
Given a free-text keyword (a make, model, VIN, or lot number), searches active Bid.Cars auction listings and returns up to 50 matching results per page: each listing's title, VIN, lot number, damage and title/salvage status, odometer reading, seller or insurer, and bid pricing (prebid, buy-now, and final-bid amounts where available). A keyword matching nothing returns an empty result set rather than an error.
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.
Data source
Data from Bid.Cars.
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/search-by-keyword" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-by-keyword" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-by-keyword", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-by-keyword", 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": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search keyword (e.g. 'Toyota Camry', 'Ford F-150', or a VIN)."
}
},
"additionalProperties": false
}Output schema
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.",
"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 response -- type is inconsistent in the source data."
},
"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).",
"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. No field 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.",
"additionalProperties": false
}