com.marketcheck/api

Est-ce que com.marketcheck/api est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.marketcheck/api » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 13 outils

• decode_vin_neovin≈ 254 tokens

  Get vehicle specifications from NeoVIN decoder by VIN. Get the basic information on specifications for a car identified by a valid VIN from NeoVIN decoder. This provides detailed vehicle specifications including trim, engine, transmission, features, options, MSRP information, and more comprehensive data than standard VIN decoders.

  Paramètres, retour & exemple (2)

  Paramètres

  • vin · string · requis
    Vehicle Identification Number (17 characters, required)
  • include_generic · ? · optionnel
    Boolean to include generic data in response (optional, default: False)

  Exemple d'appel

  {"name": "decode_vin_neovin", "arguments": {"vin": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_car_history≈ 297 tokens

  Get a car's online listing history by VIN. The history API returns online listing history for a car identified by its VIN. History listings are sorted in the descending order of the listing date / last seen date.

  Paramètres, retour & exemple (4)

  Paramètres

  • vin · string · requis
    Vehicle Identification Number (17 characters, required)
  • page · ? · optionnel
    Page number to fetch results (default is 1, optional)
  • fields · ? · optionnel
    List of fields to fetch, comma-separated (optional)
  • sort_order · ? · optionnel
    Sort order - asc or desc (default is asc, optional)

  Exemple d'appel

  {"name": "get_car_history", "arguments": {"vin": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_server_info≈ 124 tokens

  Get information about the server. Returns: Server capabilities as a dict (serialized by the transport layer)

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_server_info", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_sold_summary≈ 2265 tokens

  Monthly sold-vehicle statistics for US franchise and independent dealers: how many sold, at what advertised prices, how fast, where, ranked however you ask. A "sale" is inferred (a listing left a dealer site and met MarketCheck's sold rules); prices are advertised asking prices, not transaction prices. History starts January 2021 and runs through the last complete month. No auction, private-party, UK or Canada data. Required: - inventory_type: new, used, certified, or all (all pools new and used into one row; add inventory_type to ranking_dimensions to split them). There is no default. Dates: - date_from / date_to: YYYY-MM-DD; date_from is the first day of a month, date_to the last day of a month (inclusive). Send both or neither; at most one year apart. Omit both for the last complete month. A same-month year-over-year comparison (e.g. July vs July) is more than a year, so make two calls. Geography (summary_by, default state): - summary_by=national for ONE ranking of the whole country. Use it for any "in America"/"nationally" question. Never add up per-state rankings: a make only appears in a state's rows when it makes that state's top_n, so the sum undercounts. - summary_by=state or city_state for rankings within each state or city. - state / city filters take comma-separated lists (OR). There is no ZIP or metro filter. Filters (comma-separated lists are OR; text matching is case-insensitive): - dealer_type: franchise, independent, or all. - dealership_group_name: exact group name(s), e.g. "Lithia Motors Inc.". Don't guess names: look them up with search_dealerships (field mc_dealership_group_name). An unknown name returns a 422. One name contains a comma ("Americas Car-mart, Inc."), so send it alone. - source: the website the sold listing was found on, e.g. carmax.com. For one dealer (rooftop), pass its inventory_url from search_dealerships / search_dealers. Finding a dealer or dealership group (use the dealer directory, never guess): - One dealer's sales: search_dealerships (or search_dealers) by name, city, state or zip, then call this tool with source=<inventory_url>. This also works for dealers that belong to no group, which is most sales. - A whole group's sales: take mc_dealership_group_name from search_dealerships and pass it as dealership_group_name. Only about 38% of sales carry a group, so ranking by dealership_group_name leaves the rest out. - Several rooftops at once: source takes a comma-separated list of inventory_urls. - make, model, trim, body_type, body_subtype, powertrain_type (Combustion, HEV, MHEV, BEV, PHEV, FCEV, EREV), drivetrain (4WD, FWD, RWD; there is no AWD), transmission (Automatic, CVT, Manual), base_exterior_color, base_interior_color, msrp_label, fuel_type_category (ice, ev, hybrid, unknown, other). - year: model year(s), e.g. 2024 or 2020,2022. year_range: inclusive, e.g. 2020-2024, 2020- or -2024. Use year or year_range, not both. - miles_range: inclusive odometer range, e.g. 0-60000, 60000-. Ranking: - ranking_dimensions: comma-separated fields to group and rank by (default make,model,body_type). Valid: year, make, model, trim, body_type, body_subtype, drivetrain, transmission, powertrain_type, fuel_type_category, base_exterior_color, base_interior_color, msrp_label, dealership_group_name, source, inventory_type; or none for a single market total. state is not a dimension: use summary_by. - ranking_measure (default sold_count): sold_count, price_over_msrp_percentage, price_over_mc_msrp_percentage, or a dotted statistic: price.mean, price.sum, price.p50 (median price), dom_active.mean (average days on market), dom_active.p50, dos_active.mean, miles.mean, msrp.mean, and others listed in the valid-values error. - ranking_order: desc (default) or asc. - top_n: rows kept per group (per month and geography), not per response. Default 10. - limit: total rows returned, 1 to 20000 (default 20000). Check `truncated` in the response: true means the limit cut rows. Measure filters remove whole groups after the statistics are computed, leaving the numbers in the remaining rows unchanged (the vehicle filters above act on vehicles, before statistics). Each takes a number with an optional >, <, >=, <= or = prefix, e.g. ">=30": - sold_count, price_over_msrp_percentage, price_over_mc_msrp_percentage. - min_sold_count: shorthand for sold_count >= n. - measure_filters: dotted statistics, e.g. {"price.mean": ">20000", "dom_active.mean": "<45"}. average_sale_price is now price.mean, total_sale_price is price.sum, average_days_on_market is dom_active.mean. - By default measure filters apply AFTER rank and top_n (ranks can read 1, 3, 7), so a floor with the default top_n of 10 often returns no rows. Either raise top_n (e.g. 100000) or set rank_after_filters=true to filter first. - Ascending rankings: ranking_order=asc alone returns thousands of ties at the minimum (everything that sold once). Pair it with a floor, e.g. ranking_measure=dom_active.mean, ranking_order=asc, min_sold_count=30, top_n=100000. Response: `data` rows carry month, the grouping fields, rank, sold_count and nested statistics (price, miles, dom_active, dos_active, msrp, mc_msrp with count, mean and percentiles) plus price_over_msrp_percentage. `result_count`, `truncated`, `warnings` and `applied` (the defaults and date window the API actually used) come back unchanged. The service scales to zero when idle: the first call after a quiet period can take about 9 seconds. Errors: a 422 names the offending parameter and how to fix it; correct the call and retry.

  Paramètres, retour & exemple (35)

  Paramètres

  • city · ? · optionnel
  • make · ? · optionnel
  • trim · ? · optionnel
  • year · ? · optionnel
  • limit · ? · optionnel
  • model · ? · optionnel
  • state · ? · optionnel
  • top_n · ? · optionnel
  • source · ? · optionnel
  • date_to · ? · optionnel
  • body_type · ? · optionnel
  • date_from · ? · optionnel
  • drivetrain · ? · optionnel
  • msrp_label · ? · optionnel
  • sold_count · ? · optionnel
  • summary_by · ? · optionnel
  • year_range · ? · optionnel
  • dealer_type · ? · optionnel
  • miles_range · ? · optionnel
  • body_subtype · ? · optionnel
  • transmission · ? · optionnel
  • ranking_order · ? · optionnel
  • inventory_type · string · requis
  • min_sold_count · ? · optionnel
  • measure_filters · ? · optionnel
  • powertrain_type · ? · optionnel
  • ranking_measure · ? · optionnel
  • fuel_type_category · ? · optionnel
  • rank_after_filters · ? · optionnel
  • ranking_dimensions · ? · optionnel
  • base_exterior_color · ? · optionnel
  • base_interior_color · ? · optionnel
  • dealership_group_name · ? · optionnel
  • price_over_msrp_percentage · ? · optionnel
  • price_over_mc_msrp_percentage · ? · optionnel

  Exemple d'appel

  {"name": "get_sold_summary", "arguments": {"inventory_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• predict_price_with_comparables≈ 396 tokens

  Predict car price along with comparable vehicles in the market. This provides predicted price, MSRP along with active set comparables to help understand market positioning and competitive pricing.

  Paramètres, retour & exemple (7)

  Paramètres

  • vin · string · requis
    Vehicle Identification Number (17 characters, required)
  • zip · ? · optionnel
    Location ZIP code (default: '50501' - Des Moines, IA)
  • city · ? · optionnel
    City of the car (optional if zip provided)
  • miles · integer · optionnel
    Miles the vehicle has driven in total (default: 50,000)
  • state · ? · optionnel
    State of the car (optional if zip provided)
  • dealer_type · string · optionnel
    Filter based on dealer type (independent or franchise, default: 'franchise')
  • is_certified · boolean · optionnel
    Boolean to indicate if car is certified or not (default: False)

  Exemple d'appel

  {"name": "predict_price_with_comparables", "arguments": {"vin": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_active_cars≈ 7327 tokens

  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. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Filtering categorical fields (two steps). 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.

  Paramètres, retour & exemple (126)

  Paramètres

  • mm · ? · optionnel
    Make-Model concatenated string from auto-complete API
  • vin · ? · optionnel
    Filter listing on their VIN
  • ymm · ? · optionnel
    Year-Make-Model concatenated string from auto-complete API
  • zip · ? · optionnel
    Filter listing on ZIP around which they are listed
  • city · ? · optionnel
    Filter listing on City in which they are listed
  • make · ? · optionnel
    Filter listings on their make
  • plot · ? · optionnel
    If true, results in around 25k coordinates with limited fields for plotting
  • rows · ? · optionnel
    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.
  • trim · ? · optionnel
    Filter listing on their trim
  • vins · ? · optionnel
    Comma separated list of 17 digit vins (max 10 VINs per request)
  • year · ? · optionnel
    Vehicle manufacturing year (e.g., 2020, 2021)
  • ymmt · ? · optionnel
    Comma separated list of Year|Make|Model|Trim combinations
  • dedup · ? · optionnel
    If true, gives results with is_searchable irrespective of dealer_id/mc_website_id/source
  • doors · ? · optionnel
    Number of doors (e.g., 2, 4)
  • match · ? · optionnel
    Comma separated list of Year,Make,Model,Trim fields for exact match with vins
  • model · ? · optionnel
    Filter listings on their model
  • owned · ? · optionnel
    When true, returns listings actually owned by dealer (used with dealer_id/mc_website_id/source)
  • start · ? · optionnel
    Page number/offset to fetch results (default 0, max depends on package)
  • state · ? · optionnel
    Filter listing on State in which they are listed
  • stats · ? · optionnel
    List of fields for which stats need to be generated
  • engine · ? · optionnel
    Filter listing on their engine
  • facets · ? · optionnel
    Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution. Syntax: facets=field_name|offset|limit|min_count - offset (default: 0): Start position for terms - limit (default: 20, max: 1000): Number of terms to return - min_count (optional): Minimum count for a term to be included Example: facets=make|0|60|2 returns top 60 makes with at least 2 listings each
  • radius · ? · optionnel
    Radius around the search location (Unit - Miles)
  • source · ? · optionnel
    Source filter to search inventory from specific source
  • country · ? · optionnel
    Filter listing on Country in which they are listed
  • nodedup · ? · optionnel
    If true, API gives results without is_searchable (multiple listings for single vin)
  • sort_by · ? · optionnel
    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.
  • vdp_url · ? · optionnel
    Filter based on vehicle detail page URL
  • version · ? · optionnel
    Filter listings on their version
  • car_type · ? · optionnel
    Car type (new/used/certified)
  • latitude · ? · optionnel
    Latitude component of location
  • msa_code · ? · optionnel
    Filter listing on msa code in which they are listed
  • stock_no · ? · optionnel
    Filter listing on their stock number on lot
  • body_type · ? · optionnel
    Filter listing on their body type
  • cylinders · ? · optionnel
    Number of engine cylinders (e.g., 4, 6, 8)
  • dealer_id · ? · optionnel
    Dealer ID filter to search inventory from specific dealer
  • dom_range · ? · optionnel
    Days on Market range in format "min-max" (e.g., "10-50")
  • fuel_type · ? · optionnel
    Filter listing on their fuel type. WARNING: 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.
  • lease_emp · ? · optionnel
    Search listings with exact/range lease Estimated Monthly Payment(EMI)
  • longitude · ? · optionnel
    Longitude component of location
  • drivetrain · ? · optionnel
    Filter listing on their drivetrain
  • facet_sort · ? · optionnel
    Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically
  • in_transit · ? · optionnel
    Boolean to filter in transit vehicles
  • lease_term · ? · optionnel
    Search listings with exact/range lease term
  • msrp_range · ? · optionnel
    MSRP range in format "min-max" (e.g., "1000-5000")
  • sort_order · ? · optionnel
    Sort order (asc|desc)
  • year_range · ? · optionnel
    Year range in format "min-max" (e.g., "2019-2021")
  • dealer_type · ? · optionnel
    Type of dealer (e.g., franchise, independent)
  • engine_size · ? · optionnel
    Engine Size to match (comma-separated values)
  • finance_emp · ? · optionnel
    Search listings with exact/range Estimated Monthly Payment(EMI)
  • mc_category · ? · optionnel
    MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing"
  • miles_range · ? · optionnel
    Miles range in format "min-max" (e.g., "1000-5000")
  • photo_links · ? · optionnel
    Boolean to include only listings that have photo_links
  • price_range · ? · optionnel
    Price range in format "min-max" (e.g., "1000-5000")
  • seller_type · ? · optionnel
    Filter by seller type. Only 3 strict values allowed: "dealer" (default), "fsbo" (private seller), "auction"
  • body_subtype · ? · optionnel
    Body subtype to filter listings on (comma-separated values)
  • engine_block · ? · optionnel
    Engine Block to match (comma-separated values)
  • exclude_make · ? · optionnel
    List of makes to exclude from result
  • mc_dealer_id · ? · optionnel
    MarketCheck dealer ID filter
  • price_change · ? · optionnel
    Query to filter listings based on positive and negative price change
  • range_facets · ? · optionnel
    Comma separated list of numeric fields for range facets
  • transmission · ? · optionnel
    Filter listing on their transmission
  • vehicle_type · ? · optionnel
    Filter listing on their vehicle type
  • dom_180_range · ? · optionnel
    Last 180 Days on Market range in format "min-max" (e.g., "10-50")
  • include_lease · ? · optionnel
    Boolean param to search for listings that include leasing options
  • mc_rooftop_id · ? · optionnel
    MarketCheck rooftop ID filter
  • mc_website_id · ? · optionnel
    MarketCheck website ID filter
  • taxonomy_vins · ? · optionnel
    Comma separated list of 10 letters excerpt from 17 letter VIN
  • base_ext_color · ? · optionnel
    Base exterior color to match (comma-separated values)
  • base_int_color · ? · optionnel
    Base interior color to match (comma-separated values)
  • carfax_1_owner · ? · optionnel
    Indicates whether car has had only one owner or not
  • city_mpg_range · ? · optionnel
    City mileage range in format "min-max" (e.g., "1000-5000")
  • exterior_color · ? · optionnel
    Exterior color to match (comma-separated values)
  • interior_color · ? · optionnel
    Interior color to match (comma-separated values)
  • last_seen_days · ? · optionnel
    Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago).
  • mc_location_id · ? · optionnel
    MarketCheck location ID filter
  • exclude_sources · ? · optionnel
    List of sources to exclude from result
  • first_seen_days · ? · optionnel
    First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago).
  • include_finance · ? · optionnel
    Boolean param to search for listings that include finance options
  • last_seen_range · ? · optionnel
    Last seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)
  • min_photo_links · ? · optionnel
    Filter listings by number of photo links within given range
  • powertrain_type · ? · optionnel
    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). RECOMMENDED: Use this field instead of fuel_type for consistent and reliable filtering of vehicle power sources.
  • dom_active_range · ? · optionnel
    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.
  • dos_active_range · ? · optionnel
    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.
  • fetch_all_photos · boolean · optionnel
    When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links.
  • finance_loan_apr · ? · optionnel
    Search listings with exact/range loans Annual Percentage Rate
  • first_seen_range · ? · optionnel
    First seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)
  • options_packages · ? · optionnel
    Filter listings on their options_packages (intersection of provided OPs). Tip: before using this filter, 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.
  • seating_capacity · ? · optionnel
    Number of seats (e.g., 5, 7, 8)
  • engine_aspiration · ? · optionnel
    Engine Aspiration to match (comma-separated values)
  • engine_size_range · ? · optionnel
    Engine size range in format "min-max" (e.g., "1.0-2")
  • exclude_certified · ? · optionnel
    Boolean param to exclude certified cars from search results
  • finance_loan_term · ? · optionnel
    Search listings with exact/range finance loan term
  • highway_mpg_range · ? · optionnel
    Highway mileage range in format "min-max" (e.g., "1000-5000")
  • preferred_dealers · ? · optionnel
    Flag to add preferred dealers flag based on client filter score
  • carfax_clean_title · ? · optionnel
    Indicates whether car has clean ownership records
  • exclude_dealer_ids · ? · optionnel
    List of dealer ids to exclude from result
  • lease_down_payment · ? · optionnel
    Search listings with exact/range down payment in lease offers
  • photo_links_cached · ? · optionnel
    Boolean to include only listings that have photo_links_cached
  • price_change_range · ? · optionnel
    Price change range in format "min-max" (e.g., "10-500")
  • base_exterior_color · ? · optionnel
    Base exterior color to match (comma-separated values)
  • base_interior_color · ? · optionnel
    Base interior color to match (comma-separated values)
  • high_value_features · ? · optionnel
    Filter listings on their high_value_features (intersection of provided HVFs). Tip: before using this filter, 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.
  • finance_down_payment · ? · optionnel
    Search listings with exact/range down payment in finance offers
  • include_build_object · boolean · optionnel
    When True, includes build object in response. Build object structure: - year (number): Model year - make (string): Vehicle manufacturer - model (string, optional): Vehicle model - trim (string, optional): Trim level - version (string, optional): Specific version/variant - body_type (string, optional): Body style (sedan, SUV, truck, etc.) - vehicle_type (string, optional): Vehicle category - transmission (string, optional): Transmission type - drivetrain (string, optional): Drivetrain configuration - fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.) - engine (string, optional): Engine description - engine_size (number, optional): Engine displacement - engine_block (string, optional): Engine block configuration - doors (number, optional): Number of doors - cylinders (number, optional): Number of cylinders - made_in (string, optional): Manufacturing country - overall_height, overall_length, overall_width (string, optional): Vehicle dimensions - std_seating (string, optional): Standard seating capacity - highway_mpg (number, optional): Highway fuel economy - city_mpg (number, optional): City fuel economy - powertrain_type (string, optional): Powertrain classification
  • first_seen_at_mc_days · ? · optionnel
    First seen at MC days range in format "max-min" (e.g., "25-12" for 12 to 25 days ago).
  • include_dealer_object · boolean · optionnel
    When True, includes dealer object in response. Dealer object structure: - id (number): Unique dealer identifier - website (string): Dealer website URL - name (string): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - phone (string, optional): Contact phone number - seller_email (string, optional): Contact email address - dealership_group_name (string, optional): Parent dealership group - msa_code (string, optional): Metropolitan Statistical Area code
  • inventory_count_range · ? · optionnel
    Inventory count range for total listings in dealers inventory
  • exclude_mc_website_ids · ? · optionnel
    List of dealer ids to exclude from result
  • first_seen_at_mc_range · ? · optionnel
    First seen at MC date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)
  • include_relevant_links · ? · optionnel
    Include relevant links (default true)
  • mc_dealership_group_id · ? · optionnel
    MarketCheck dealership group ID filter
  • min_photo_links_cached · ? · optionnel
    Filter listings by number of cached photo links within range
  • preferred_dealers_only · ? · optionnel
    Flag to show only preferred dealers listings
  • exclude_options_packages · ? · optionnel
    Filter to remove listings with specified excluded OPs. Use facets="options_packages|0|1000" first to discover available package names.
  • finance_down_payment_per · ? · optionnel
    Search listings with exact/range down payment percentage
  • include_non_vin_listings · ? · optionnel
    Include non vin listings (default false)
  • mc_dealership_group_name · ? · optionnel
    MarketCheck dealership group name filter
  • first_seen_at_source_days · ? · optionnel
    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 · ? · optionnel
    First seen at source date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)
  • mc_sub_dealership_group_id · ? · optionnel
    MarketCheck sub-dealership group ID filter
  • active_inventory_date_range · ? · optionnel
    Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)
  • exclude_high_value_features · ? · optionnel
    Filter to remove listings with specified excluded HVFs. Use facets="high_value_features|0|1000" first to discover available feature names.
  • include_mc_dealership_object · boolean · optionnel
    When True, includes mc_dealership object in response. McDealership object structure: - mc_website_id (number, optional): MarketCheck website identifier - mc_dealer_id (number, optional): MarketCheck dealer identifier - mc_location_id (number, optional): MarketCheck location identifier - mc_rooftop_id (number, optional): MarketCheck rooftop identifier - mc_dealership_group_id (number, optional): MarketCheck dealership group identifier - mc_dealership_group_name (string, optional): MarketCheck dealership group name - mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier - mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name - mc_category (string, optional): MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing" - website (string, optional): Dealer website URL - name (string, optional): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - msa_code (string, optional): Metropolitan Statistical Area code - phone (string, optional): Contact phone number
  • mc_sub_dealership_group_name · ? · optionnel
    MarketCheck sub-dealership group name filter
  • include_preferred_dealer_flag · ? · optionnel
    Flag to add preferred dealers flag based on client filter score

  Exemple d'appel

  {"name": "search_active_cars", "arguments": {"mm": "texte", "vin": "texte", "ymm": "texte", "zip": "texte", "city": "texte", "make": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_dealers≈ 870 tokens

  Search the legacy MarketCheck dealer directory (one-website-per-dealer model). search_dealerships is recommended for new use cases. This endpoint is being phased out; use it only when you specifically need legacy `dealer_id`-style records or the `listing_count_range` inventory-size filter, which is not available on the dealerships endpoint. For get_sold_summary, a dealer's inventory_url here is its `source` value. This endpoint has no dealership-group field; use search_dealerships for group names. Geospatial: pass (latitude AND longitude) OR zip, plus radius (miles, max 7000). Pagination: rows default 10, max 50; start default 0; (start * rows) cannot exceed 10000.

  Paramètres, retour & exemple (19)

  Paramètres

  • zip · ? · optionnel
  • city · ? · optionnel
  • rows · ? · optionnel
    Page size, default 10, max 50.
  • start · ? · optionnel
    Pagination offset (0-based).
  • state · ? · optionnel
  • facets · ? · optionnel
    Comma-separated bucket-facet fields. Allowed values (any other field will be silently ignored): city, state, country, dealer_type.
  • radius · ? · optionnel
    Search radius in miles (0..7000).
  • country · string · requis
    US or CA. Default US.
  • sort_by · ? · optionnel
    dist (geo default), dealer_id (default), listing_count, created_at_days.
  • latitude · ? · optionnel
  • msa_code · ? · optionnel
    Metropolitan Statistical Area code(s).
  • longitude · ? · optionnel
  • sort_order · ? · optionnel
    asc | desc (default asc).
  • dealer_type · ? · optionnel
    franchise | independent.
  • range_facets · ? · optionnel
    Comma-separated numeric range-facet fields. Allowed values: listing_count.
  • inventory_url · ? · optionnel
    Filter by dealer domain.
  • created_at_days · ? · optionnel
    min-max age in days.
  • created_at_range · ? · optionnel
    YYYYMMDD-YYYYMMDD.
  • listing_count_range · ? · optionnel
    min-max inventory size (e.g. "50-100"). Legacy-only.

  Exemple d'appel

  {"name": "search_dealers", "arguments": {"country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_dealerships≈ 1197 tokens

  Search the MarketCheck dealership directory (current, multi-rooftop, group-aware). Use this for "who/where is the dealer?" lookups. For inventory, use search_active_cars. Recommended over search_dealers unless legacy `dealer_id`-style results are needed. This is also the lookup for get_sold_summary (sold-vehicle statistics): - A dealer's (rooftop's) sales: pass its inventory_url as get_sold_summary `source`. Several rooftops: comma-separated inventory_urls. - A dealership group's sales: pass mc_dealership_group_name as get_sold_summary `dealership_group_name`. Filter here with mc_dealership_group_name to list a group's rooftops. Geospatial: pass (latitude AND longitude) OR zip, plus radius (miles, max 7000). mc_category values: Dealer, Retailer, Dealership Group, Aggregator, Marketing, Financing. Pagination: rows default 10, max 50; start default 0; (start * rows) cannot exceed 10000.

  Paramètres, retour & exemple (27)

  Paramètres

  • zip · ? · optionnel
    5-digit ZIP/postal code; comma-separated for multi-value.
  • city · ? · optionnel
  • rows · ? · optionnel
    Page size, default 10, max 50.
  • start · ? · optionnel
    Pagination offset (0-based).
  • state · ? · optionnel
  • facets · ? · optionnel
    Comma-separated bucket-facet fields. Allowed values (any other field will be silently ignored): city, state, country, dealer_type, mc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id, mc_category, mc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id, mc_sub_dealership_group_name.
  • radius · ? · optionnel
    Search radius in miles (0..7000).
  • country · string · requis
    US or CA. Default US.
  • sort_by · ? · optionnel
    mc_website_id (default), mc_dealer_id, mc_location_id, mc_rooftop_id, mc_dealership_group_id, mc_sub_dealership_group_id, created_at_days.
  • latitude · ? · optionnel
  • msa_code · ? · optionnel
    Metropolitan Statistical Area code(s).
  • longitude · ? · optionnel
  • sort_order · ? · optionnel
    asc | desc (default asc).
  • dealer_type · ? · optionnel
    franchise | independent.
  • mc_category · ? · optionnel
    Seller category (see values above).
  • mc_dealer_id · ? · optionnel
  • range_facets · ? · optionnel
    Not supported on this endpoint — pass nothing. Use search_dealers if you need a listing_count range facet.
  • inventory_url · ? · optionnel
    Filter by dealer domain (e.g. carmax.com).
  • mc_rooftop_id · ? · optionnel
  • mc_website_id · ? · optionnel
  • mc_location_id · ? · optionnel
  • created_at_days · ? · optionnel
    min-max age in days.
  • created_at_range · ? · optionnel
    YYYYMMDD-YYYYMMDD.
  • mc_dealership_group_id · ? · optionnel
  • mc_dealership_group_name · ? · optionnel
  • mc_sub_dealership_group_id · ? · optionnel
  • mc_sub_dealership_group_name · ? · optionnel

  Exemple d'appel

  {"name": "search_dealerships", "arguments": {"country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_oem_incentives≈ 1530 tokens

  Search for OEM (manufacturer) incentive offers across all brands. Searches for rebates, financing deals, and lease specials with 50+ filter parameters. Use this when searching across multiple OEMs or doing broad searches.

  Paramètres, retour & exemple (40)

  Paramètres

  • zip · ? · optionnel
    5-character ZIP code
  • city · ? · optionnel
    City name
  • make · ? · optionnel
    Comma-separated make names (e.g., "Toyota,Honda")
  • rows · ? · optionnel
    Number of results to return (default: 10, max: 10)
  • trim · ? · optionnel
    Comma-separated trim levels
  • year · ? · optionnel
    Comma-separated years (e.g., "2024,2025")
  • model · ? · optionnel
    Comma-separated model names (e.g., "Camry,Accord")
  • start · ? · optionnel
    Starting record offset (default: 0, max: 10000)
  • state · ? · optionnel
    State code (2 chars)
  • stats · ? · optionnel
    Comma-separated fields for statistical aggregations (e.g., "monthly,apr,cashback_amount")
  • engine · ? · optionnel
    Comma-separated engine types
  • facets · ? · optionnel
    Comma-separated field names for faceted search (e.g., "make,model,offer_type")
  • radius · ? · optionnel
    Search radius in miles (default: 50, max: 5000 - be conservative, use larger values only when explicitly requested)
  • source · ? · optionnel
    OEM source domain
  • country · string · requis
    Country code
  • sort_by · ? · optionnel
    Field name to sort by (e.g., "monthly", "apr", "cashback_amount")
  • msa_code · ? · optionnel
    Metropolitan Statistical Area code (4 chars)
  • apr_range · ? · optionnel
    APR percentage range (e.g., "0-3")
  • dealer_id · ? · optionnel
    Filter by dealer ID
  • fuel_type · ? · optionnel
    Comma-separated fuel types
  • drivetrain · ? · optionnel
    Comma-separated drivetrain types
  • msrp_range · ? · optionnel
    MSRP value range
  • offer_type · ? · optionnel
    One of "lease", "finance", or "cash"
  • sort_order · ? · optionnel
    "asc" or "desc"
  • term_range · ? · optionnel
    Term length range (e.g., "24-60")
  • year_range · ? · optionnel
    Format "min-max" (e.g., "2020-2025")
  • transmission · ? · optionnel
    Comma-separated transmission types
  • monthly_range · ? · optionnel
    Monthly payment range (e.g., "200-400")
  • valid_from_range · ? · optionnel
    Offer start date range
  • status_date_range · ? · optionnel
    Last seen date range
  • down_payment_range · ? · optionnel
    Down payment amount range
  • search_offers_text · ? · optionnel
    Search within offer text
  • search_titles_text · ? · optionnel
    Search within offer titles
  • mileage_limit_range · ? · optionnel
    Annual mileage limit range
  • valid_through_range · ? · optionnel
    Offer end date range
  • due_at_signing_range · ? · optionnel
    Due at signing amount range
  • cashback_amount_range · ? · optionnel
    Cashback amount range (e.g., "1000-5000")
  • cashback_target_group · ? · optionnel
    Target demographic (e.g., "military,college_grad")
  • scraped_at_date_range · ? · optionnel
    First seen date range
  • search_disclaimers_text · ? · optionnel
    Search within disclaimers

  Exemple d'appel

  {"name": "search_oem_incentives", "arguments": {"country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_oem_incentives_by_zip≈ 654 tokens

  Search for incentives from a specific manufacturer in a location. Optimized for finding all available incentives from a specific OEM in a geographic area. Automatically converts ZIP to MSA code for regional relevance. Use this when you know both the manufacturer and location.

  Paramètres, retour & exemple (14)

  Paramètres

  • oem · string · requis
    OEM identifier (e.g., "toyota", "honda", "ford", "chevrolet", "bmw")
  • zip · string · requis
    5-character ZIP code
  • rows · ? · optionnel
    Number of results to return (default: 10, max: 10)
  • year · ? · optionnel
    Vehicle year (e.g., "2024")
  • model · ? · optionnel
    Vehicle model (e.g., "Camry", "Accord")
  • start · ? · optionnel
    Starting offset for pagination (default: 0)
  • stats · ? · optionnel
    Comma-separated stat fields (e.g., "monthly,apr")
  • facets · ? · optionnel
    Comma-separated facet fields (e.g., "model,offer_type")
  • sort_by · ? · optionnel
    Field to sort by (e.g., "monthly", "apr", "cashback_amount")
  • apr_range · ? · optionnel
    APR range (format: "min-max")
  • offer_type · ? · optionnel
    One of "lease", "finance", or "cash"
  • sort_order · ? · optionnel
    "asc" or "desc"
  • monthly_range · ? · optionnel
    Monthly payment range (format: "min-max")
  • cashback_amount_range · ? · optionnel
    Cashback range (format: "min-max")

  Exemple d'appel

  {"name": "search_oem_incentives_by_zip", "arguments": {"oem": "texte", "zip": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_past_90_days≈ 5406 tokens

  Search for recent car inventory (EXPIRED/SOLD listings from last 90 days) with comprehensive filters following Marketcheck API structure. Scope: this endpoint serves only expired/sold listings from the last 90 days for US and CA (Canada) markets, not active listings. For currently active listings, use the search_active_cars tool instead. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options VIN vs Listing ID Disclaimer: - A single VIN can have multiple listings, each with a unique listing ID - Listing ID changes when there are changes in price or miles of the listing - When expired=false is set, it shows listings for VINs that are currently active in the market (not sold yet), but the specific listing is expired. The latest/current listing for that VIN is present in the active search API - This endpoint shows historical listing data (expired listing IDs) for market analysis, not current inventory This endpoint is designed for analytical use cases including: - Historical market analysis of sold vehicles - Sold vehicle pricing trends and patterns - Days on market analysis for expired listings - Dealer inventory turnover and sales analysis - Market intelligence from recently sold inventory Key use cases: - Analyze recent sales trends and pricing - Get sold/expired listings for market intelligence - Calculate average market prices from recent inventory - Track dealer inventory turnover patterns Due to performance reasons, this endpoint is more restrictive than active search: - Does not accept facets, stats and range_facets in a single call - Requires one of: city, state, zip, (latitude+longitude+radius), source, or dealer_id - For geo queries, radius cannot be greater than 100 miles - Charged at higher rates than active search endpoint STALENESS METRICS — dos_active vs dom_active (read before answering "how long was this car for sale" questions): - dos_active (Days on Site): days the listing was active at the CURRENT dealer. Answers "how long did THIS DEALER try to sell this car." DEFAULT: use dos_active for stale-inventory and "how long was it listed" questions. - dom_active (Days on Market): cumulative days the VEHICLE was actively listed 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 was 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.

  Paramètres, retour & exemple (115)

  Paramètres

  • vin · ? · optionnel
  • zip · ? · optionnel
    Filter listing on ZIP around which they are listed
  • city · ? · optionnel
    Filter listing on City in which they are listed
  • make · ? · optionnel
    Filter listings on their make
  • plot · ? · optionnel
  • rows · ? · optionnel
    Number of results to return (default 5, max 50)
  • sold · ? · optionnel
    Boolean to fetch only sold/expired listings (True/False)
  • trim · ? · optionnel
    Filter listing on their trim
  • vins · ? · optionnel
  • year · ? · optionnel
    Vehicle manufacturing year (e.g., 2020, 2021)
  • ymmt · ? · optionnel
  • dedup · ? · optionnel
  • doors · ? · optionnel
    Number of doors (e.g., 2, 4)
  • match · ? · optionnel
  • model · ? · optionnel
    Filter listings on their model
  • owned · ? · optionnel
    Boolean, when True returns listings actually owned by dealer (used with dealer_id/source)
  • start · ? · optionnel
    Page number/offset to fetch results (default 0)
  • state · ? · optionnel
    Filter listing on State in which they are listed
  • stats · ? · optionnel
    Field for which stats need to be generated (single field only)
  • engine · ? · optionnel
  • facets · ? · optionnel
    Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution. Syntax: facets=field_name|offset|limit|min_count (single field only) - offset (default: 0): Start position for terms - limit (default: 20, max: 1000): Number of terms to return - min_count (optional): Minimum count for a term to be included Example: facets=make|0|60|2 returns top 60 makes with at least 2 listings each
  • radius · ? · optionnel
    Radius around the search location (Unit - Miles, max 100)
  • source · ? · optionnel
    Filter listing on their source
  • country · ? · optionnel
  • expired · ? · optionnel
    Boolean to fetch only expired listings or active ones (True/False)
  • nodedup · ? · optionnel
  • sort_by · ? · optionnel
    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.
  • vdp_url · ? · optionnel
  • version · ? · optionnel
  • car_type · ? · optionnel
    Car type (new/used/certified)
  • latitude · ? · optionnel
    Latitude component of location
  • msa_code · ? · optionnel
  • stock_no · ? · optionnel
  • body_type · ? · optionnel
    Filter listing on their body type
  • cylinders · ? · optionnel
    Number of engine cylinders (e.g., 4, 6, 8)
  • dealer_id · ? · optionnel
    Dealer id to filter the listings
  • dom_range · ? · optionnel
    Days on Market range in format "min-max" (e.g., "10-50")
  • fuel_type · ? · optionnel
    Filter listing on their fuel type. WARNING: This field has many non-normalized values. First call this tool with facets="fuel_type|0|1000" to discover exact available values before filtering.
  • lease_emp · ? · optionnel
  • longitude · ? · optionnel
    Longitude component of location
  • drivetrain · ? · optionnel
  • facet_sort · ? · optionnel
  • in_transit · ? · optionnel
    Boolean to filter in transit vehicles (True/False)
  • lease_term · ? · optionnel
  • msrp_range · ? · optionnel
    MSRP range in format "min-max" (e.g., "1000-5000")
  • sort_order · ? · optionnel
    Sort order (asc|desc)
  • year_range · ? · optionnel
    Year range in format "min-max" (e.g., "2019-2021")
  • dealer_name · ? · optionnel
  • dealer_type · ? · optionnel
  • engine_size · ? · optionnel
  • finance_emp · ? · optionnel
  • mc_category · ? · optionnel
    MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing"
  • miles_range · ? · optionnel
    Miles range in format "min-max" (e.g., "1000-5000")
  • photo_links · ? · optionnel
  • price_range · ? · optionnel
    Price range in format "min-max" (e.g., "1000-5000")
  • body_subtype · ? · optionnel
  • engine_block · ? · optionnel
  • exclude_make · ? · optionnel
  • mc_dealer_id · ? · optionnel
  • range_facets · ? · optionnel
    Numeric field for range facets (single field only)
  • transmission · ? · optionnel
  • vehicle_type · ? · optionnel
  • dom_180_range · ? · optionnel
  • include_lease · ? · optionnel
  • mc_rooftop_id · ? · optionnel
  • mc_website_id · ? · optionnel
  • taxonomy_vins · ? · optionnel
  • base_ext_color · ? · optionnel
  • base_int_color · ? · optionnel
  • carfax_1_owner · ? · optionnel
  • city_mpg_range · ? · optionnel
  • exterior_color · ? · optionnel
    Exterior color to match (comma-separated values)
  • interior_color · ? · optionnel
    Interior color to match (comma-separated values)
  • last_seen_days · ? · optionnel
    Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago).
  • mc_location_id · ? · optionnel
  • exclude_sources · ? · optionnel
  • first_seen_days · ? · optionnel
    First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago).
  • include_finance · ? · optionnel
  • last_seen_range · ? · optionnel
    Last seen date range in format YYYYMMDD-YYYYMMDD
  • dom_active_range · ? · optionnel
    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.
  • dos_active_range · ? · optionnel
    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.
  • fetch_all_photos · boolean · optionnel
    When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links.
  • finance_loan_apr · ? · optionnel
  • first_seen_range · ? · optionnel
    First seen date range in format YYYYMMDD-YYYYMMDD
  • seating_capacity · ? · optionnel
    Number of seats (e.g., 5, 7, 8)
  • engine_aspiration · ? · optionnel
  • engine_size_range · ? · optionnel
  • exclude_certified · ? · optionnel
  • finance_loan_term · ? · optionnel
  • highway_mpg_range · ? · optionnel
  • carfax_clean_title · ? · optionnel
  • exclude_dealer_ids · ? · optionnel
  • lease_down_payment · ? · optionnel
  • photo_links_cached · ? · optionnel
  • price_change_range · ? · optionnel
  • base_exterior_color · ? · optionnel
    Base exterior color to match (comma-separated values)
  • base_interior_color · ? · optionnel
    Base interior color to match (comma-separated values)
  • finance_down_payment · ? · optionnel
  • include_build_object · boolean · optionnel
    When True, includes build object in response. Build object structure: - year (number): Model year - make (string): Vehicle manufacturer - model (string, optional): Vehicle model - trim (string, optional): Trim level - version (string, optional): Specific version/variant - body_type (string, optional): Body style (sedan, SUV, truck, etc.) - vehicle_type (string, optional): Vehicle category - transmission (string, optional): Transmission type - drivetrain (string, optional): Drivetrain configuration - fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.) - engine (string, optional): Engine description - engine_size (number, optional): Engine displacement - engine_block (string, optional): Engine block configuration - doors (number, optional): Number of doors - cylinders (number, optional): Number of cylinders - made_in (string, optional): Manufacturing country - overall_height, overall_length, overall_width (string, optional): Vehicle dimensions - std_seating (string, optional): Standard seating capacity - highway_mpg (number, optional): Highway fuel economy - city_mpg (number, optional): City fuel economy
  • dealership_group_name · ? · optionnel
  • first_seen_at_mc_days · ? · optionnel
    First seen at MC days range in format "max-min" (e.g., "25-12" for 12 to 25 days ago).
  • include_dealer_object · boolean · optionnel
    When True, includes dealer object in response. Dealer object structure: - id (number): Unique dealer identifier - website (string): Dealer website URL - name (string): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - phone (string, optional): Contact phone number - seller_email (string, optional): Contact email address - dealership_group_name (string, optional): Parent dealership group - msa_code (string, optional): Metropolitan Statistical Area code
  • exclude_mc_website_ids · ? · optionnel
  • first_seen_at_mc_range · ? · optionnel
    First seen at MC date range in format YYYYMMDD-YYYYMMDD
  • include_relevant_links · ? · optionnel
  • mc_dealership_group_id · ? · optionnel
  • finance_down_payment_per · ? · optionnel
  • include_non_vin_listings · ? · optionnel
    Boolean to include non vin listings (True/False, default False)
  • mc_dealership_group_name · ? · optionnel
  • first_seen_at_source_days · ? · optionnel
    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 · ? · optionnel
    First seen at source date range in format YYYYMMDD-YYYYMMDD
  • mc_sub_dealership_group_id · ? · optionnel
  • active_inventory_date_range · ? · optionnel
    Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)
  • include_mc_dealership_object · boolean · optionnel
    When True, includes mc_dealership object in response. McDealership object structure: - mc_website_id (number, optional): MarketCheck website identifier - mc_dealer_id (number, optional): MarketCheck dealer identifier - mc_location_id (number, optional): MarketCheck location identifier - mc_rooftop_id (number, optional): MarketCheck rooftop identifier - mc_dealership_group_id (number, optional): MarketCheck dealership group identifier - mc_dealership_group_name (string, optional): MarketCheck dealership group name - mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier - mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name - mc_category (string, optional): MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing" - website (string, optional): Dealer website URL - name (string, optional): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - msa_code (string, optional): Metropolitan Statistical Area code - phone (string, optional): Contact phone number
  • mc_sub_dealership_group_name · ? · optionnel

  Exemple d'appel

  {"name": "search_past_90_days", "arguments": {"vin": "texte", "zip": "texte", "city": "texte", "make": "texte", "plot": "texte", "rows": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_uk_active_cars≈ 6538 tokens

  Search for active cars in the UK market. This tool searches for currently active car listings in the UK using the Marketcheck API. It supports comprehensive filtering by location, vehicle specifications, price, and more. Includes all parameters supported by the /search/car/uk/active endpoint. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options 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. - 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.

  Paramètres, retour & exemple (124)

  Paramètres

  • vrm · ? · optionnel
    Vehicle Registration Mark (VRM) filter.
  • zip · ? · optionnel
    To filter listing on ZIP around which they are listed.
  • city · ? · optionnel
    To filter listing on City in which they are listed.
  • make · ? · optionnel
    To filter listings on their make (comma-separated values).
  • plot · ? · optionnel
    If true, results in around 25k coordinates with limited fields to plot.
  • rows · ? · optionnel
    Number of results to return. Default is 10. Max is 50.
  • trim · ? · optionnel
    To filter listing on their trim (comma-separated values).
  • year · ? · optionnel
    To filter listing on their year (comma-separated values).
  • ymmt · ? · optionnel
    Comma separated list of Year, Make, Model, Trim combinations.
  • dedup · ? · optionnel
    If true, will give results with is_searchable irrespective of dealer.
  • doors · ? · optionnel
    Doors to filter the cars on (comma-separated integer values).
  • match · ? · optionnel
    Comma separated list of fields for exact match.
  • model · ? · optionnel
    To filter listings on their model (comma-separated values).
  • owned · ? · optionnel
    When used with dealer_id, returns listings owned by dealer.
  • start · ? · optionnel
    Page number to fetch results. Default is 0. Max pagination: 10000.
  • state · ? · optionnel
    To filter listing on State in which they are listed.
  • stats · ? · optionnel
    List of fields for which stats need to be generated.
  • county · ? · optionnel
    To filter listing on county in which they are listed.
  • engine · ? · optionnel
    To filter listing on their engine (comma-separated values).
  • facets · ? · optionnel
    Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution. Syntax: facets=field_name|offset|limit|min_count - offset (default: 0): Start position for terms - limit (default: 20, max: 1000): Number of terms to return - min_count (optional): Minimum count for a term to be included Example: facets=make|0|60|2 returns top 60 makes with at least 2 listings each
  • radius · ? · optionnel
    Radius around the search location in miles (max: 7000).
  • source · ? · optionnel
    To filter listing on their source (comma-separated URLs).
  • uvc_id · ? · optionnel
    UVC (Universal Vehicle Code) ID filter.
  • country · ? · optionnel
    To filter listing on Country (uk, england, scotland, northern ireland, wales).
  • nodedup · ? · optionnel
    If true, API will give results without is_searchable.
  • sort_by · ? · optionnel
    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.
  • variant · ? · optionnel
    To filter listing on their variant (comma-separated values).
  • vdp_url · ? · optionnel
    Vehicle details page URL filter.
  • car_type · ? · optionnel
    Car type. Allowed values are - new / used.
  • latitude · ? · optionnel
    Latitude component of location (range: -90 to 90).
  • stock_no · ? · optionnel
    To filter listing on their stock number on lot.
  • body_type · ? · optionnel
    To filter listing on their body type (comma-separated values).
  • cylinders · ? · optionnel
    To filter listing on their cylinders (comma-separated values).
  • dealer_id · ? · optionnel
    Dealer id to filter the listings.
  • dom_range · ? · optionnel
    Days on Market range to filter cars (format: min-max e.g. 10-50).
  • fuel_type · ? · optionnel
    To filter listing on their fuel type (comma-separated values).
  • longitude · ? · optionnel
    Longitude component of location (range: -180 to 180).
  • drivetrain · ? · optionnel
    To filter listing on their drivetrain (comma-separated values).
  • facet_sort · ? · optionnel
    Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically
  • fca_status · ? · optionnel
    To filter on fca status.
  • msrp_range · ? · optionnel
    MSRP range to filter listings (format: min-max e.g. 1000-5000).
  • num_owners · ? · optionnel
    Number of owners filter.
  • sort_order · ? · optionnel
    Sort order - asc or desc. Default sort order is asc.
  • year_range · ? · optionnel
    Year range to filter listings (format: min-max e.g. 2019-2021).
  • dealer_type · ? · optionnel
    Filter based on dealer type (franchise or independent).
  • engine_size · ? · optionnel
    Engine Size to match (comma-separated values from facets API).
  • mc_category · ? · optionnel
    Filter based on mc_category (Dealer, Dealership Group, etc.).
  • miles_range · ? · optionnel
    Miles range to filter listings (format: min-max e.g. 1000-5000).
  • photo_links · ? · optionnel
    Boolean to include only listings that have photo_links.
  • postal_code · ? · optionnel
    To filter listing on postal code around which they are listed.
  • price_range · ? · optionnel
    Price range to filter listings (format: min-max e.g. 1000-5000).
  • exclude_make · ? · optionnel
    Make values to exclude from results.
  • mc_dealer_id · ? · optionnel
    To filter listings on their mc_dealer_id.
  • price_change · ? · optionnel
    Price change filter for listings.
  • range_facets · ? · optionnel
    Comma separated list of numeric fields for range facets.
  • transmission · ? · optionnel
    To filter listing on their transmission (comma-separated values).
  • vehicle_type · ? · optionnel
    To filter listing on their vehicle type.
  • co2_emissions · ? · optionnel
    CO2 emissions filter (comma-separated values).
  • dom_180_range · ? · optionnel
    Last 180 Days on Market range to filter cars.
  • mc_rooftop_id · ? · optionnel
    To filter listings on their mc_rooftop_id.
  • mc_website_id · ? · optionnel
    Website id to filter the listings.
  • model_variant · ? · optionnel
    Model variant filter.
  • base_ext_color · ? · optionnel
    Base exterior color to match (alias for base_exterior_color).
  • base_int_color · ? · optionnel
    Base interior color to match (alias for base_interior_color).
  • city_mpg_range · ? · optionnel
    City mileage range (min-max format e.g. 1000-5000).
  • exterior_color · ? · optionnel
    Exterior color to match (comma-separated values from facets API).
  • interior_color · ? · optionnel
    Interior color to match (comma-separated values from facets API).
  • last_seen_days · ? · optionnel
    Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago).
  • mc_location_id · ? · optionnel
    To filter listings on their mc_location_id.
  • ulez_compliant · ? · optionnel
    Filter for ULEZ compliant vehicles.
  • ev_battery_type · ? · optionnel
    Electric vehicle battery type filter.
  • exclude_sources · ? · optionnel
    A list of sources to exclude from result.
  • first_seen_days · ? · optionnel
    First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago).
  • insurance_group · ? · optionnel
    Insurance group filter for UK vehicles.
  • is_vat_included · ? · optionnel
    Boolean filter for VAT inclusion.
  • last_seen_range · ? · optionnel
    Last seen date range (YYYYMMDD-YYYYMMDD format).
  • min_photo_links · ? · optionnel
    Minimum number of photo links required.
  • car_location_zip · ? · optionnel
    Car location ZIP filter.
  • dom_active_range · ? · optionnel
    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.
  • dos_active_range · ? · optionnel
    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.
  • ev_vehicle_range · ? · optionnel
    Electric vehicle range filter.
  • fetch_all_photos · boolean · optionnel
    When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links.
  • first_seen_range · ? · optionnel
    First seen date range (YYYYMMDD-YYYYMMDD format).
  • seating_capacity · ? · optionnel
    To filter on vehicle seating capacity.
  • car_location_city · ? · optionnel
    Car location city filter.
  • engine_size_range · ? · optionnel
    Engine size range filter.
  • highway_mpg_range · ? · optionnel
    Highway mileage range (min-max format e.g. 1000-5000).
  • preferred_dealers · ? · optionnel
    Preferred dealers filter.
  • combined_mpg_range · ? · optionnel
    Combined mileage range for UK (min-max format).
  • exclude_dealer_ids · ? · optionnel
    A list of dealer ids to exclude from result.
  • photo_links_cached · ? · optionnel
    Boolean to include only listings with cached photo_links.
  • price_change_range · ? · optionnel
    Price change range to filter listings.
  • wheelbase_category · ? · optionnel
    To filter listing on their wheelbase category.
  • write_off_category · ? · optionnel
    Write off category filter.
  • base_exterior_color · ? · optionnel
    Base exterior color to match (comma-separated values).
  • base_interior_color · ? · optionnel
    Base interior color to match (comma-separated values).
  • car_location_county · ? · optionnel
    Car location county filter.
  • car_location_street · ? · optionnel
    Car location street filter.
  • include_build_object · boolean · optionnel
    When True, includes build object in response. Build object structure: - year (number): Model year - make (string): Vehicle manufacturer - model (string, optional): Vehicle model - model_variant (string, optional): Vehicle model variant - trim (string, optional): Trim level - variant (string, optional): Specific variant identifier - body_type (string, optional): Body style (saloon, hatchback, estate, etc.) - vehicle_type (string, optional): Vehicle category - transmission (string, optional): Transmission type - drivetrain (string, optional): Drivetrain configuration - fuel_type (string, optional): Fuel type (petrol, diesel, electric, hybrid, etc.) - engine (string, optional): Engine description - engine_size (number, optional): Engine displacement - doors (number, optional): Number of doors - cylinders (number, optional): Number of cylinders - made_in (string, optional): Manufacturing country - overall_height, overall_length, overall_width (string, optional): Vehicle dimensions - wheelbase_category (string, optional): Wheelbase classification - std_seating (string, optional): Standard seating capacity - highway_mpg (number, optional): Highway fuel economy - city_mpg (number, optional): City fuel economy - combined_mpg (number, optional): Combined fuel economy - seating_capacity (number, optional): Passenger seating capacity - performance_torque_ftlb (number, optional): Torque in foot-pounds - performance_maxspeed_mph (number, optional): Maximum speed in miles per hour - performance_torque_rpm (number, optional): Torque at RPM - performance_power_bhp (number, optional): Power in brake horsepower - performance_power_rpm (number, optional): Power at RPM - performance_torque_nm (number, optional): Torque in Newton-meters - performance_power_kw (number, optional): Power in kilowatts - performance_co2 (number, optional): CO2 emissions rating - euro_status (number, optional): Euro emissions standard status
  • car_location_latitude · ? · optionnel
    Car location latitude coordinate.
  • first_seen_at_mc_days · ? · optionnel
    First seen at MC days range in format "max-min" (e.g., "15-5").
  • include_dealer_object · boolean · optionnel
    When True, includes dealer object in response. Dealer object structure: - id (number): Unique dealer identifier - website (string): Dealer website URL - name (string): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, county, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - postal_code (string, optional): UK postal code - phone (string, optional): Contact phone number - seller_email (string, optional): Contact email address - fca_status (string, optional): FCA authorization status - preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer
  • inventory_count_range · ? · optionnel
    Inventory count range to filter listings (min-max format).
  • performance_co2_range · ? · optionnel
    Performance CO2 range filter.
  • car_location_longitude · ? · optionnel
    Car location longitude coordinate.
  • exclude_mc_website_ids · ? · optionnel
    A list of MC website ids to exclude from result.
  • first_seen_at_mc_range · ? · optionnel
    First seen at MC date range.
  • mc_dealership_group_id · ? · optionnel
    To filter listings on their mc_dealership_group_id.
  • min_photo_links_cached · ? · optionnel
    Minimum number of cached photo links required.
  • preferred_dealers_only · ? · optionnel
    Filter to show only preferred dealers.
  • car_location_seller_name · ? · optionnel
    Car location seller name filter.
  • include_non_vin_listings · ? · optionnel
    To include non vin listings. Default is false.
  • mc_dealership_group_name · ? · optionnel
    To filter listings on their mc_dealership_group_name.
  • ev_battery_capacity_range · ? · optionnel
    EV battery capacity range filter.
  • first_seen_at_source_days · ? · optionnel
    First seen at source days range in format "max-min" (e.g., "15-5").
  • vehicle_registration_mark · ? · optionnel
    Vehicle Registration Mark filter.
  • exclude_write_off_category · ? · optionnel
    To exclude write off category.
  • first_seen_at_source_range · ? · optionnel
    First seen at source date range.
  • mc_sub_dealership_group_id · ? · optionnel
    To filter listings on their mc_sub_dealership_group_id.
  • active_inventory_date_range · ? · optionnel
    Active inventory date range filter.
  • include_mc_dealership_object · boolean · optionnel
    When True, includes mc_dealership object in response. McDealership object structure: - mc_website_id (number, optional): MarketCheck website identifier - mc_dealer_id (number, optional): MarketCheck dealer identifier - mc_location_id (number, optional): MarketCheck location identifier - mc_rooftop_id (number, optional): MarketCheck rooftop identifier - mc_dealership_group_id (number, optional): MarketCheck dealership group identifier - mc_dealership_group_name (string, optional): MarketCheck dealership group name - mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier - mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name - mc_category (string, optional): MarketCheck seller category. UK market only supports: dealer - website (string, optional): Dealer website URL - name (string, optional): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, county, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - postal_code (string, optional): UK postal code - phone (string, optional): Contact phone number - fca_status (string, optional): FCA authorization status
  • mc_sub_dealership_group_name · ? · optionnel
    To filter listings on their mc_sub_dealership_group_name.
  • include_preferred_dealer_flag · ? · optionnel
    Include preferred dealer flag.
  • vehicle_registration_date_range · ? · optionnel
    Vehicle registration date range (YYYYMMDD-YYYYMMDD).

  Exemple d'appel

  {"name": "search_uk_active_cars", "arguments": {"vrm": "texte", "zip": "texte", "city": "texte", "make": "texte", "plot": "texte", "rows": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_uk_recent_cars≈ 6525 tokens

  Search for recent/expired cars in the UK market (last 90 days). This tool searches recent inventory data for expired/sold listings only. It does not include active listings - use search_uk_active_cars for current inventory. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options STALENESS METRICS — dos_active vs dom_active (read before answering "how long was this car for sale" questions): - dos_active (Days on Site): days the listing was active at the CURRENT dealer. Answers "how long did THIS DEALER try to sell this car." DEFAULT: use dos_active for stale-inventory and "how long was it listed" questions. - dom_active (Days on Market): cumulative days the VEHICLE was actively listed 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 was 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.

  Paramètres, retour & exemple (121)

  Paramètres

  • vrm · ? · optionnel
    Vehicle Registration Mark (VRM) filter.
  • zip · ? · optionnel
    To filter listing on ZIP around which they are listed.
  • city · ? · optionnel
    To filter listing on City in which they are listed.
  • make · ? · optionnel
    To filter listings on their make (comma-separated values).
  • plot · ? · optionnel
    If true, results in around 25k coordinates with limited fields to plot.
  • rows · ? · optionnel
    Number of results to return. Default is 10. Max is 50.
  • sold · ? · optionnel
    Boolean parameter to fetch only sold listings.
  • trim · ? · optionnel
    To filter listing on their trim (comma-separated values).
  • year · ? · optionnel
    To filter listing on their year (comma-separated values).
  • ymmt · ? · optionnel
    Comma separated list of Year, Make, Model, Trim combinations.
  • dedup · ? · optionnel
    If true, will give results with is_searchable irrespective of dealer.
  • doors · ? · optionnel
    Doors to filter the cars on (comma-separated integer values).
  • match · ? · optionnel
    Comma separated list of fields for exact match (e.g., year,make,model,trim).
  • model · ? · optionnel
    To filter listings on their model (comma-separated values).
  • owned · ? · optionnel
    When used with dealer_id, returns listings owned by dealer.
  • start · ? · optionnel
    Page number to fetch results. Default is 0. Max pagination: 10000.
  • state · ? · optionnel
    To filter listing on State in which they are listed.
  • stats · ? · optionnel
    List of fields for which stats need to be generated.
  • county · ? · optionnel
    To filter listing on county in which they are listed.
  • engine · ? · optionnel
    To filter listing on their engine (comma-separated values).
  • facets · ? · optionnel
    Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution. Syntax: facets=field_name|offset|limit|min_count - offset (default: 0): Start position for terms - limit (default: 20, max: 1000): Number of terms to return - min_count (optional): Minimum count for a term to be included Example: facets=make|0|60|2 returns top 60 makes with at least 2 listings each
  • radius · ? · optionnel
    Radius around the search location in miles (max: 100 for recent search).
  • source · ? · optionnel
    To filter listing on their source (comma-separated URLs).
  • country · ? · optionnel
    To filter listing on Country (uk, england, scotland, northern ireland, wales).
  • expired · ? · optionnel
    Boolean flag to either fetch only the expired listings or active ones.
  • nodedup · ? · optionnel
    If true, API will give results without is_searchable.
  • sort_by · ? · optionnel
    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.
  • variant · ? · optionnel
    To filter listing on their variant (comma-separated values).
  • vdp_url · ? · optionnel
    Vehicle details page URL filter.
  • car_type · ? · optionnel
    Car type. Allowed values are - new / used / certified.
  • latitude · ? · optionnel
    Latitude component of location (range: -90 to 90).
  • stock_no · ? · optionnel
    To filter listing on their stock number on lot.
  • body_type · ? · optionnel
    To filter listing on their body type (comma-separated values).
  • cylinders · ? · optionnel
    To filter listing on their cylinders (comma-separated values).
  • dealer_id · ? · optionnel
    Dealer id to filter the listings.
  • dom_range · ? · optionnel
    Days on Market range to filter cars (format: min-max e.g. 10-50).
  • fuel_type · ? · optionnel
    To filter listing on their fuel type (comma-separated values).
  • lease_emp · ? · optionnel
    Search listings with lease Estimated Monthly Payment (EMI) or range.
  • longitude · ? · optionnel
    Longitude component of location (range: -180 to 180).
  • drivetrain · ? · optionnel
    To filter listing on their drivetrain (comma-separated values).
  • facet_sort · ? · optionnel
    Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically
  • fca_status · ? · optionnel
    To filter on fca status.
  • lease_term · ? · optionnel
    Search listings with exact lease term, or range (min-max e.g. 30-60).
  • msrp_range · ? · optionnel
    MSRP range to filter listings (format: min-max e.g. 1000-5000).
  • num_owners · ? · optionnel
    Number of owners filter.
  • sort_order · ? · optionnel
    Sort order - asc or desc. Default sort order is asc.
  • year_range · ? · optionnel
    Year range to filter listings (format: min-max e.g. 2019-2021).
  • dealer_name · ? · optionnel
    Filter listings on dealer_name.
  • dealer_type · ? · optionnel
    Filter based on dealer type (franchise or independent).
  • engine_size · ? · optionnel
    Engine Size to match (comma-separated values from facets API).
  • finance_emp · ? · optionnel
    Search listings with finance Estimated Monthly Payment (EMI) or range.
  • mc_category · ? · optionnel
    Filter based on mc_category (Dealer, Dealership Group, etc.).
  • miles_range · ? · optionnel
    Miles range to filter listings (format: min-max e.g. 1000-5000).
  • photo_links · ? · optionnel
    Boolean to include only listings that have photo_links.
  • postal_code · ? · optionnel
    To filter listing on postal code around which they are listed.
  • price_range · ? · optionnel
    Price range to filter listings (format: min-max e.g. 1000-5000).
  • body_subtype · ? · optionnel
    Body subtype to filter listings (comma-separated values from facets API).
  • engine_block · ? · optionnel
    Engine Block to match (comma-separated values from facets).
  • exclude_make · ? · optionnel
    Make values to exclude from results.
  • mc_dealer_id · ? · optionnel
    To filter listings on their mc_dealer_id.
  • range_facets · ? · optionnel
    Comma separated list of numeric fields for range facets.
  • transmission · ? · optionnel
    To filter listing on their transmission (comma-separated values).
  • vehicle_type · ? · optionnel
    To filter listing on their vehicle type (comma-separated values).
  • dom_180_range · ? · optionnel
    Last 180 Days on Market range to filter cars.
  • mc_rooftop_id · ? · optionnel
    To filter listings on their mc_rooftop_id.
  • mc_website_id · ? · optionnel
    Website id to filter the listings.
  • model_variant · ? · optionnel
    Model variant filter.
  • base_ext_color · ? · optionnel
    Base exterior color to match (alias for base_exterior_color).
  • base_int_color · ? · optionnel
    Base interior color to match (alias for base_interior_color).
  • city_mpg_range · ? · optionnel
    City mileage range for UK (min-max format e.g. 1000-5000).
  • exterior_color · ? · optionnel
    Exterior color to match (comma-separated values from facets API).
  • interior_color · ? · optionnel
    Interior color to match (comma-separated values from facets API).
  • last_seen_days · ? · optionnel
    Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago).
  • mc_location_id · ? · optionnel
    To filter listings on their mc_location_id.
  • ulez_compliant · ? · optionnel
    Filter for ULEZ compliant vehicles.
  • exclude_sources · ? · optionnel
    A list of sources to exclude from result.
  • first_seen_days · ? · optionnel
    First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago).
  • insurance_group · ? · optionnel
    Insurance group filter for UK vehicles.
  • is_vat_included · ? · optionnel
    Boolean filter for VAT inclusion.
  • last_seen_range · ? · optionnel
    Last seen date range (YYYYMMDD-YYYYMMDD format).
  • dom_active_range · ? · optionnel
    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.
  • dos_active_range · ? · optionnel
    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.
  • fetch_all_photos · boolean · optionnel
    When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links.
  • finance_loan_apr · ? · optionnel
    Search listings with finance Annual Percentage Rate or range.
  • first_seen_range · ? · optionnel
    First seen date range (YYYYMMDD-YYYYMMDD format).
  • seating_capacity · ? · optionnel
    To filter on vehicle seating capacity.
  • car_include_lease · ? · optionnel
    Boolean param to search for listings that include leasing options.
  • engine_aspiration · ? · optionnel
    Engine Aspiration to match (comma-separated values from facets).
  • engine_size_range · ? · optionnel
    Engine size range filter (min-max format).
  • exclude_certified · ? · optionnel
    Boolean param to exclude certified cars from search results.
  • finance_loan_term · ? · optionnel
    Search listings with exact finance loan term or range.
  • highway_mpg_range · ? · optionnel
    Highway mileage range for UK (min-max format e.g. 1000-5000).
  • combined_mpg_range · ? · optionnel
    Combined mileage range for UK (min-max format).
  • exclude_dealer_ids · ? · optionnel
    A list of dealer ids to exclude from result.
  • lease_down_payment · ? · optionnel
    Search listings with exact down payment in lease offers or range.
  • photo_links_cached · ? · optionnel
    Boolean to include only listings with cached photo_links.
  • price_change_range · ? · optionnel
    Price change range to filter listings.
  • wheelbase_category · ? · optionnel
    To filter listing on their wheelbase category.
  • write_off_category · ? · optionnel
    Write off category filter.
  • base_exterior_color · ? · optionnel
    Base exterior color to match (comma-separated values).
  • base_interior_color · ? · optionnel
    Base interior color to match (comma-separated values).
  • car_include_finance · ? · optionnel
    Boolean param to search for listings that include finance options.
  • finance_down_payment · ? · optionnel
    Search listings with exact down payment in finance offers or range.
  • include_build_object · boolean · optionnel
    When True, includes build object in response. Build object structure: - year (number): Model year - make (string): Vehicle manufacturer - model (string, optional): Vehicle model - model_variant (string, optional): Vehicle model variant - trim (string, optional): Trim level - variant (string, optional): Specific variant identifier - body_type (string, optional): Body style (saloon, hatchback, estate, etc.) - vehicle_type (string, optional): Vehicle category - transmission (string, optional): Transmission type - drivetrain (string, optional): Drivetrain configuration - fuel_type (string, optional): Fuel type (petrol, diesel, electric, hybrid, etc.) - engine (string, optional): Engine description - engine_size (number, optional): Engine displacement - doors (number, optional): Number of doors - cylinders (number, optional): Number of cylinders - made_in (string, optional): Manufacturing country - overall_height, overall_length, overall_width (string, optional): Vehicle dimensions - wheelbase_category (string, optional): Wheelbase classification - std_seating (string, optional): Standard seating capacity - highway_mpg (number, optional): Highway fuel economy - city_mpg (number, optional): City fuel economy - combined_mpg (number, optional): Combined fuel economy - seating_capacity (number, optional): Passenger seating capacity - performance_torque_ftlb (number, optional): Torque in foot-pounds - performance_maxspeed_mph (number, optional): Maximum speed in miles per hour - performance_torque_rpm (number, optional): Torque at RPM - performance_power_bhp (number, optional): Power in brake horsepower - performance_power_rpm (number, optional): Power at RPM - performance_torque_nm (number, optional): Torque in Newton-meters - performance_power_kw (number, optional): Power in kilowatts - performance_co2 (number, optional): CO2 emissions rating - euro_status (number, optional): Euro emissions standard status
  • dealership_group_name · ? · optionnel
    Name of the dealership group to search for.
  • first_seen_at_mc_days · ? · optionnel
    First seen at MC days range in format "max-min" (e.g., "15-5").
  • include_dealer_object · boolean · optionnel
    When True, includes dealer object in response. Dealer object structure: - id (number): Unique dealer identifier - website (string): Dealer website URL - name (string): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, county, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - postal_code (string, optional): UK postal code - phone (string, optional): Contact phone number - seller_email (string, optional): Contact email address - fca_status (string, optional): FCA authorization status - preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer
  • exclude_mc_website_ids · ? · optionnel
    A list of MC website ids to exclude from result.
  • first_seen_at_mc_range · ? · optionnel
    First seen at MC date range.
  • include_relevant_links · ? · optionnel
    To include_relevant_links. Default is true.
  • mc_dealership_group_id · ? · optionnel
    To filter listings on their mc_dealership_group_id.
  • finance_down_payment_per · ? · optionnel
    Search listings with exact down payment percentage or range.
  • include_non_vin_listings · ? · optionnel
    To include non vin listings. Default is false.
  • mc_dealership_group_name · ? · optionnel
    To filter listings on their mc_dealership_group_name.
  • first_seen_at_source_days · ? · optionnel
    First seen at source days range in format "max-min" (e.g., "15-5").
  • exclude_write_off_category · ? · optionnel
    To exclude write off category.
  • first_seen_at_source_range · ? · optionnel
    First seen at source date range.
  • mc_sub_dealership_group_id · ? · optionnel
    To filter listings on their mc_sub_dealership_group_id.
  • active_inventory_date_range · ? · optionnel
    Active inventory date range filter.
  • include_mc_dealership_object · boolean · optionnel
    When True, includes mc_dealership object in response. McDealership object structure: - mc_website_id (number, optional): MarketCheck website identifier - mc_dealer_id (number, optional): MarketCheck dealer identifier - mc_location_id (number, optional): MarketCheck location identifier - mc_rooftop_id (number, optional): MarketCheck rooftop identifier - mc_dealership_group_id (number, optional): MarketCheck dealership group identifier - mc_dealership_group_name (string, optional): MarketCheck dealership group name - mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier - mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name - mc_category (string, optional): MarketCheck seller category. UK market only supports: dealer - website (string, optional): Dealer website URL - name (string, optional): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, county, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - postal_code (string, optional): UK postal code - phone (string, optional): Contact phone number - fca_status (string, optional): FCA authorization status
  • mc_sub_dealership_group_name · ? · optionnel
    To filter listings on their mc_sub_dealership_group_name.

  Exemple d'appel

  {"name": "search_uk_recent_cars", "arguments": {"vrm": "texte", "zip": "texte", "city": "texte", "make": "texte", "plot": "texte", "rows": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://developers.marketcheck.com/api/mcp