Vehicle Auction Listings Search (by Make, Model, Year & Status)
omnial/search-listings
Search live and ended vehicle auction listings by make, model, year range, status, and auction type, one paginated page (up to 50 listings) per call. Each listing carries the vehicle title, VIN, odometer, damage/loss type, seller, sale-document status, current or final bid, and buy-now price. Set get_count to return a single count summary (active, live, ended, fast-buy, and total listing counts) instead of listing rows.
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-listings" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-listings" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-listings", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-listings", 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",
"anyOf": [
{
"required": [
"make"
]
},
{
"required": [
"model"
]
},
{
"required": [
"year_from"
]
},
{
"required": [
"year_to"
]
},
{
"required": [
"status"
]
},
{
"required": [
"auction_type"
]
},
{
"required": [
"get_count"
]
},
{
"required": [
"page"
]
}
],
"properties": {
"make": {
"type": "string",
"description": "Vehicle make filter. Use 'All' for no make filter."
},
"page": {
"type": "integer",
"description": "Page number for pagination."
},
"model": {
"type": "string",
"description": "Vehicle model filter. Use 'All' for no model filter."
},
"status": {
"type": "string",
"description": "Listing status filter."
},
"year_to": {
"type": "string",
"description": "Maximum model year."
},
"get_count": {
"type": "string",
"description": "Set to 'true' to return a count summary object instead of listing data."
},
"year_from": {
"type": "string",
"description": "Minimum model year."
},
"auction_type": {
"type": "string",
"description": "Auction type filter."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"status",
"data"
],
"properties": {
"data": {
"type": "object",
"properties": {
"to": {
"type": "integer"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lot": {
"type": "string",
"description": "The vendor's own lot identifier, e.g. '0-45983127'."
},
"tag": {
"type": "string",
"description": "A URL-safe slug of the title plus VIN."
},
"vin": {
"type": "string"
},
"name": {
"type": "string",
"description": "The listing's vehicle title, e.g. '2001 Toyota Sienna, LE' -- year, make, model, and trim, not a person's name."
},
"type": {
"type": "string",
"description": "e.g. 'Automobile'."
},
"specs": {
"type": "object",
"properties": {
"hybrid": {
"type": [
"integer",
"null"
]
},
"key_info": {
"type": "string"
},
"fuel_type": {
"type": "string"
},
"drive_type": {
"type": [
"integer",
"null"
]
},
"transmission": {
"type": "integer"
},
"engine_rendered": {
"type": "string",
"description": "Free-text engine summary."
}
},
"additionalProperties": false
},
"seller": {
"type": "string",
"description": "Truncated seller/insurer name."
},
"status": {
"type": "integer",
"description": "A vendor status code; every row observed was 2."
},
"location": {
"type": "string",
"description": "City and state/province abbreviation."
},
"odometer": {
"type": "integer"
},
"final_bid": {
"type": [
"number",
"null"
],
"description": "Null when the lot has not closed with a winning bid yet."
},
"has_video": {
"type": "boolean"
},
"loss_type": {
"type": "string",
"description": "e.g. 'Collision', 'Other'."
},
"name_long": {
"type": "string",
"description": "The same vehicle title, observed identical to `name` on every row."
},
"time_left": {
"type": "string"
},
"start_code": {
"type": "string",
"description": "Vendor-reported starting condition, e.g. 'Run / Drive'."
},
"seller_long": {
"type": "string",
"description": "Untruncated seller/insurer name."
},
"sold_before": {
"type": "integer"
},
"has_360_view": {
"type": "boolean"
},
"prebid_price": {
"type": "string",
"description": "Formatted currency string, e.g. '$0'."
},
"buy_now_price": {
"type": [
"string",
"null"
],
"description": "Formatted currency string, or null when no buy-now offer applies."
},
"estimated_max": {
"type": "integer"
},
"estimated_min": {
"type": "integer"
},
"sale_document": {
"type": "string",
"description": "e.g. 'Clear', 'Salvage'."
},
"search_status": {
"type": "string",
"description": "e.g. 'ended'."
},
"primary_damage": {
"type": "string"
},
"seller_trusted": {
"type": "integer",
"description": "0 or 1 on every row observed."
},
"title_has_lien": {
"type": "integer"
},
"odometer_substr": {
"type": "integer",
"description": "Odometer rounded to thousands of miles."
},
"start_code_color": {
"type": "string"
},
"buy_now_close_time": {
"type": [
"integer",
"string"
],
"description": "Unix timestamp when observed as a number; the vendor also emits the literal '0' as a string for some rows."
},
"odometer_km_substr": {
"type": "integer",
"description": "Odometer rounded to thousands of kilometers."
},
"final_bid_formatted": {
"type": [
"string",
"null"
]
},
"sale_document_split": {
"type": "string"
},
"sale_document_state": {
"type": "string"
},
"time_left_formatted": {
"type": "string"
},
"prebid_close_time_lang": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pl": {
"type": "string"
},
"ru": {
"type": "string"
},
"ua": {
"type": "string"
}
},
"description": "The prebid close time, pre-rendered in four languages.",
"additionalProperties": false
},
"sale_document_external": {
"type": "string"
},
"sale_document_external_status": {
"type": "integer"
}
},
"additionalProperties": false
},
"description": "Present only on a listing-search call. Up to 50 rows per page."
},
"from": {
"type": "integer"
},
"count": {
"type": "object",
"properties": {
"all": {
"type": [
"integer",
"null"
]
},
"live": {
"type": [
"integer",
"null"
]
},
"ended": {
"type": [
"integer",
"null"
]
},
"active": {
"type": [
"integer",
"null"
]
},
"fast-buy": {
"type": [
"integer",
"null"
]
}
},
"description": "Present only on a get_count=true call. On the one real call observed every leaf came back JSON null (a query with no matching listings for the given filters) -- the vendor's own field names imply an integer count when populated, but a populated numeric example was never captured, so every leaf below stays nullable rather than claimed as guaranteed-integer.",
"additionalProperties": false
},
"per_page": {
"type": "integer"
},
"current_page": {
"type": "integer"
}
},
"description": "Pagination metadata plus one of data.data[] or data.count.",
"additionalProperties": false
},
"status": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The narrowed response at $.output. Listing-search calls populate data.data[]; get_count=true calls populate data.count instead -- a given call returns only one of the two.",
"additionalProperties": false
}