{"name":"com.marketcheck/api","slug":"marketcheck-api","title":"MarketCheck API","description":"MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history.","url":"https://mcp.market/server/marketcheck-api","rating":null,"grade":"C","score":67,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":8,"stars":null,"forks":null,"downloads_week":null,"last_push_at":null,"license":null},"uptime":{"percent":100,"checks":4,"ok":4,"last_checked_at":"2026-09-20T09:05:45.480Z","last_ok_at":"2026-09-20T09:05:45.480Z","latency_ms":313},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/MarketcheckHub/marketcheck-mcp-client","website":"https://developers.marketcheck.com/mcp","version":"1.2.0","remotes":[{"type":"streamable-http","url":"https://developers.marketcheck.com/api/mcp"}],"packages":[],"tools":[{"name":"decode_vin_neovin","description":"Get vehicle specifications from NeoVIN decoder by VIN.\n\nGet the basic information on specifications for a car identified by a valid VIN from NeoVIN decoder.\nThis provides detailed vehicle specifications including trim, engine, transmission, features, options,\nMSRP information, and more comprehensive data than standard VIN decoders.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"vin":{"type":"string","description":"Vehicle Identification Number (17 characters, required)"},"include_generic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include generic data in response (optional, default: False)"}},"required":["vin"],"additionalProperties":false}},{"name":"get_car_history","description":"Get a car's online listing history by VIN.\n\nThe history API returns online listing history for a car identified by its VIN.\nHistory listings are sorted in the descending order of the listing date / last seen date.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"vin":{"type":"string","description":"Vehicle Identification Number (17 characters, required)"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of fields to fetch, comma-separated (optional)"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Page number to fetch results (default is 1, optional)"},"sort_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort order - asc or desc (default is asc, optional)"}},"required":["vin"],"additionalProperties":false}},{"name":"get_server_info","description":"Get information about the server.\n\nReturns:\n Server capabilities as a dict (serialized by the transport layer)","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"get_sold_summary","description":"Get comprehensive sold vehicle summary with advanced filtering, ranking, and grouping capabilities for US market only.\nThis provides historical sales data (up to 5 years) for sold vehicles in the United States.\n\nTime period:\n- date_from: Start date for summary period, should be in YYYY-MM-DD format and first day of the month\n- date_to: End date for summary period, should be in YYYY-MM-DD format and last day of the month\n\nBasic filters:\n- inventory_type: Filter by inventory type (New, Used), defaults to New\n- dealer_type: Filter by dealer type (Franchise, Independent)\n- state: Filter by US state, should be a valid 2-letter state code (e.g., CA, TX, NY, etc.)\n\nVehicle filters:\n- make: Filter by car make (e.g., Toyota, Ford, etc.)\n- model: Filter by car model (e.g., F-150, Corolla, etc.)\n- body_type: Filter by car body type (e.g., SUV, Sedan, Pickup, Hatchback, etc.)\n- fuel_type_category: Filter by fuel type category (ICE, EV, Hybrid, Unknown, Other)\n\nDealership filters:\n- dealership_group_name: Filter by dealership group name (e.g., Lithia Motors Inc., etc.)\n\nRanking and grouping:\n- top_n: Limit the number of results returned per group, must be greater than or equal to 1\n- ranking_dimensions: Group results by summary for selected fields (comma separated). VALID VALUES ONLY: 'make', 'model', 'body_type', 'dealership_group_name'\n- ranking_measure: Measure to rank by (sold_count, average_sale_price, total_sale_price, average_days_on_market)\n- ranking_order: Order of ranking (asc, desc), defaults to desc\n- summary_by: Group results by state or city_state\n\nPagination:\n- limit: Maximum number of results to return, must be greater than or equal to 1, Max is 5000\n\nAdvanced filters (use operators like >, <, >=, <=, = followed by a number):\n- sold_count: Filter by sold count (e.g., \">100\", \"<=50\")\n- average_sale_price: Filter by average sale price (e.g., \">20000\", \"<=15000.50\")\n- total_sale_price: Filter by total sale price (e.g., \">500000\", \"<=300000.75\")\n- average_days_on_market: Filter by average days on market (e.g., \">30\", \"<=60\")\n- price_over_msrp_percentage: Filter by price over MSRP percentage (e.g., \">5\", \"<=0\")\n\nReturns:\n JSON string with sold vehicle summary results including sold count, average sale price, \n total sale price, price range, standard deviation, price over MSRP percentage, \n average MSRP, average days on market, and median days on market","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null},"inventory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dealer_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"body_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"fuel_type_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"top_n":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"ranking_dimensions":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"make,model,body_type"},"ranking_measure":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"sold_count"},"ranking_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"desc"},"summary_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"state"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":1000},"sold_count":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"average_sale_price":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"total_sale_price":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"average_days_on_market":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"price_over_msrp_percentage":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null}},"additionalProperties":false}},{"name":"predict_price_with_comparables","description":"Predict car price along with comparable vehicles in the market.\n\nThis provides predicted price, MSRP along with active set comparables to help\nunderstand market positioning and competitive pricing.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"vin":{"type":"string","description":"Vehicle Identification Number (17 characters, required)"},"miles":{"default":50000,"type":"integer","description":"Miles the vehicle has driven in total (default: 50,000)"},"dealer_type":{"default":"franchise","type":"string","description":"Filter based on dealer type (independent or franchise, default: 'franchise')"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"50501","description":"Location ZIP code (default: '50501' - Des Moines, IA)"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City of the car (optional if zip provided)"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"State of the car (optional if zip provided)"},"is_certified":{"default":false,"type":"boolean","description":"Boolean to indicate if car is certified or not (default: False)"}},"required":["vin"],"additionalProperties":false}},{"name":"search_active_cars","description":"Search for cars in the United States and Canada market with comprehensive filters.\n\nThis endpoint allows searching market vehicles that are up for sale in US and Canadian\nmarket right now. This endpoint serves only dealer listings.\n\nDO NOT USE CARFAX FIELDS: Carfax data on this server is incomplete and unreliable. Do\nNOT pass `carfax_1_owner` or `carfax_clean_title` as filters, do NOT request them in\nfacets/stats, and do NOT infer ownership history, title status, or any other meaning\nfrom any `carfax_*` value that might appear in a listing. Treat all Carfax fields as\nif they did not exist.\n\nMANDATORY TWO-STEP WORKFLOW for filtering by categorical fields. Field values in this API\nare NOT canonical English (e.g. fuel_type=\"Hybrid\" is wrong; the actual value is \"HEV\" or\n\"Electric / Unleaded\"). Skipping step 1 leads to silent zero-result responses.\n\n STEP 1 — discover valid values: call this tool with ONLY the `facets` parameter\n (and an optional location filter), rows=1, no other filters set.\n STEP 2 — filter for real: re-call with the exact strings returned in step 1.\n\nFor instance, to filter cars by powertrain in New York:\n STEP 1 call: search_active_cars(facets=\"powertrain_type\", rows=1, state=\"NY\")\n -> returns {\"powertrain_type\": [{\"item\": \"HEV\", \"count\": 18058},\n {\"item\": \"PHEV\", \"count\": 6004}, ...]}\n STEP 2 call: search_active_cars(powertrain_type=\"HEV,PHEV\", state=\"NY\")\n\nFields that REQUIRE step 1 before being used as filters: powertrain_type, fuel_type,\ntrim, body_type, drivetrain, transmission, make, model, exterior_color, interior_color.\n\nWRONG: search_active_cars(fuel_type=\"Hybrid\") # silent zero-result\nCORRECT: search_active_cars(facets=\"fuel_type\", rows=1) # discover valid values first\n then: search_active_cars(fuel_type=\"Electric / Unleaded\")\n\nDEALER FILTERING: When any of dealer_id, source, mc_website_id, mc_dealer_id, mc_location_id,\nmc_rooftop_id, mc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id,\nmc_sub_dealership_group_name, or mc_category are provided, this tool automatically routes to the\nDealer Inventory Syndication API (GET /dealerships/inventory) instead of the standard inventory\nsearch API for optimized dealer-specific inventory retrieval.\nUse search_past_90_days for expired/sold dealer inventory analysis.\n\nSTALENESS METRICS — dos_active vs dom_active (read before answering \"how long has\nthis car been for sale\" questions):\n - dos_active (Days on Site): days this listing has been active at the CURRENT\n dealer. Answers \"how long has THIS DEALER been trying to sell this car.\"\n DEFAULT: use dos_active for stale-inventory and \"how long has it been listed\"\n questions (e.g. finding dealers with stale inventory in an area).\n - dom_active (Days on Market): cumulative days the VEHICLE has been actively\n listed for sale across ALL dealers — it survives dealer-to-dealer transfers.\n Use ONLY when the question is about the vehicle's total market exposure, e.g.\n evaluating a car at auction or in a dealer trade: a car showing dos_active=15\n at the current store may show dom_active=60 because it has been passed around\n dealers for two months.\nThis rule applies to choosing filter params (dos_active_range vs dom_active_range),\nsort_by values, and which field to read and report from listing results. When\nunsure which the user means, default to dos_active.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"active_inventory_date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)"},"base_ext_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (comma-separated values)"},"base_exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (comma-separated values)"},"base_int_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (comma-separated values)"},"base_interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (comma-separated values)"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color to match (comma-separated values)"},"interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Interior color to match (comma-separated values)"},"body_subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Body subtype to filter listings on (comma-separated values)"},"body_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their body type"},"car_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car type (new/used/certified)"},"cylinders":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of engine cylinders (e.g., 4, 6, 8)"},"doors":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of doors (e.g., 2, 4)"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their drivetrain"},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their engine"},"engine_aspiration":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Aspiration to match (comma-separated values)"},"engine_block":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Block to match (comma-separated values)"},"engine_size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Size to match (comma-separated values)"},"engine_size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine size range in format \"min-max\" (e.g., \"1.0-2\")"},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their fuel type.\nWARNING: This field has many non-normalized values. RECOMMENDED: Use powertrain_type instead for reliable filtering, OR first call this tool with facets=\"fuel_type|0|1000\" to discover exact available values."},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their model"},"powertrain_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter on powertrain_type. Available values: \"Combustion\" (gas/diesel), \"HEV\" (Hybrid Electric), \"MHEV\" (Mild Hybrid), \"BEV\" (Battery Electric), \"PHEV\" (Plug-in Hybrid), \"FCEV\" (Fuel Cell Electric), \"EREV\" (Extended Range Electric).\nRECOMMENDED: Use this field instead of fuel_type for consistent and reliable filtering of vehicle power sources."},"seating_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of seats (e.g., 5, 7, 8)"},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their transmission"},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their trim"},"vehicle_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their vehicle type"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their version"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Vehicle manufacturing year (e.g., 2020, 2021)"},"year_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year range in format \"min-max\" (e.g., \"2019-2021\")"},"carfax_1_owner":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Indicates whether car has had only one owner or not"},"carfax_clean_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Indicates whether car has clean ownership records"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on City in which they are listed"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on Country in which they are listed"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude component of location"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude component of location"},"msa_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on msa code in which they are listed"},"radius":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Radius around the search location (Unit - Miles)"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on State in which they are listed"},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on ZIP around which they are listed"},"city_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City mileage range in format \"min-max\" (e.g., \"1000-5000\")"},"highway_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highway mileage range in format \"min-max\" (e.g., \"1000-5000\")"},"dom_180_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last 180 Days on Market range in format \"min-max\" (e.g., \"10-50\")"},"dom_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Cumulative days the VEHICLE has been actively listed across ALL dealers (survives dealer transfers) in format \"min-max\" (e.g., \"10-50\"). Use for total-market-exposure analysis (auction/trade evaluation); otherwise prefer dos_active_range. See STALENESS METRICS above."},"dom_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days on Market range in format \"min-max\" (e.g., \"10-50\")"},"dos_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days the listing has been active at the CURRENT dealer, in format \"min-max\" (e.g., \"10-50\"). Dealer-level staleness — DEFAULT metric for \"how long has it been for sale\" questions. See STALENESS METRICS above."},"first_seen_at_mc_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."},"first_seen_at_mc_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"},"first_seen_at_source_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."},"first_seen_at_source_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"},"first_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen days range in format \"max-min\" (e.g., \"30-10\" for 10 to 30 days ago)."},"first_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"},"last_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen days range in format \"max-min\" (e.g., \"3-1\" for 1 to 3 days ago)."},"last_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"},"dedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"If true, gives results with is_searchable irrespective of dealer_id/mc_website_id/source"},"exclude_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to exclude certified cars from search results"},"exclude_dealer_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of dealer ids to exclude from result"},"exclude_high_value_features":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to remove listings with specified excluded HVFs. Use facets=\"high_value_features|0|1000\" first to discover available feature names."},"exclude_make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of makes to exclude from result"},"exclude_mc_website_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of dealer ids to exclude from result"},"exclude_options_packages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to remove listings with specified excluded OPs. Use facets=\"options_packages|0|1000\" first to discover available package names."},"exclude_sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of sources to exclude from result"},"finance_down_payment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range down payment in finance offers"},"finance_down_payment_per":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range down payment percentage"},"finance_emp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range Estimated Monthly Payment(EMI)"},"finance_loan_apr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range loans Annual Percentage Rate"},"finance_loan_term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range finance loan term"},"include_finance":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to search for listings that include finance options"},"include_lease":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to search for listings that include leasing options"},"lease_down_payment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range down payment in lease offers"},"lease_emp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range lease Estimated Monthly Payment(EMI)"},"lease_term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Search listings with exact/range lease term"},"high_value_features":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their high_value_features (intersection of provided HVFs).\nIMPORTANT: Before using this filter, first call this tool with facets=\"high_value_features|0|1000\" to get the complete list of available high_value_features and their counts. This ensures you use exact feature names as they appear in the data."},"options_packages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their options_packages (intersection of provided OPs).\nIMPORTANT: Before using this filter, first call this tool with facets=\"options_packages|0|1000\" to get the complete list of available options packages and their counts. This ensures you use exact package names as they appear in the data."},"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their VIN"},"vins":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of 17 digit vins (max 10 VINs per request)"},"taxonomy_vins":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of 10 letters excerpt from 17 letter VIN"},"mm":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make-Model concatenated string from auto-complete API"},"ymm":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year-Make-Model concatenated string from auto-complete API"},"ymmt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of Year|Make|Model|Trim combinations"},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of Year,Make,Model,Trim fields for exact match with vins"},"in_transit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to filter in transit vehicles"},"include_non_vin_listings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Include non vin listings (default false)"},"include_preferred_dealer_flag":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Flag to add preferred dealers flag based on client filter score"},"include_relevant_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Include relevant links (default true)"},"inventory_count_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Inventory count range for total listings in dealers inventory"},"min_photo_links":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings by number of photo links within given range"},"min_photo_links_cached":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings by number of cached photo links within range"},"nodedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"If true, API gives results without is_searchable (multiple listings for single vin)"},"owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"When true, returns listings actually owned by dealer (used with dealer_id/mc_website_id/source)"},"photo_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings that have photo_links"},"photo_links_cached":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings that have photo_links_cached"},"plot":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"If true, results in around 25k coordinates with limited fields for plotting"},"preferred_dealers":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Flag to add preferred dealers flag based on client filter score"},"preferred_dealers_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Flag to show only preferred dealers listings"},"price_change":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Query to filter listings based on positive and negative price change"},"price_change_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price change range in format \"min-max\" (e.g., \"10-500\")"},"price_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price range in format \"min-max\" (e.g., \"1000-5000\")"},"msrp_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MSRP range in format \"min-max\" (e.g., \"1000-5000\")"},"miles_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Miles range in format \"min-max\" (e.g., \"1000-5000\")"},"dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer ID filter to search inventory from specific dealer"},"dealer_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Type of dealer (e.g., franchise, independent)"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source filter to search inventory from specific source"},"stock_no":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their stock number on lot"},"vdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter based on vehicle detail page URL"},"mc_website_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck website ID filter"},"mc_dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck dealer ID filter"},"mc_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck location ID filter"},"mc_rooftop_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck rooftop ID filter"},"mc_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck dealership group ID filter"},"mc_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck dealership group name filter"},"mc_sub_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck sub-dealership group ID filter"},"mc_sub_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck sub-dealership group name filter"},"mc_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\""},"facet_sort":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Controls sort order of facet terms:\n- count (default): Sort by frequency (highest first)\n- index: Sort alphabetically"},"facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution.\nSyntax: facets=field_name|offset|limit|min_count\n- offset (default: 0): Start position for terms\n- limit (default: 20, max: 1000): Number of terms to return\n- min_count (optional): Minimum count for a term to be included\nExample: facets=make|0|60|2 returns top 60 makes with at least 2 listings each"},"range_facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of numeric fields for range facets"},"stats":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of fields for which stats need to be generated"},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort by field (dist|price|miles|msrp|dom|dom_180|dom_active|dos_active|highway_mpg|city_mpg|last_seen|first_seen|lease_term|lease_emp|lease_down_payment|finance_loan_term|finance_loan_apr|finance_emp|finance_down_payment|price_change_percent). For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."},"sort_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"asc","description":"Sort order (asc|desc)"},"rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":5,"description":"Number of results to return. For standard searches: default 5, max 50. For dealer/syndication searches (when dealer_id, mc_dealer_id, mc_location_id, or similar dealer identifiers are provided): defaults to 1500 (full inventory), max 1500."},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"description":"Page number/offset to fetch results (default 0, max depends on package)"},"seller_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"dealer","description":"Filter by seller type. Only 3 strict values allowed: \"dealer\" (default), \"fsbo\" (private seller), \"auction\""},"fetch_all_photos":{"default":false,"type":"boolean","description":"When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."},"include_dealer_object":{"default":false,"type":"boolean","description":"When True, includes dealer object in response. Dealer object structure:\n- id (number): Unique dealer identifier\n- website (string): Dealer website URL\n- name (string): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- dealership_group_name (string, optional): Parent dealership group\n- msa_code (string, optional): Metropolitan Statistical Area code"},"include_mc_dealership_object":{"default":false,"type":"boolean","description":"When True, includes mc_dealership object in response. McDealership object structure:\n- mc_website_id (number, optional): MarketCheck website identifier\n- mc_dealer_id (number, optional): MarketCheck dealer identifier\n- mc_location_id (number, optional): MarketCheck location identifier\n- mc_rooftop_id (number, optional): MarketCheck rooftop identifier\n- mc_dealership_group_id (number, optional): MarketCheck dealership group identifier\n- mc_dealership_group_name (string, optional): MarketCheck dealership group name\n- mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier\n- mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name\n- mc_category (string, optional): MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\"\n- website (string, optional): Dealer website URL\n- name (string, optional): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- msa_code (string, optional): Metropolitan Statistical Area code\n- phone (string, optional): Contact phone number"},"include_build_object":{"default":false,"type":"boolean","description":"When True, includes build object in response. Build object structure:\n- year (number): Model year\n- make (string): Vehicle manufacturer\n- model (string, optional): Vehicle model\n- trim (string, optional): Trim level\n- version (string, optional): Specific version/variant\n- body_type (string, optional): Body style (sedan, SUV, truck, etc.)\n- vehicle_type (string, optional): Vehicle category\n- transmission (string, optional): Transmission type\n- drivetrain (string, optional): Drivetrain configuration\n- fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\n- engine_block (string, optional): Engine block configuration\n- doors (number, optional): Number of doors\n- cylinders (number, optional): Number of cylinders\n- made_in (string, optional): Manufacturing country\n- overall_height, overall_length, overall_width (string, optional): Vehicle dimensions\n- std_seating (string, optional): Standard seating capacity\n- highway_mpg (number, optional): Highway fuel economy\n- city_mpg (number, optional): City fuel economy\n- powertrain_type (string, optional): Powertrain classification"}},"additionalProperties":false}},{"name":"search_past_90_days","description":"Search for recent car inventory (EXPIRED/SOLD listings from last 90 days) with comprehensive filters following Marketcheck API structure.\n\nIMPORTANT: This endpoint serves ONLY expired/sold listings from the last 90 days for US and CA (Canada) markets, NOT active listings.\nFor currently active listings, use the search_active_cars tool instead.\n\nDO NOT USE CARFAX FIELDS: Carfax data on this server is incomplete and unreliable. Do\nNOT pass `carfax_1_owner` or `carfax_clean_title` as filters, do NOT request them in\nfacets/stats, and do NOT infer ownership history, title status, or any other meaning\nfrom any `carfax_*` value that might appear in a listing. Treat all Carfax fields as\nif they did not exist.\n\nIMPORTANT: Before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.),\nuse the 'facets' parameter to discover available values in the API. Field values may be\nrepresented differently than expected. For example:\n- Use facets=\"make,model,trim,body_type\" to see all available options\n- This prevents filtering errors due to incorrect field value assumptions\n- Facets show actual data distribution and available filter options\n\nVIN vs Listing ID Disclaimer:\n- A single VIN can have multiple listings, each with a unique listing ID\n- Listing ID changes when there are changes in price or miles of the listing\n- When expired=false is set, it shows listings for VINs that are currently active in the market (not sold yet), \n but the specific listing is expired. The latest/current listing for that VIN is present in the active search API\n- This endpoint shows historical listing data (expired listing IDs) for market analysis, not current inventory\n\nThis endpoint is designed for analytical use cases including:\n- Historical market analysis of sold vehicles\n- Sold vehicle pricing trends and patterns\n- Days on market analysis for expired listings \n- Dealer inventory turnover and sales analysis\n- Market intelligence from recently sold inventory\n\nKey use cases:\n- Analyze recent sales trends and pricing\n- Get sold/expired listings for market intelligence \n- Calculate average market prices from recent inventory\n- Track dealer inventory turnover patterns\n\nDue to performance reasons, this endpoint is more restrictive than active search:\n- Does not accept facets, stats and range_facets in a single call\n- Requires one of: city, state, zip, (latitude+longitude+radius), source, or dealer_id\n- For geo queries, radius cannot be greater than 100 miles\n- Charged at higher rates than active search endpoint\n\nSTALENESS METRICS — dos_active vs dom_active (read before answering \"how long was\nthis car for sale\" questions):\n - dos_active (Days on Site): days the listing was active at the CURRENT dealer.\n Answers \"how long did THIS DEALER try to sell this car.\" DEFAULT: use\n dos_active for stale-inventory and \"how long was it listed\" questions.\n - dom_active (Days on Market): cumulative days the VEHICLE was actively listed\n across ALL dealers — it survives dealer-to-dealer transfers. Use ONLY when the\n question is about the vehicle's total market exposure, e.g. evaluating a car\n at auction or in a dealer trade: a car showing dos_active=15 at the current\n store may show dom_active=60 because it was passed around dealers for two months.\nThis rule applies to choosing filter params (dos_active_range vs dom_active_range),\nsort_by values, and which field to read and report from listing results. When\nunsure which the user means, default to dos_active.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"active_inventory_date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)"},"base_ext_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"base_exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (comma-separated values)"},"base_int_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"base_interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (comma-separated values)"},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color to match (comma-separated values)"},"interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Interior color to match (comma-separated values)"},"body_subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"body_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their body type"},"car_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car type (new/used/certified)"},"cylinders":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of engine cylinders (e.g., 4, 6, 8)"},"doors":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of doors (e.g., 2, 4)"},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"engine_aspiration":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"engine_block":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"engine_size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"engine_size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their fuel type.\nWARNING: This field has many non-normalized values. First call this tool with facets=\"fuel_type|0|1000\" to discover exact available values before filtering."},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on their model"},"seating_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of seats (e.g., 5, 7, 8)"},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their trim"},"vehicle_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Vehicle manufacturing year (e.g., 2020, 2021)"},"year_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year range in format \"min-max\" (e.g., \"2019-2021\")"},"carfax_1_owner":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"carfax_clean_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on City in which they are listed"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude component of location"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude component of location"},"msa_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"radius":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Radius around the search location (Unit - Miles, max 100)"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on State in which they are listed "},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on ZIP around which they are listed"},"city_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"highway_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dom_180_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dom_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Cumulative days the VEHICLE was actively listed across ALL dealers (survives dealer transfers) in format \"min-max\" (e.g., \"10-50\"). Use for total-market-exposure analysis (auction/trade evaluation); otherwise prefer dos_active_range. See STALENESS METRICS above."},"dom_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days on Market range in format \"min-max\" (e.g., \"10-50\")"},"dos_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days the listing was active at the CURRENT dealer, in format \"min-max\" (e.g., \"10-50\"). Dealer-level staleness — DEFAULT metric for \"how long was it for sale\" questions. See STALENESS METRICS above."},"first_seen_at_mc_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."},"first_seen_at_mc_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC date range in format YYYYMMDD-YYYYMMDD"},"first_seen_at_source_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."},"first_seen_at_source_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source date range in format YYYYMMDD-YYYYMMDD"},"first_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen days range in format \"max-min\" (e.g., \"30-10\" for 10 to 30 days ago)."},"first_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen date range in format YYYYMMDD-YYYYMMDD"},"last_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen days range in format \"max-min\" (e.g., \"3-1\" for 1 to 3 days ago)."},"last_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen date range in format YYYYMMDD-YYYYMMDD"},"dedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"exclude_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"exclude_dealer_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"exclude_make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"exclude_mc_website_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"exclude_sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"expired":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to fetch only expired listings or active ones (True/False)"},"finance_down_payment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"finance_down_payment_per":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"finance_emp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"finance_loan_apr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"finance_loan_term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"include_finance":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"include_lease":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"lease_down_payment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"lease_emp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"lease_term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"vins":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"taxonomy_vins":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"ymmt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer id to filter the listings"},"dealer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dealer_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"in_transit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to filter in transit vehicles (True/False)"},"include_non_vin_listings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include non vin listings (True/False, default False)"},"include_relevant_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"mc_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\""},"mc_dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_rooftop_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_sub_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_sub_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mc_website_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"nodedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean, when True returns listings actually owned by dealer (used with dealer_id/source)"},"photo_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"photo_links_cached":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"plot":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"sold":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to fetch only sold/expired listings (True/False)"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listing on their source"},"stock_no":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"vdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"price_change_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"price_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price range in format \"min-max\" (e.g., \"1000-5000\")"},"msrp_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MSRP range in format \"min-max\" (e.g., \"1000-5000\")"},"miles_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Miles range in format \"min-max\" (e.g., \"1000-5000\")"},"facet_sort":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution.\nSyntax: facets=field_name|offset|limit|min_count (single field only)\n- offset (default: 0): Start position for terms\n- limit (default: 20, max: 1000): Number of terms to return\n- min_count (optional): Minimum count for a term to be included\nExample: facets=make|0|60|2 returns top 60 makes with at least 2 listings each"},"range_facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Numeric field for range facets (single field only)"},"stats":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Field for which stats need to be generated (single field only)"},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort by field (dist|price|miles|msrp|dom|dom_active|dos_active|last_seen|first_seen, etc.). For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."},"sort_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"asc","description":"Sort order (asc|desc)"},"rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":5,"description":"Number of results to return (default 5, max 50)"},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"description":"Page number/offset to fetch results (default 0)"},"fetch_all_photos":{"default":false,"type":"boolean","description":"When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."},"include_dealer_object":{"default":false,"type":"boolean","description":"When True, includes dealer object in response. Dealer object structure:\n- id (number): Unique dealer identifier\n- website (string): Dealer website URL\n- name (string): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- dealership_group_name (string, optional): Parent dealership group\n- msa_code (string, optional): Metropolitan Statistical Area code"},"include_mc_dealership_object":{"default":false,"type":"boolean","description":"When True, includes mc_dealership object in response. McDealership object structure:\n- mc_website_id (number, optional): MarketCheck website identifier\n- mc_dealer_id (number, optional): MarketCheck dealer identifier\n- mc_location_id (number, optional): MarketCheck location identifier\n- mc_rooftop_id (number, optional): MarketCheck rooftop identifier\n- mc_dealership_group_id (number, optional): MarketCheck dealership group identifier\n- mc_dealership_group_name (string, optional): MarketCheck dealership group name\n- mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier\n- mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name\n- mc_category (string, optional): MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\"\n- website (string, optional): Dealer website URL\n- name (string, optional): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- msa_code (string, optional): Metropolitan Statistical Area code\n- phone (string, optional): Contact phone number"},"include_build_object":{"default":false,"type":"boolean","description":"When True, includes build object in response. Build object structure:\n- year (number): Model year\n- make (string): Vehicle manufacturer\n- model (string, optional): Vehicle model\n- trim (string, optional): Trim level\n- version (string, optional): Specific version/variant\n- body_type (string, optional): Body style (sedan, SUV, truck, etc.)\n- vehicle_type (string, optional): Vehicle category\n- transmission (string, optional): Transmission type\n- drivetrain (string, optional): Drivetrain configuration\n- fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\n- engine_block (string, optional): Engine block configuration\n- doors (number, optional): Number of doors\n- cylinders (number, optional): Number of cylinders\n- made_in (string, optional): Manufacturing country\n- overall_height, overall_length, overall_width (string, optional): Vehicle dimensions\n- std_seating (string, optional): Standard seating capacity\n- highway_mpg (number, optional): Highway fuel economy\n- city_mpg (number, optional): City fuel economy"}},"additionalProperties":false}},{"name":"search_uk_active_cars","description":"Search for active cars in the UK market.\n\nThis tool searches for currently active car listings in the UK using the Marketcheck API.\nIt supports comprehensive filtering by location, vehicle specifications, price, and more.\nIncludes all parameters supported by the /search/car/uk/active endpoint.\n\nDO NOT USE CARFAX FIELDS: Carfax data on this server is incomplete and unreliable. Do\nNOT pass `carfax_1_owner` or `carfax_clean_title` (via kwargs or otherwise) as filters,\ndo NOT request them in facets/stats, and do NOT infer ownership history, title status,\nor any other meaning from any `carfax_*` value that might appear in a listing. Treat\nall Carfax fields as if they did not exist.\n\nIMPORTANT: Before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.),\nuse the 'facets' parameter to discover available values in the API. Field values may be\nrepresented differently than expected. For example:\n- Use facets=\"make,model,trim,body_type\" to see all available options\n- This prevents filtering errors due to incorrect field value assumptions\n- Facets show actual data distribution and available filter options\n\nSTALENESS METRICS — dos_active vs dom_active (read before answering \"how long has\nthis car been for sale\" questions):\n - dos_active (Days on Site): days this listing has been active at the CURRENT\n dealer. Answers \"how long has THIS DEALER been trying to sell this car.\"\n DEFAULT: use dos_active for stale-inventory and \"how long has it been listed\"\n questions.\n - dom_active (Days on Market): cumulative days the VEHICLE has been actively\n listed for sale across ALL dealers — it survives dealer-to-dealer transfers.\n Use ONLY when the question is about the vehicle's total market exposure, e.g.\n evaluating a car at auction or in a dealer trade: a car showing dos_active=15\n at the current store may show dom_active=60 because it has been passed around\n dealers for two months.\nThis rule applies to choosing filter params (dos_active_range vs dom_active_range),\nsort_by values, and which field to read and report from listing results. When\nunsure which the user means, default to dos_active.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude component of location (range: -90 to 90)."},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude component of location (range: -180 to 180)."},"radius":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Radius around the search location in miles (max: 7000)."},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on postal code around which they are listed."},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on ZIP around which they are listed."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on City in which they are listed."},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on county in which they are listed."},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on State in which they are listed."},"car_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car type. Allowed values are - new / used."},"year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their year (comma-separated values)."},"year_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year range to filter listings (format: min-max e.g. 2019-2021)."},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their make (comma-separated values)."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their model (comma-separated values)."},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their variant (comma-separated values)."},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their trim (comma-separated values)."},"body_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their body type (comma-separated values)."},"ymmt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of Year, Make, Model, Trim combinations."},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their transmission (comma-separated values)."},"doors":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Doors to filter the cars on (comma-separated integer values)."},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their drivetrain (comma-separated values)."},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their engine (comma-separated values)."},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their fuel type (comma-separated values)."},"cylinders":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their cylinders (comma-separated values)."},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color to match (comma-separated values from facets API)."},"interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Interior color to match (comma-separated values from facets API)."},"base_exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (comma-separated values)."},"base_interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (comma-separated values)."},"base_ext_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (alias for base_exterior_color)."},"base_int_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (alias for base_interior_color)."},"miles_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Miles range to filter listings (format: min-max e.g. 1000-5000)."},"price_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price range to filter listings (format: min-max e.g. 1000-5000)."},"msrp_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MSRP range to filter listings (format: min-max e.g. 1000-5000)."},"price_change":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price change filter for listings."},"price_change_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price change range to filter listings."},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."},"sort_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort order - asc or desc. Default sort order is asc."},"rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of results to return. Default is 10. Max is 50."},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Page number to fetch results. Default is 0. Max pagination: 10000."},"facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution.\nSyntax: facets=field_name|offset|limit|min_count\n- offset (default: 0): Start position for terms\n- limit (default: 20, max: 1000): Number of terms to return\n- min_count (optional): Minimum count for a term to be included\nExample: facets=make|0|60|2 returns top 60 makes with at least 2 listings each"},"range_facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of numeric fields for range facets."},"facet_sort":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Controls sort order of facet terms:\n- count (default): Sort by frequency (highest first)\n- index: Sort alphabetically"},"stats":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of fields for which stats need to be generated."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on Country (uk, england, scotland, northern ireland, wales)."},"plot":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"If true, results in around 25k coordinates with limited fields to plot."},"nodedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"If true, API will give results without is_searchable."},"dedup":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"If true, will give results with is_searchable irrespective of dealer."},"co2_emissions":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CO2 emissions filter (comma-separated values)."},"insurance_group":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Insurance group filter for UK vehicles."},"vehicle_registration_mark":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle Registration Mark filter."},"vehicle_registration_date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle registration date range (YYYYMMDD-YYYYMMDD)."},"num_owners":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Number of owners filter."},"fca_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter on fca status."},"seating_capacity":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter on vehicle seating capacity."},"vrm":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle Registration Mark (VRM) filter."},"write_off_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Write off category filter."},"exclude_write_off_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To exclude write off category."},"ulez_compliant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter for ULEZ compliant vehicles."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their source (comma-separated URLs)."},"dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer id to filter the listings."},"exclude_sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of sources to exclude from result."},"exclude_dealer_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of dealer ids to exclude from result."},"exclude_mc_website_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of MC website ids to exclude from result."},"dealer_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter based on dealer type (franchise or independent)."},"mc_website_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Website id to filter the listings."},"mc_dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealer_id."},"mc_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_location_id."},"mc_rooftop_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_rooftop_id."},"mc_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealership_group_id."},"mc_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealership_group_name."},"mc_sub_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_sub_dealership_group_id."},"mc_sub_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_sub_dealership_group_name."},"mc_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter based on mc_category (Dealer, Dealership Group, etc.)."},"stock_no":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their stock number on lot."},"inventory_count_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Inventory count range to filter listings (min-max format)."},"include_non_vin_listings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"To include non vin listings. Default is false."},"dom_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days on Market range to filter cars (format: min-max e.g. 10-50)."},"dom_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Cumulative days the VEHICLE has been actively listed across ALL dealers (survives dealer transfers), format min-max. Use for total-market-exposure analysis; otherwise prefer dos_active_range. See STALENESS METRICS above."},"dom_180_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last 180 Days on Market range to filter cars."},"dos_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days the listing has been active at the CURRENT dealer, format min-max. Dealer-level staleness — DEFAULT metric for \"how long has it been for sale\" questions. See STALENESS METRICS above."},"last_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen date range (YYYYMMDD-YYYYMMDD format)."},"first_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen date range (YYYYMMDD-YYYYMMDD format)."},"first_seen_at_source_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source date range."},"first_seen_at_mc_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC date range."},"last_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen days range in format \"max-min\" (e.g., \"3-1\" for 1 to 3 days ago)."},"first_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen days range in format \"max-min\" (e.g., \"30-10\" for 10 to 30 days ago)."},"first_seen_at_source_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source days range in format \"max-min\" (e.g., \"15-5\")."},"first_seen_at_mc_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC days range in format \"max-min\" (e.g., \"15-5\")."},"active_inventory_date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Active inventory date range filter."},"photo_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings that have photo_links."},"photo_links_cached":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings with cached photo_links."},"min_photo_links":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum number of photo links required."},"min_photo_links_cached":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum number of cached photo links required."},"vdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle details page URL filter."},"engine_size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Size to match (comma-separated values from facets API)."},"engine_size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine size range filter."},"highway_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highway mileage range (min-max format e.g. 1000-5000)."},"city_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City mileage range (min-max format e.g. 1000-5000)."},"combined_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Combined mileage range for UK (min-max format)."},"performance_co2_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Performance CO2 range filter."},"ev_battery_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Electric vehicle battery type filter."},"ev_battery_capacity_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"EV battery capacity range filter."},"ev_vehicle_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Electric vehicle range filter."},"car_location_seller_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car location seller name filter."},"car_location_street":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car location street filter."},"car_location_city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car location city filter."},"car_location_county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car location county filter."},"car_location_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car location ZIP filter."},"car_location_latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Car location latitude coordinate."},"car_location_longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Car location longitude coordinate."},"exclude_make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make values to exclude from results."},"preferred_dealers":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Preferred dealers filter."},"include_preferred_dealer_flag":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Include preferred dealer flag."},"preferred_dealers_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Filter to show only preferred dealers."},"model_variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model variant filter."},"is_vat_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean filter for VAT inclusion."},"uvc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UVC (Universal Vehicle Code) ID filter."},"owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"When used with dealer_id, returns listings owned by dealer."},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of fields for exact match."},"vehicle_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their vehicle type."},"wheelbase_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their wheelbase category."},"fetch_all_photos":{"default":false,"type":"boolean","description":"When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."},"include_dealer_object":{"default":false,"type":"boolean","description":"When True, includes dealer object in response. Dealer object structure:\n- id (number): Unique dealer identifier\n- website (string): Dealer website URL\n- name (string): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- fca_status (string, optional): FCA authorization status\n- preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer"},"include_mc_dealership_object":{"default":false,"type":"boolean","description":"When True, includes mc_dealership object in response. McDealership object structure:\n- mc_website_id (number, optional): MarketCheck website identifier\n- mc_dealer_id (number, optional): MarketCheck dealer identifier\n- mc_location_id (number, optional): MarketCheck location identifier\n- mc_rooftop_id (number, optional): MarketCheck rooftop identifier\n- mc_dealership_group_id (number, optional): MarketCheck dealership group identifier\n- mc_dealership_group_name (string, optional): MarketCheck dealership group name\n- mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier\n- mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name\n- mc_category (string, optional): MarketCheck seller category. UK market only supports: dealer\n- website (string, optional): Dealer website URL\n- name (string, optional): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- fca_status (string, optional): FCA authorization status"},"include_build_object":{"default":false,"type":"boolean","description":"When True, includes build object in response. Build object structure:\n- year (number): Model year\n- make (string): Vehicle manufacturer\n- model (string, optional): Vehicle model\n- model_variant (string, optional): Vehicle model variant\n- trim (string, optional): Trim level\n- variant (string, optional): Specific variant identifier\n- body_type (string, optional): Body style (saloon, hatchback, estate, etc.)\n- vehicle_type (string, optional): Vehicle category\n- transmission (string, optional): Transmission type\n- drivetrain (string, optional): Drivetrain configuration\n- fuel_type (string, optional): Fuel type (petrol, diesel, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\n- doors (number, optional): Number of doors\n- cylinders (number, optional): Number of cylinders\n- made_in (string, optional): Manufacturing country\n- overall_height, overall_length, overall_width (string, optional): Vehicle dimensions\n- wheelbase_category (string, optional): Wheelbase classification\n- std_seating (string, optional): Standard seating capacity\n- highway_mpg (number, optional): Highway fuel economy\n- city_mpg (number, optional): City fuel economy\n- combined_mpg (number, optional): Combined fuel economy\n- seating_capacity (number, optional): Passenger seating capacity\n- performance_torque_ftlb (number, optional): Torque in foot-pounds\n- performance_maxspeed_mph (number, optional): Maximum speed in miles per hour\n- performance_torque_rpm (number, optional): Torque at RPM\n- performance_power_bhp (number, optional): Power in brake horsepower\n- performance_power_rpm (number, optional): Power at RPM\n- performance_torque_nm (number, optional): Torque in Newton-meters\n- performance_power_kw (number, optional): Power in kilowatts\n- performance_co2 (number, optional): CO2 emissions rating\n- euro_status (number, optional): Euro emissions standard status"}},"additionalProperties":false}},{"name":"search_uk_recent_cars","description":"Search for recent/expired cars in the UK market (last 90 days).\n\nThis tool searches recent inventory data for EXPIRED/SOLD listings only.\nIt does NOT include active listings - use search_uk_active_cars for current inventory.\n\nDO NOT USE CARFAX FIELDS: Carfax data on this server is incomplete and unreliable. Do\nNOT pass `carfax_1_owner` or `carfax_clean_title` (via kwargs or otherwise) as filters,\ndo NOT request them in facets/stats, and do NOT infer ownership history, title status,\nor any other meaning from any `carfax_*` value that might appear in a listing. Treat\nall Carfax fields as if they did not exist.\n\nIMPORTANT: Before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.),\nuse the 'facets' parameter to discover available values in the API. Field values may be\nrepresented differently than expected. For example:\n- Use facets=\"make,model,trim,body_type\" to see all available options\n- This prevents filtering errors due to incorrect field value assumptions\n- Facets show actual data distribution and available filter options\n\nSTALENESS METRICS — dos_active vs dom_active (read before answering \"how long was\nthis car for sale\" questions):\n - dos_active (Days on Site): days the listing was active at the CURRENT dealer.\n Answers \"how long did THIS DEALER try to sell this car.\" DEFAULT: use\n dos_active for stale-inventory and \"how long was it listed\" questions.\n - dom_active (Days on Market): cumulative days the VEHICLE was actively listed\n across ALL dealers — it survives dealer-to-dealer transfers. Use ONLY when the\n question is about the vehicle's total market exposure, e.g. evaluating a car\n at auction or in a dealer trade: a car showing dos_active=15 at the current\n store may show dom_active=60 because it was passed around dealers for two months.\nThis rule applies to choosing filter params (dos_active_range vs dom_active_range),\nsort_by values, and which field to read and report from listing results. When\nunsure which the user means, default to dos_active.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude component of location (range: -90 to 90)."},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude component of location (range: -180 to 180)."},"radius":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Radius around the search location in miles (max: 100 for recent search)."},"zip":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on ZIP around which they are listed."},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on postal code around which they are listed."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on City in which they are listed."},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on county in which they are listed."},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on State in which they are listed."},"car_include_lease":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to search for listings that include leasing options."},"car_include_finance":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to search for listings that include finance options."},"lease_term":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with exact lease term, or range (min-max e.g. 30-60)."},"lease_down_payment":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with exact down payment in lease offers or range."},"lease_emp":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with lease Estimated Monthly Payment (EMI) or range."},"finance_loan_term":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with exact finance loan term or range."},"finance_loan_apr":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Search listings with finance Annual Percentage Rate or range."},"finance_emp":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with finance Estimated Monthly Payment (EMI) or range."},"finance_down_payment":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Search listings with exact down payment in finance offers or range."},"finance_down_payment_per":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Search listings with exact down payment percentage or range."},"car_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Car type. Allowed values are - new / used / certified."},"year_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year range to filter listings (format: min-max e.g. 2019-2021)."},"year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their year (comma-separated values)."},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their make (comma-separated values)."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their model (comma-separated values)."},"trim":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their trim (comma-separated values)."},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their variant (comma-separated values)."},"body_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their body type (comma-separated values)."},"body_subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Body subtype to filter listings (comma-separated values from facets API)."},"vehicle_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their vehicle type (comma-separated values)."},"wheelbase_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their wheelbase category."},"ymmt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of Year, Make, Model, Trim combinations."},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of fields for exact match (e.g., year,make,model,trim)."},"cylinders":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"To filter listing on their cylinders (comma-separated values)."},"transmission":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their transmission (comma-separated values)."},"doors":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Doors to filter the cars on (comma-separated integer values)."},"drivetrain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their drivetrain (comma-separated values)."},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their engine (comma-separated values)."},"engine_size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Size to match (comma-separated values from facets API)."},"engine_size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine size range filter (min-max format)."},"engine_aspiration":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Aspiration to match (comma-separated values from facets)."},"engine_block":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Engine Block to match (comma-separated values from facets)."},"fuel_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their fuel type (comma-separated values)."},"exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Exterior color to match (comma-separated values from facets API)."},"interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Interior color to match (comma-separated values from facets API)."},"base_exterior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (comma-separated values)."},"base_interior_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (comma-separated values)."},"base_ext_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base exterior color to match (alias for base_exterior_color)."},"base_int_color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base interior color to match (alias for base_interior_color)."},"miles_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Miles range to filter listings (format: min-max e.g. 1000-5000)."},"price_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price range to filter listings (format: min-max e.g. 1000-5000)."},"msrp_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"MSRP range to filter listings (format: min-max e.g. 1000-5000)."},"price_change_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Price change range to filter listings."},"highway_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highway mileage range for UK (min-max format e.g. 1000-5000)."},"city_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City mileage range for UK (min-max format e.g. 1000-5000)."},"combined_mpg_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Combined mileage range for UK (min-max format)."},"ulez_compliant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter for ULEZ compliant vehicles."},"dom_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days on Market range to filter cars (format: min-max e.g. 10-50)."},"dom_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Cumulative days the VEHICLE was actively listed across ALL dealers (survives dealer transfers), format min-max. Use for total-market-exposure analysis; otherwise prefer dos_active_range. See STALENESS METRICS above."},"dom_180_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last 180 Days on Market range to filter cars."},"dos_active_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Days the listing was active at the CURRENT dealer, format min-max. Dealer-level staleness — DEFAULT metric for \"how long was it for sale\" questions. See STALENESS METRICS above."},"last_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen date range (YYYYMMDD-YYYYMMDD format)."},"first_seen_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen date range (YYYYMMDD-YYYYMMDD format)."},"first_seen_at_source_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source date range."},"first_seen_at_mc_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC date range."},"last_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last seen days range in format \"max-min\" (e.g., \"3-1\" for 1 to 3 days ago)."},"first_seen_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen days range in format \"max-min\" (e.g., \"30-10\" for 10 to 30 days ago)."},"first_seen_at_source_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at source days range in format \"max-min\" (e.g., \"15-5\")."},"first_seen_at_mc_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First seen at MC days range in format \"max-min\" (e.g., \"15-5\")."},"active_inventory_date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Active inventory date range filter."},"dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dealer id to filter the listings."},"dealer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter listings on dealer_name."},"dealer_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter based on dealer type (franchise or independent)."},"dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Name of the dealership group to search for."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their source (comma-separated URLs)."},"exclude_dealer_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of dealer ids to exclude from result."},"exclude_mc_website_ids":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of MC website ids to exclude from result."},"exclude_sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A list of sources to exclude from result."},"mc_website_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Website id to filter the listings."},"mc_dealer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealer_id."},"mc_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_location_id."},"mc_rooftop_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_rooftop_id."},"mc_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealership_group_id."},"mc_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_dealership_group_name."},"mc_sub_dealership_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_sub_dealership_group_id."},"mc_sub_dealership_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listings on their mc_sub_dealership_group_name."},"mc_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter based on mc_category (Dealer, Dealership Group, etc.)."},"insurance_group":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Insurance group filter for UK vehicles."},"vrm":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle Registration Mark (VRM) filter."},"num_owners":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Number of owners filter."},"write_off_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Write off category filter."},"exclude_write_off_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To exclude write off category."},"fca_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter on fca status."},"seating_capacity":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter on vehicle seating capacity."},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."},"sort_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort order - asc or desc. Default sort order is asc."},"rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of results to return. Default is 10. Max is 50."},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Page number to fetch results. Default is 0. Max pagination: 10000."},"include_non_vin_listings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"To include non vin listings. Default is false."},"facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution.\nSyntax: facets=field_name|offset|limit|min_count\n- offset (default: 0): Start position for terms\n- limit (default: 20, max: 1000): Number of terms to return\n- min_count (optional): Minimum count for a term to be included\nExample: facets=make|0|60|2 returns top 60 makes with at least 2 listings each"},"range_facets":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma separated list of numeric fields for range facets."},"facet_sort":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Controls sort order of facet terms:\n- count (default): Sort by frequency (highest first)\n- index: Sort alphabetically"},"stats":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"List of fields for which stats need to be generated."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on Country (uk, england, scotland, northern ireland, wales)."},"plot":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"If true, results in around 25k coordinates with limited fields to plot."},"nodedup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"If true, API will give results without is_searchable."},"dedup":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"If true, will give results with is_searchable irrespective of dealer."},"owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"When used with dealer_id, returns listings owned by dealer."},"exclude_certified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean param to exclude certified cars from search results."},"photo_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings that have photo_links."},"photo_links_cached":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean to include only listings with cached photo_links."},"stock_no":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"To filter listing on their stock number on lot."},"sold":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean parameter to fetch only sold listings."},"include_relevant_links":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"To include_relevant_links. Default is true."},"expired":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean flag to either fetch only the expired listings or active ones."},"exclude_make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make values to exclude from results."},"model_variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model variant filter."},"is_vat_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Boolean filter for VAT inclusion."},"vdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Vehicle details page URL filter."},"fetch_all_photos":{"default":false,"type":"boolean","description":"When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."},"include_dealer_object":{"default":false,"type":"boolean","description":"When True, includes dealer object in response. Dealer object structure:\n- id (number): Unique dealer identifier\n- website (string): Dealer website URL\n- name (string): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- fca_status (string, optional): FCA authorization status\n- preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer"},"include_mc_dealership_object":{"default":false,"type":"boolean","description":"When True, includes mc_dealership object in response. McDealership object structure:\n- mc_website_id (number, optional): MarketCheck website identifier\n- mc_dealer_id (number, optional): MarketCheck dealer identifier\n- mc_location_id (number, optional): MarketCheck location identifier\n- mc_rooftop_id (number, optional): MarketCheck rooftop identifier\n- mc_dealership_group_id (number, optional): MarketCheck dealership group identifier\n- mc_dealership_group_name (string, optional): MarketCheck dealership group name\n- mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier\n- mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name\n- mc_category (string, optional): MarketCheck seller category. UK market only supports: dealer\n- website (string, optional): Dealer website URL\n- name (string, optional): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- fca_status (string, optional): FCA authorization status"},"include_build_object":{"default":false,"type":"boolean","description":"When True, includes build object in response. Build object structure:\n- year (number): Model year\n- make (string): Vehicle manufacturer\n- model (string, optional): Vehicle model\n- model_variant (string, optional): Vehicle model variant\n- trim (string, optional): Trim level\n- variant (string, optional): Specific variant identifier\n- body_type (string, optional): Body style (saloon, hatchback, estate, etc.)\n- vehicle_type (string, optional): Vehicle category\n- transmission (string, optional): Transmission type\n- drivetrain (string, optional): Drivetrain configuration\n- fuel_type (string, optional): Fuel type (petrol, diesel, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\n- doors (number, optional): Number of doors\n- cylinders (number, optional): Number of cylinders\n- made_in (string, optional): Manufacturing country\n- overall_height, overall_length, overall_width (string, optional): Vehicle dimensions\n- wheelbase_category (string, optional): Wheelbase classification\n- std_seating (string, optional): Standard seating capacity\n- highway_mpg (number, optional): Highway fuel economy\n- city_mpg (number, optional): City fuel economy\n- combined_mpg (number, optional): Combined fuel economy\n- seating_capacity (number, optional): Passenger seating capacity\n- performance_torque_ftlb (number, optional): Torque in foot-pounds\n- performance_maxspeed_mph (number, optional): Maximum speed in miles per hour\n- performance_torque_rpm (number, optional): Torque at RPM\n- performance_power_bhp (number, optional): Power in brake horsepower\n- performance_power_rpm (number, optional): Power at RPM\n- performance_torque_nm (number, optional): Torque in Newton-meters\n- performance_power_kw (number, optional): Power in kilowatts\n- performance_co2 (number, optional): CO2 emissions rating\n- euro_status (number, optional): Euro emissions standard status"}},"additionalProperties":false}}],"scan":{"score":67,"grade":"C","scanned_at":"2026-09-19T20:28:42.497Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T20:28:42.426Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1092ms"]},"poisoning":{"score":13,"max":15,"notes":["9 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":3,"max":15,"notes":["repository not readable: repo not found"]},"identity":{"score":4,"max":10,"notes":["verified namespace with website, no repo"]}},"findings":[{"id":"poison.long-description","severity":"low","component":"poisoning","title":"Unusually long tool description (over 2,000 characters)","evidence":"tool search_active_cars: …Search for cars in the United States and Canada market with comprehensive filters. This endpoint allows searching market vehicles that are up for sale in US and Canadian market right now. This endpoint serves only dealer listings. DO NOT USE CARFAX FIELDS: Carfax data on this server is incomplete and unreliable. Do NOT pass `carfax_1_owner` or `carfax_clean_title` as filters, do NOT request them in facets/stats, and do NOT infer ownership history, title status, or any other meaning from any `carfax_*` value that might appear in a listing. Treat all Carfax fields as if they did not exist. MANDATORY TWO-STEP WORKFLOW for filtering by categorical fields. Field values in this API are NOT canonical English (e.g. fuel_type=\"Hybrid\" is wrong; the actual value is \"HEV\" or \"Electric / Unleaded\"). Skipping step 1 leads to silent zero-result responses. STEP 1 — discover valid values: call this tool with ONLY the `facets` parameter (and an optional location filter), rows=1, no other filters set. STEP 2 — filter for real: re-call with the exact strings returned in step 1. For instance, to filter cars by powertrain in New York: STEP 1 call: search_active_cars(facets=\"powertrain_type\", rows=1, state=\"NY\") -> returns {\"powertrain_type\": [{\"item\": \"HEV\", \"count\": 18058}, {\"item\": \"PHEV\", \"count\": 6004}, ...]} STEP 2 call: search_active_cars(powertrain_type=\"HEV,PHEV\", state=\"NY\") Fields that REQUIRE step 1 before being used as filters: powertrain_type, fuel_type, trim, body_type, drivetrain, transmission, make, model, exterior_color, interior_color. WRONG: search_active_cars(fuel_type=\"Hybrid\") # silent zero-result CORRECT: search_active_cars(facets=\"fuel_type\", rows=1) # discover valid values first then: search_active_cars(fuel_type=\"Electric / Unleaded\") DEALER FILTERING: When any of dealer_id, source, mc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id, mc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id, mc_sub_dealership_group_name, or mc_category are provided, this tool automatically routes to the Dealer Inventory Syndication API (GET /dealerships/inventory) instead of the standard inventory search API for optimized dealer-specific inventory retrieval. Use search_past_90_days for expired/sold dealer inventory analysis. STALENESS METRICS — dos_active vs dom_active (read before answering \"how long has this car been for sale\" questions): - dos_active (Days on Site): days this listing has been active at the CURRENT dealer. Answers \"how long has THIS DEALER been trying to sell this car.\" DEFAULT: use dos_active for stale-inventory and \"how long has it been listed\" questions (e.g. finding dealers with stale inventory in an area). - dom_active (Days on Market): cumulative days the VEHICLE has been actively listed for sale across ALL dealers — it survives dealer-to-dealer transfers. Use ONLY when the question is about the vehicle's total market exposure, e.g. evaluating a car at auction or in a dealer trade: a car showing dos_active=15 at the current store may show dom_active=60 because it has been passed around dealers for two months. This rule applies to choosing filter params (dos_active_range vs dom_active_range), sort_by values, and which field to read and report from listing results. When unsure which the user means, default to dos_active.…"}],"inputs":{"probes":[{"url":"https://developers.marketcheck.com/api/mcp","reachable":true,"authRequired":false,"latencyMs":1092,"serverInfo":{"name":"Marketcheck API Server","version":"3.4.2"}}],"packages":[],"repo":{"found":false,"owner":"MarketcheckHub","repo":"marketcheck-mcp-client","error":"repo not found"},"icon":{"url":"https://developers.marketcheck.com/img/logo.svg","source":"registry"},"presence":{"stars":null,"forks":null,"downloadsWeek":null,"license":null,"lastPushAt":null,"score":8}}}},"grade_history":[],"reviews":[]}