MarketCheck API
REMOTE · DEVELOPERS.MARKETCHECK.COM
MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history.
Available components
Last scanned (4 hours ago)
Scores higher than 97% of remote servers
Reachable. Last reached 5 Nov 2026.
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security97
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server supports Client ID Metadata Documents, the current MCP client-registration mechanism. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability50
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 19093 tokens (~1468/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage95
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 82% of tool parameters carry a description.Partial
- Structured output schemas are declared (92% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 13 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 0
- Stability: 0.97 → pass security
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 4 Nov 26 0
- Stability: pass → 0.97 functional
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 3 Nov 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 2 Nov 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 1 Nov 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 31 Oct 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 30 Oct 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 29 Oct 26 0
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://developers.marketcheck.com/api/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=developers.marketcheck.com | CN=WR3,O=Google Trust Services,C=US | 17 Sept 2026 | 16 Dec 2026 | RSA 2048 | SHA256-RSA | efc1586d1ce7af8212575d4b33e7f3a0 |
| SANs: developers.marketcheck.com | ||||||
| CN=WR3,O=Google Trust Services,C=US (CA) | CN=GTS Root R1,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | RSA 2048 | SHA256-RSA | 7ff005a91568d63abc22861684aa4b5a |
| CN=GTS Root R1,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 19 Jun 2020 | 28 Jan 2028 | RSA 4096 | SHA256-RSA | 77bd0d6cdb36f91aea210fc4f058d30d |
| CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 1 Sept 1998 | 28 Jan 2028 | RSA 2048 | SHA1-RSA | 40000000001154b5ac394 |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of developers.marketcheck.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| marketcheck.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer realm="Marketcheck MCPs", resource_metadata="https://developers.marketcheck.com/.well-known/oauth-protected-resource/api/mcp"
Bearer realm="Marketcheck MCPs", resource_metadata="https://developers.marketcheck.com/.well-known/oauth-protected-resource/api/mcp"| Header | Value |
|---|---|
| strict-transport-security | max-age=31556926 |
Protected resource metadata
| Document | https://developers.marketcheck.com/.well-known/oauth-protected-resource/api/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://developers.marketcheck.com/api/mcp |
| Authorisation server | https://developers.marketcheck.com |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://developers.marketcheck.com/api/mcp | Verified | 200 | |
| http (plaintext) | http://developers.marketcheck.com/api/mcp | HTTPS enforced | 301 | https://developers.marketcheck.com/api/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
decode_vin_neovin Decode VIN with NeoVIN ~94
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 and MSRP information.
| Name | Type | Req | Description |
|---|---|---|---|
| include_generic | – | – | Boolean to include generic data in response (optional, default: False) |
| vin | string | yes | Vehicle Identification Number (17 characters, required) |
Structured output declared, but exposes no named fields.
No examples provided.
get_car_history Get Vehicle Listing History by VIN ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | – | – | List of fields to fetch, comma-separated (optional) |
| page | – | – | Page number to fetch results (default is 1, optional) |
| sort_order | – | – | Sort order - asc or desc (default is asc, optional) |
| vin | string | yes | Vehicle Identification Number (17 characters, required) |
Structured output declared, but exposes no named fields.
No examples provided.
get_server_info Get Server Information ~30
Get information about the server. Returns: Server capabilities as a dict (serialized by the transport layer)
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
get_sold_summary Get Sold Vehicle Market Summary ~1,668
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): -…
| Name | Type | Req | Description |
|---|---|---|---|
| base_exterior_color | – | – | – |
| base_interior_color | – | – | – |
| body_subtype | – | – | – |
| body_type | – | – | – |
| city | – | – | – |
| date_from | – | – | – |
| date_to | – | – | – |
| dealer_type | – | – | – |
| dealership_group_name | – | – | – |
| drivetrain | – | – | – |
| fuel_type_category | – | – | – |
| inventory_type | string | yes | – |
| limit | – | – | – |
| make | – | – | – |
| measure_filters | – | – | – |
| miles_range | – | – | – |
| min_sold_count | – | – | – |
| model | – | – | – |
| msrp_label | – | – | – |
| powertrain_type | – | – | – |
| price_over_mc_msrp_percentage | – | – | – |
| price_over_msrp_percentage | – | – | – |
| rank_after_filters | – | – | – |
| ranking_dimensions | – | – | – |
| ranking_measure | – | – | – |
| ranking_order | – | – | – |
| sold_count | – | – | – |
| source | – | – | – |
| state | – | – | – |
| summary_by | – | – | – |
| top_n | – | – | – |
| transmission | – | – | – |
| trim | – | – | – |
| year | – | – | – |
| year_range | – | – | – |
No output schema declared.
No examples provided.
predict_price_with_comparables Predict Vehicle Price with Comparables ~176
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.
| Name | Type | Req | Description |
|---|---|---|---|
| city | – | – | City of the car (optional if zip provided) |
| dealer_type | string | – | Filter based on dealer type (independent or franchise, default: 'franchise') |
| is_certified | boolean | – | Boolean to indicate if car is certified or not (default: False) |
| miles | integer | – | Miles the vehicle has driven in total (default: 50,000) |
| state | – | – | State of the car (optional if zip provided) |
| vin | string | yes | Vehicle Identification Number (17 characters, required) |
| zip | – | – | Location ZIP code (default: '50501' - Des Moines, IA) |
Structured output declared, but exposes no named fields.
No examples provided.
search_active_cars Search Active US/Canada Vehicle Listings ~4,385
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 automat…
| Name | Type | Req | Description |
|---|---|---|---|
| active_inventory_date_range | – | – | Date range to filter listings active within range (YYYYMMDD-YYYYMMDD) |
| base_ext_color | – | – | Base exterior color to match (comma-separated values) |
| base_exterior_color | – | – | Base exterior color to match (comma-separated values) |
| base_int_color | – | – | Base interior color to match (comma-separated values) |
| base_interior_color | – | – | Base interior color to match (comma-separated values) |
| body_subtype | – | – | Body subtype to filter listings on (comma-separated values) |
| body_type | – | – | Filter listing on their body type |
| car_type | – | – | Car type (new/used/certified) |
| carfax_1_owner | – | – | Indicates whether car has had only one owner or not |
| carfax_clean_title | – | – | Indicates whether car has clean ownership records |
| city | – | – | Filter listing on City in which they are listed |
| city_mpg_range | – | – | City mileage range in format "min-max" (e.g., "1000-5000") |
| country | – | – | Filter listing on Country in which they are listed |
| cylinders | – | – | Number of engine cylinders (e.g., 4, 6, 8) |
| dealer_id | – | – | Dealer ID filter to search inventory from specific dealer |
| dealer_type | – | – | Type of dealer (e.g., franchise, independent) |
| dedup | – | – | If true, gives results with is_searchable irrespective of dealer_id/mc_website_id/source |
| dom_180_range | – | – | Last 180 Days on Market range in format "min-max" (e.g., "10-50") |
| dom_active_range | – | – | 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 evaluati… |
| dom_range | – | – | Days on Market range in format "min-max" (e.g., "10-50") |
| doors | – | – | Number of doors (e.g., 2, 4) |
| dos_active_range | – | – | 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 METRI… |
| drivetrain | – | – | Filter listing on their drivetrain |
| engine | – | – | Filter listing on their engine |
| engine_aspiration | – | – | Engine Aspiration to match (comma-separated values) |
| engine_block | – | – | Engine Block to match (comma-separated values) |
| engine_size | – | – | Engine Size to match (comma-separated values) |
| engine_size_range | – | – | Engine size range in format "min-max" (e.g., "1.0-2") |
| exclude_certified | – | – | Boolean param to exclude certified cars from search results |
| exclude_dealer_ids | – | – | List of dealer ids to exclude from result |
| exclude_high_value_features | – | – | Filter to remove listings with specified excluded HVFs. Use facets="high_value_features|0|1000" first to discover available feature names. |
| exclude_make | – | – | List of makes to exclude from result |
| exclude_mc_website_ids | – | – | List of dealer ids to exclude from result |
| exclude_options_packages | – | – | Filter to remove listings with specified excluded OPs. Use facets="options_packages|0|1000" first to discover available package names. |
| exclude_sources | – | – | List of sources to exclude from result |
| exterior_color | – | – | Exterior color to match (comma-separated values) |
| facet_sort | – | – | Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically |
| facets | – | – | 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 -… |
| fetch_all_photos | boolean | – | When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links. |
| finance_down_payment | – | – | Search listings with exact/range down payment in finance offers |
| finance_down_payment_per | – | – | Search listings with exact/range down payment percentage |
| finance_emp | – | – | Search listings with exact/range Estimated Monthly Payment(EMI) |
| finance_loan_apr | – | – | Search listings with exact/range loans Annual Percentage Rate |
| finance_loan_term | – | – | Search listings with exact/range finance loan term |
| first_seen_at_mc_days | – | – | First seen at MC days range in format "max-min" (e.g., "25-12" for 12 to 25 days ago). |
| first_seen_at_mc_range | – | – | First seen at MC date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date) |
| first_seen_at_source_days | – | – | 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 | – | – | First seen at source date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date) |
| first_seen_days | – | – | First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago). |
| first_seen_range | – | – | First seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date) |
| fuel_type | – | – | 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|… |
| high_value_features | – | – | 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 availa… |
| highway_mpg_range | – | – | Highway mileage range in format "min-max" (e.g., "1000-5000") |
| in_transit | – | – | Boolean to filter in transit vehicles |
| include_build_object | boolean | – | 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, optio… |
| include_dealer_object | boolean | – | 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_t… |
| include_finance | – | – | Boolean param to search for listings that include finance options |
| include_lease | – | – | Boolean param to search for listings that include leasing options |
| include_mc_dealership_object | boolean | – | 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… |
| include_non_vin_listings | – | – | Include non vin listings (default false) |
| include_preferred_dealer_flag | – | – | Flag to add preferred dealers flag based on client filter score |
| include_relevant_links | – | – | Include relevant links (default true) |
| interior_color | – | – | Interior color to match (comma-separated values) |
| inventory_count_range | – | – | Inventory count range for total listings in dealers inventory |
| last_seen_days | – | – | Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago). |
| last_seen_range | – | – | Last seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date) |
| latitude | – | – | Latitude component of location |
| lease_down_payment | – | – | Search listings with exact/range down payment in lease offers |
| lease_emp | – | – | Search listings with exact/range lease Estimated Monthly Payment(EMI) |
| lease_term | – | – | Search listings with exact/range lease term |
| longitude | – | – | Longitude component of location |
| make | – | – | Filter listings on their make |
| match | – | – | Comma separated list of Year,Make,Model,Trim fields for exact match with vins |
| mc_category | – | – | MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing" |
| mc_dealer_id | – | – | MarketCheck dealer ID filter |
| mc_dealership_group_id | – | – | MarketCheck dealership group ID filter |
| mc_dealership_group_name | – | – | MarketCheck dealership group name filter |
| mc_location_id | – | – | MarketCheck location ID filter |
| mc_rooftop_id | – | – | MarketCheck rooftop ID filter |
| mc_sub_dealership_group_id | – | – | MarketCheck sub-dealership group ID filter |
| mc_sub_dealership_group_name | – | – | MarketCheck sub-dealership group name filter |
| mc_website_id | – | – | MarketCheck website ID filter |
| miles_range | – | – | Miles range in format "min-max" (e.g., "1000-5000") |
| min_photo_links | – | – | Filter listings by number of photo links within given range |
| min_photo_links_cached | – | – | Filter listings by number of cached photo links within range |
| mm | – | – | Make-Model concatenated string from auto-complete API |
| model | – | – | Filter listings on their model |
| msa_code | – | – | Filter listing on msa code in which they are listed |
| msrp_range | – | – | MSRP range in format "min-max" (e.g., "1000-5000") |
| nodedup | – | – | If true, API gives results without is_searchable (multiple listings for single vin) |
| options_packages | – | – | 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 opt… |
| owned | – | – | When true, returns listings actually owned by dealer (used with dealer_id/mc_website_id/source) |
| photo_links | – | – | Boolean to include only listings that have photo_links |
| photo_links_cached | – | – | Boolean to include only listings that have photo_links_cached |
| plot | – | – | If true, results in around 25k coordinates with limited fields for plotting |
| powertrain_type | – | – | 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),… |
| preferred_dealers | – | – | Flag to add preferred dealers flag based on client filter score |
| preferred_dealers_only | – | – | Flag to show only preferred dealers listings |
| price_change | – | – | Query to filter listings based on positive and negative price change |
| price_change_range | – | – | Price change range in format "min-max" (e.g., "10-500") |
| price_range | – | – | Price range in format "min-max" (e.g., "1000-5000") |
| radius | – | – | Radius around the search location (Unit - Miles) |
| range_facets | – | – | Comma separated list of numeric fields for range facets |
| rows | – | – | 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): defa… |
| seating_capacity | – | – | Number of seats (e.g., 5, 7, 8) |
| seller_type | – | – | Filter by seller type. Only 3 strict values allowed: "dealer" (default), "fsbo" (private seller), "auction" |
| sort_by | – | – | 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… |
| sort_order | – | – | Sort order (asc|desc) |
| source | – | – | Source filter to search inventory from specific source |
| start | – | – | Page number/offset to fetch results (default 0, max depends on package) |
| state | – | – | Filter listing on State in which they are listed |
| stats | – | – | List of fields for which stats need to be generated |
| stock_no | – | – | Filter listing on their stock number on lot |
| taxonomy_vins | – | – | Comma separated list of 10 letters excerpt from 17 letter VIN |
| transmission | – | – | Filter listing on their transmission |
| trim | – | – | Filter listing on their trim |
| vdp_url | – | – | Filter based on vehicle detail page URL |
| vehicle_type | – | – | Filter listing on their vehicle type |
| version | – | – | Filter listings on their version |
| vin | – | – | Filter listing on their VIN |
| vins | – | – | Comma separated list of 17 digit vins (max 10 VINs per request) |
| year | – | – | Vehicle manufacturing year (e.g., 2020, 2021) |
| year_range | – | – | Year range in format "min-max" (e.g., "2019-2021") |
| ymm | – | – | Year-Make-Model concatenated string from auto-complete API |
| ymmt | – | – | Comma separated list of Year|Make|Model|Trim combinations |
| zip | – | – | Filter listing on ZIP around which they are listed |
Structured output declared, but exposes no named fields.
No examples provided.
search_dealers Search US/Canada Dealer Directory (Legacy) ~414
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.
| Name | Type | Req | Description |
|---|---|---|---|
| city | – | – | – |
| country | string | yes | US or CA. Default US. |
| created_at_days | – | – | min-max age in days. |
| created_at_range | – | – | YYYYMMDD-YYYYMMDD. |
| dealer_type | – | – | franchise | independent. |
| facets | – | – | Comma-separated bucket-facet fields. Allowed values (any other field will be silently ignored): city, state, country, dealer_type. |
| inventory_url | – | – | Filter by dealer domain. |
| latitude | – | – | – |
| listing_count_range | – | – | min-max inventory size (e.g. "50-100"). Legacy-only. |
| longitude | – | – | – |
| msa_code | – | – | Metropolitan Statistical Area code(s). |
| radius | – | – | Search radius in miles (0..7000). |
| range_facets | – | – | Comma-separated numeric range-facet fields. Allowed values: listing_count. |
| rows | – | – | Page size, default 10, max 50. |
| sort_by | – | – | dist (geo default), dealer_id (default), listing_count, created_at_days. |
| sort_order | – | – | asc | desc (default asc). |
| start | – | – | Pagination offset (0-based). |
| state | – | – | – |
| zip | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
search_dealerships Search US/Canada Dealership Directory ~644
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.
| Name | Type | Req | Description |
|---|---|---|---|
| city | – | – | – |
| country | string | yes | US or CA. Default US. |
| created_at_days | – | – | min-max age in days. |
| created_at_range | – | – | YYYYMMDD-YYYYMMDD. |
| dealer_type | – | – | franchise | independent. |
| facets | – | – | 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_categ… |
| inventory_url | – | – | Filter by dealer domain (e.g. carmax.com). |
| latitude | – | – | – |
| longitude | – | – | – |
| mc_category | – | – | Seller category (see values above). |
| mc_dealer_id | – | – | – |
| mc_dealership_group_id | – | – | – |
| mc_dealership_group_name | – | – | – |
| mc_location_id | – | – | – |
| mc_rooftop_id | – | – | – |
| mc_sub_dealership_group_id | – | – | – |
| mc_sub_dealership_group_name | – | – | – |
| mc_website_id | – | – | – |
| msa_code | – | – | Metropolitan Statistical Area code(s). |
| radius | – | – | Search radius in miles (0..7000). |
| range_facets | – | – | Not supported on this endpoint — pass nothing. Use search_dealers if you need a listing_count range facet. |
| rows | – | – | Page size, default 10, max 50. |
| sort_by | – | – | 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. |
| sort_order | – | – | asc | desc (default asc). |
| start | – | – | Pagination offset (0-based). |
| state | – | – | – |
| zip | – | – | 5-digit ZIP/postal code; comma-separated for multi-value. |
Structured output declared, but exposes no named fields.
No examples provided.
search_oem_incentives Search OEM Incentive Offers ~643
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.
| Name | Type | Req | Description |
|---|---|---|---|
| apr_range | – | – | APR percentage range (e.g., "0-3") |
| cashback_amount_range | – | – | Cashback amount range (e.g., "1000-5000") |
| cashback_target_group | – | – | Target demographic (e.g., "military,college_grad") |
| city | – | – | City name |
| country | string | yes | Country code |
| dealer_id | – | – | Filter by dealer ID |
| down_payment_range | – | – | Down payment amount range |
| drivetrain | – | – | Comma-separated drivetrain types |
| due_at_signing_range | – | – | Due at signing amount range |
| engine | – | – | Comma-separated engine types |
| facets | – | – | Comma-separated field names for faceted search (e.g., "make,model,offer_type") |
| fuel_type | – | – | Comma-separated fuel types |
| make | – | – | Comma-separated make names (e.g., "Toyota,Honda") |
| mileage_limit_range | – | – | Annual mileage limit range |
| model | – | – | Comma-separated model names (e.g., "Camry,Accord") |
| monthly_range | – | – | Monthly payment range (e.g., "200-400") |
| msa_code | – | – | Metropolitan Statistical Area code (4 chars) |
| msrp_range | – | – | MSRP value range |
| offer_type | – | – | One of "lease", "finance", or "cash" |
| radius | – | – | Search radius in miles (default: 50, max: 5000 - be conservative, use larger values only when explicitly requested) |
| rows | – | – | Number of results to return (default: 10, max: 10) |
| scraped_at_date_range | – | – | First seen date range |
| search_disclaimers_text | – | – | Search within disclaimers |
| search_offers_text | – | – | Search within offer text |
| search_titles_text | – | – | Search within offer titles |
| sort_by | – | – | Field name to sort by (e.g., "monthly", "apr", "cashback_amount") |
| sort_order | – | – | "asc" or "desc" |
| source | – | – | OEM source domain |
| start | – | – | Starting record offset (default: 0, max: 10000) |
| state | – | – | State code (2 chars) |
| stats | – | – | Comma-separated fields for statistical aggregations (e.g., "monthly,apr,cashback_amount") |
| status_date_range | – | – | Last seen date range |
| term_range | – | – | Term length range (e.g., "24-60") |
| transmission | – | – | Comma-separated transmission types |
| trim | – | – | Comma-separated trim levels |
| valid_from_range | – | – | Offer start date range |
| valid_through_range | – | – | Offer end date range |
| year | – | – | Comma-separated years (e.g., "2024,2025") |
| year_range | – | – | Format "min-max" (e.g., "2020-2025") |
| zip | – | – | 5-character ZIP code |
Structured output declared, but exposes no named fields.
No examples provided.
search_oem_incentives_by_zip Search OEM Incentive Offers by ZIP ~308
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.
| Name | Type | Req | Description |
|---|---|---|---|
| apr_range | – | – | APR range (format: "min-max") |
| cashback_amount_range | – | – | Cashback range (format: "min-max") |
| facets | – | – | Comma-separated facet fields (e.g., "model,offer_type") |
| model | – | – | Vehicle model (e.g., "Camry", "Accord") |
| monthly_range | – | – | Monthly payment range (format: "min-max") |
| oem | string | yes | OEM identifier (e.g., "toyota", "honda", "ford", "chevrolet", "bmw") |
| offer_type | – | – | One of "lease", "finance", or "cash" |
| rows | – | – | Number of results to return (default: 10, max: 10) |
| sort_by | – | – | Field to sort by (e.g., "monthly", "apr", "cashback_amount") |
| sort_order | – | – | "asc" or "desc" |
| start | – | – | Starting offset for pagination (default: 0) |
| stats | – | – | Comma-separated stat fields (e.g., "monthly,apr") |
| year | – | – | Vehicle year (e.g., "2024") |
| zip | string | yes | 5-character ZIP code |
Structured output declared, but exposes no named fields.
No examples provided.
search_past_90_days Search US Expired Listings (Past 90 Days) ~3,148
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 inv…
| Name | Type | Req | Description |
|---|---|---|---|
| active_inventory_date_range | – | – | Date range to filter listings active within range (YYYYMMDD-YYYYMMDD) |
| base_ext_color | – | – | – |
| base_exterior_color | – | – | Base exterior color to match (comma-separated values) |
| base_int_color | – | – | – |
| base_interior_color | – | – | Base interior color to match (comma-separated values) |
| body_subtype | – | – | – |
| body_type | – | – | Filter listing on their body type |
| car_type | – | – | Car type (new/used/certified) |
| carfax_1_owner | – | – | – |
| carfax_clean_title | – | – | – |
| city | – | – | Filter listing on City in which they are listed |
| city_mpg_range | – | – | – |
| country | – | – | – |
| cylinders | – | – | Number of engine cylinders (e.g., 4, 6, 8) |
| dealer_id | – | – | Dealer id to filter the listings |
| dealer_name | – | – | – |
| dealer_type | – | – | – |
| dealership_group_name | – | – | – |
| dedup | – | – | – |
| dom_180_range | – | – | – |
| dom_active_range | – | – | 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);… |
| dom_range | – | – | Days on Market range in format "min-max" (e.g., "10-50") |
| doors | – | – | Number of doors (e.g., 2, 4) |
| dos_active_range | – | – | 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. |
| drivetrain | – | – | – |
| engine | – | – | – |
| engine_aspiration | – | – | – |
| engine_block | – | – | – |
| engine_size | – | – | – |
| engine_size_range | – | – | – |
| exclude_certified | – | – | – |
| exclude_dealer_ids | – | – | – |
| exclude_make | – | – | – |
| exclude_mc_website_ids | – | – | – |
| exclude_sources | – | – | – |
| expired | – | – | Boolean to fetch only expired listings or active ones (True/False) |
| exterior_color | – | – | Exterior color to match (comma-separated values) |
| facet_sort | – | – | – |
| facets | – | – | 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 (… |
| fetch_all_photos | boolean | – | When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links. |
| finance_down_payment | – | – | – |
| finance_down_payment_per | – | – | – |
| finance_emp | – | – | – |
| finance_loan_apr | – | – | – |
| finance_loan_term | – | – | – |
| first_seen_at_mc_days | – | – | First seen at MC days range in format "max-min" (e.g., "25-12" for 12 to 25 days ago). |
| first_seen_at_mc_range | – | – | First seen at MC date range in format YYYYMMDD-YYYYMMDD |
| first_seen_at_source_days | – | – | 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 | – | – | First seen at source date range in format YYYYMMDD-YYYYMMDD |
| first_seen_days | – | – | First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago). |
| first_seen_range | – | – | First seen date range in format YYYYMMDD-YYYYMMDD |
| fuel_type | – | – | 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. |
| highway_mpg_range | – | – | – |
| in_transit | – | – | Boolean to filter in transit vehicles (True/False) |
| include_build_object | boolean | – | 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, optio… |
| include_dealer_object | boolean | – | 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_t… |
| include_finance | – | – | – |
| include_lease | – | – | – |
| include_mc_dealership_object | boolean | – | 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… |
| include_non_vin_listings | – | – | Boolean to include non vin listings (True/False, default False) |
| include_relevant_links | – | – | – |
| interior_color | – | – | Interior color to match (comma-separated values) |
| last_seen_days | – | – | Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago). |
| last_seen_range | – | – | Last seen date range in format YYYYMMDD-YYYYMMDD |
| latitude | – | – | Latitude component of location |
| lease_down_payment | – | – | – |
| lease_emp | – | – | – |
| lease_term | – | – | – |
| longitude | – | – | Longitude component of location |
| make | – | – | Filter listings on their make |
| match | – | – | – |
| mc_category | – | – | MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing" |
| mc_dealer_id | – | – | – |
| mc_dealership_group_id | – | – | – |
| mc_dealership_group_name | – | – | – |
| mc_location_id | – | – | – |
| mc_rooftop_id | – | – | – |
| mc_sub_dealership_group_id | – | – | – |
| mc_sub_dealership_group_name | – | – | – |
| mc_website_id | – | – | – |
| miles_range | – | – | Miles range in format "min-max" (e.g., "1000-5000") |
| model | – | – | Filter listings on their model |
| msa_code | – | – | – |
| msrp_range | – | – | MSRP range in format "min-max" (e.g., "1000-5000") |
| nodedup | – | – | – |
| owned | – | – | Boolean, when True returns listings actually owned by dealer (used with dealer_id/source) |
| photo_links | – | – | – |
| photo_links_cached | – | – | – |
| plot | – | – | – |
| price_change_range | – | – | – |
| price_range | – | – | Price range in format "min-max" (e.g., "1000-5000") |
| radius | – | – | Radius around the search location (Unit - Miles, max 100) |
| range_facets | – | – | Numeric field for range facets (single field only) |
| rows | – | – | Number of results to return (default 5, max 50) |
| seating_capacity | – | – | Number of seats (e.g., 5, 7, 8) |
| sold | – | – | Boolean to fetch only sold/expired listings (True/False) |
| sort_by | – | – | 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… |
| sort_order | – | – | Sort order (asc|desc) |
| source | – | – | Filter listing on their source |
| start | – | – | Page number/offset to fetch results (default 0) |
| state | – | – | Filter listing on State in which they are listed |
| stats | – | – | Field for which stats need to be generated (single field only) |
| stock_no | – | – | – |
| taxonomy_vins | – | – | – |
| transmission | – | – | – |
| trim | – | – | Filter listing on their trim |
| vdp_url | – | – | – |
| vehicle_type | – | – | – |
| version | – | – | – |
| vin | – | – | – |
| vins | – | – | – |
| year | – | – | Vehicle manufacturing year (e.g., 2020, 2021) |
| year_range | – | – | Year range in format "min-max" (e.g., "2019-2021") |
| ymmt | – | – | – |
| zip | – | – | Filter listing on ZIP around which they are listed |
Structured output declared, but exposes no named fields.
No examples provided.
search_uk_active_cars Search Active UK Vehicle Listings ~3,587
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.
| Name | Type | Req | Description |
|---|---|---|---|
| active_inventory_date_range | – | – | Active inventory date range filter. |
| base_ext_color | – | – | Base exterior color to match (alias for base_exterior_color). |
| base_exterior_color | – | – | Base exterior color to match (comma-separated values). |
| base_int_color | – | – | Base interior color to match (alias for base_interior_color). |
| base_interior_color | – | – | Base interior color to match (comma-separated values). |
| body_type | – | – | To filter listing on their body type (comma-separated values). |
| car_location_city | – | – | Car location city filter. |
| car_location_county | – | – | Car location county filter. |
| car_location_latitude | – | – | Car location latitude coordinate. |
| car_location_longitude | – | – | Car location longitude coordinate. |
| car_location_seller_name | – | – | Car location seller name filter. |
| car_location_street | – | – | Car location street filter. |
| car_location_zip | – | – | Car location ZIP filter. |
| car_type | – | – | Car type. Allowed values are - new / used. |
| city | – | – | To filter listing on City in which they are listed. |
| city_mpg_range | – | – | City mileage range (min-max format e.g. 1000-5000). |
| co2_emissions | – | – | CO2 emissions filter (comma-separated values). |
| combined_mpg_range | – | – | Combined mileage range for UK (min-max format). |
| country | – | – | To filter listing on Country (uk, england, scotland, northern ireland, wales). |
| county | – | – | To filter listing on county in which they are listed. |
| cylinders | – | – | To filter listing on their cylinders (comma-separated values). |
| dealer_id | – | – | Dealer id to filter the listings. |
| dealer_type | – | – | Filter based on dealer type (franchise or independent). |
| dedup | – | – | If true, will give results with is_searchable irrespective of dealer. |
| dom_180_range | – | – | Last 180 Days on Market range to filter cars. |
| dom_active_range | – | – | 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 STA… |
| dom_range | – | – | Days on Market range to filter cars (format: min-max e.g. 10-50). |
| doors | – | – | Doors to filter the cars on (comma-separated integer values). |
| dos_active_range | – | – | 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. |
| drivetrain | – | – | To filter listing on their drivetrain (comma-separated values). |
| engine | – | – | To filter listing on their engine (comma-separated values). |
| engine_size | – | – | Engine Size to match (comma-separated values from facets API). |
| engine_size_range | – | – | Engine size range filter. |
| ev_battery_capacity_range | – | – | EV battery capacity range filter. |
| ev_battery_type | – | – | Electric vehicle battery type filter. |
| ev_vehicle_range | – | – | Electric vehicle range filter. |
| exclude_dealer_ids | – | – | A list of dealer ids to exclude from result. |
| exclude_make | – | – | Make values to exclude from results. |
| exclude_mc_website_ids | – | – | A list of MC website ids to exclude from result. |
| exclude_sources | – | – | A list of sources to exclude from result. |
| exclude_write_off_category | – | – | To exclude write off category. |
| exterior_color | – | – | Exterior color to match (comma-separated values from facets API). |
| facet_sort | – | – | Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically |
| facets | – | – | 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 -… |
| fca_status | – | – | To filter on fca status. |
| fetch_all_photos | boolean | – | When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links. |
| first_seen_at_mc_days | – | – | First seen at MC days range in format "max-min" (e.g., "15-5"). |
| first_seen_at_mc_range | – | – | First seen at MC date range. |
| first_seen_at_source_days | – | – | First seen at source days range in format "max-min" (e.g., "15-5"). |
| first_seen_at_source_range | – | – | First seen at source date range. |
| first_seen_days | – | – | First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago). |
| first_seen_range | – | – | First seen date range (YYYYMMDD-YYYYMMDD format). |
| fuel_type | – | – | To filter listing on their fuel type (comma-separated values). |
| highway_mpg_range | – | – | Highway mileage range (min-max format e.g. 1000-5000). |
| include_build_object | boolean | – | 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 (stri… |
| include_dealer_object | boolean | – | 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_t… |
| include_mc_dealership_object | boolean | – | 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… |
| include_non_vin_listings | – | – | To include non vin listings. Default is false. |
| include_preferred_dealer_flag | – | – | Include preferred dealer flag. |
| insurance_group | – | – | Insurance group filter for UK vehicles. |
| interior_color | – | – | Interior color to match (comma-separated values from facets API). |
| inventory_count_range | – | – | Inventory count range to filter listings (min-max format). |
| is_vat_included | – | – | Boolean filter for VAT inclusion. |
| last_seen_days | – | – | Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago). |
| last_seen_range | – | – | Last seen date range (YYYYMMDD-YYYYMMDD format). |
| latitude | – | – | Latitude component of location (range: -90 to 90). |
| longitude | – | – | Longitude component of location (range: -180 to 180). |
| make | – | – | To filter listings on their make (comma-separated values). |
| match | – | – | Comma separated list of fields for exact match. |
| mc_category | – | – | Filter based on mc_category (Dealer, Dealership Group, etc.). |
| mc_dealer_id | – | – | To filter listings on their mc_dealer_id. |
| mc_dealership_group_id | – | – | To filter listings on their mc_dealership_group_id. |
| mc_dealership_group_name | – | – | To filter listings on their mc_dealership_group_name. |
| mc_location_id | – | – | To filter listings on their mc_location_id. |
| mc_rooftop_id | – | – | To filter listings on their mc_rooftop_id. |
| mc_sub_dealership_group_id | – | – | To filter listings on their mc_sub_dealership_group_id. |
| mc_sub_dealership_group_name | – | – | To filter listings on their mc_sub_dealership_group_name. |
| mc_website_id | – | – | Website id to filter the listings. |
| miles_range | – | – | Miles range to filter listings (format: min-max e.g. 1000-5000). |
| min_photo_links | – | – | Minimum number of photo links required. |
| min_photo_links_cached | – | – | Minimum number of cached photo links required. |
| model | – | – | To filter listings on their model (comma-separated values). |
| model_variant | – | – | Model variant filter. |
| msrp_range | – | – | MSRP range to filter listings (format: min-max e.g. 1000-5000). |
| nodedup | – | – | If true, API will give results without is_searchable. |
| num_owners | – | – | Number of owners filter. |
| owned | – | – | When used with dealer_id, returns listings owned by dealer. |
| performance_co2_range | – | – | Performance CO2 range filter. |
| photo_links | – | – | Boolean to include only listings that have photo_links. |
| photo_links_cached | – | – | Boolean to include only listings with cached photo_links. |
| plot | – | – | If true, results in around 25k coordinates with limited fields to plot. |
| postal_code | – | – | To filter listing on postal code around which they are listed. |
| preferred_dealers | – | – | Preferred dealers filter. |
| preferred_dealers_only | – | – | Filter to show only preferred dealers. |
| price_change | – | – | Price change filter for listings. |
| price_change_range | – | – | Price change range to filter listings. |
| price_range | – | – | Price range to filter listings (format: min-max e.g. 1000-5000). |
| radius | – | – | Radius around the search location in miles (max: 7000). |
| range_facets | – | – | Comma separated list of numeric fields for range facets. |
| rows | – | – | Number of results to return. Default is 10. Max is 50. |
| seating_capacity | – | – | To filter on vehicle seating capacity. |
| sort_by | – | – | Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above. |
| sort_order | – | – | Sort order - asc or desc. Default sort order is asc. |
| source | – | – | To filter listing on their source (comma-separated URLs). |
| start | – | – | Page number to fetch results. Default is 0. Max pagination: 10000. |
| state | – | – | To filter listing on State in which they are listed. |
| stats | – | – | List of fields for which stats need to be generated. |
| stock_no | – | – | To filter listing on their stock number on lot. |
| transmission | – | – | To filter listing on their transmission (comma-separated values). |
| trim | – | – | To filter listing on their trim (comma-separated values). |
| ulez_compliant | – | – | Filter for ULEZ compliant vehicles. |
| uvc_id | – | – | UVC (Universal Vehicle Code) ID filter. |
| variant | – | – | To filter listing on their variant (comma-separated values). |
| vdp_url | – | – | Vehicle details page URL filter. |
| vehicle_registration_date_range | – | – | Vehicle registration date range (YYYYMMDD-YYYYMMDD). |
| vehicle_registration_mark | – | – | Vehicle Registration Mark filter. |
| vehicle_type | – | – | To filter listing on their vehicle type. |
| vrm | – | – | Vehicle Registration Mark (VRM) filter. |
| wheelbase_category | – | – | To filter listing on their wheelbase category. |
| write_off_category | – | – | Write off category filter. |
| year | – | – | To filter listing on their year (comma-separated values). |
| year_range | – | – | Year range to filter listings (format: min-max e.g. 2019-2021). |
| ymmt | – | – | Comma separated list of Year, Make, Model, Trim combinations. |
| zip | – | – | To filter listing on ZIP around which they are listed. |
Structured output declared, but exposes no named fields.
No examples provided.
search_uk_recent_cars Search UK Expired Listings (Past 90 Days) ~3,630
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.
| Name | Type | Req | Description |
|---|---|---|---|
| active_inventory_date_range | – | – | Active inventory date range filter. |
| base_ext_color | – | – | Base exterior color to match (alias for base_exterior_color). |
| base_exterior_color | – | – | Base exterior color to match (comma-separated values). |
| base_int_color | – | – | Base interior color to match (alias for base_interior_color). |
| base_interior_color | – | – | Base interior color to match (comma-separated values). |
| body_subtype | – | – | Body subtype to filter listings (comma-separated values from facets API). |
| body_type | – | – | To filter listing on their body type (comma-separated values). |
| car_include_finance | – | – | Boolean param to search for listings that include finance options. |
| car_include_lease | – | – | Boolean param to search for listings that include leasing options. |
| car_type | – | – | Car type. Allowed values are - new / used / certified. |
| city | – | – | To filter listing on City in which they are listed. |
| city_mpg_range | – | – | City mileage range for UK (min-max format e.g. 1000-5000). |
| combined_mpg_range | – | – | Combined mileage range for UK (min-max format). |
| country | – | – | To filter listing on Country (uk, england, scotland, northern ireland, wales). |
| county | – | – | To filter listing on county in which they are listed. |
| cylinders | – | – | To filter listing on their cylinders (comma-separated values). |
| dealer_id | – | – | Dealer id to filter the listings. |
| dealer_name | – | – | Filter listings on dealer_name. |
| dealer_type | – | – | Filter based on dealer type (franchise or independent). |
| dealership_group_name | – | – | Name of the dealership group to search for. |
| dedup | – | – | If true, will give results with is_searchable irrespective of dealer. |
| dom_180_range | – | – | Last 180 Days on Market range to filter cars. |
| dom_active_range | – | – | 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 STALENES… |
| dom_range | – | – | Days on Market range to filter cars (format: min-max e.g. 10-50). |
| doors | – | – | Doors to filter the cars on (comma-separated integer values). |
| dos_active_range | – | – | 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. |
| drivetrain | – | – | To filter listing on their drivetrain (comma-separated values). |
| engine | – | – | To filter listing on their engine (comma-separated values). |
| engine_aspiration | – | – | Engine Aspiration to match (comma-separated values from facets). |
| engine_block | – | – | Engine Block to match (comma-separated values from facets). |
| engine_size | – | – | Engine Size to match (comma-separated values from facets API). |
| engine_size_range | – | – | Engine size range filter (min-max format). |
| exclude_certified | – | – | Boolean param to exclude certified cars from search results. |
| exclude_dealer_ids | – | – | A list of dealer ids to exclude from result. |
| exclude_make | – | – | Make values to exclude from results. |
| exclude_mc_website_ids | – | – | A list of MC website ids to exclude from result. |
| exclude_sources | – | – | A list of sources to exclude from result. |
| exclude_write_off_category | – | – | To exclude write off category. |
| expired | – | – | Boolean flag to either fetch only the expired listings or active ones. |
| exterior_color | – | – | Exterior color to match (comma-separated values from facets API). |
| facet_sort | – | – | Controls sort order of facet terms: - count (default): Sort by frequency (highest first) - index: Sort alphabetically |
| facets | – | – | 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 -… |
| fca_status | – | – | To filter on fca status. |
| fetch_all_photos | boolean | – | When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links. |
| finance_down_payment | – | – | Search listings with exact down payment in finance offers or range. |
| finance_down_payment_per | – | – | Search listings with exact down payment percentage or range. |
| finance_emp | – | – | Search listings with finance Estimated Monthly Payment (EMI) or range. |
| finance_loan_apr | – | – | Search listings with finance Annual Percentage Rate or range. |
| finance_loan_term | – | – | Search listings with exact finance loan term or range. |
| first_seen_at_mc_days | – | – | First seen at MC days range in format "max-min" (e.g., "15-5"). |
| first_seen_at_mc_range | – | – | First seen at MC date range. |
| first_seen_at_source_days | – | – | First seen at source days range in format "max-min" (e.g., "15-5"). |
| first_seen_at_source_range | – | – | First seen at source date range. |
| first_seen_days | – | – | First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago). |
| first_seen_range | – | – | First seen date range (YYYYMMDD-YYYYMMDD format). |
| fuel_type | – | – | To filter listing on their fuel type (comma-separated values). |
| highway_mpg_range | – | – | Highway mileage range for UK (min-max format e.g. 1000-5000). |
| include_build_object | boolean | – | 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 (stri… |
| include_dealer_object | boolean | – | 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_t… |
| include_mc_dealership_object | boolean | – | 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… |
| include_non_vin_listings | – | – | To include non vin listings. Default is false. |
| include_relevant_links | – | – | To include_relevant_links. Default is true. |
| insurance_group | – | – | Insurance group filter for UK vehicles. |
| interior_color | – | – | Interior color to match (comma-separated values from facets API). |
| is_vat_included | – | – | Boolean filter for VAT inclusion. |
| last_seen_days | – | – | Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago). |
| last_seen_range | – | – | Last seen date range (YYYYMMDD-YYYYMMDD format). |
| latitude | – | – | Latitude component of location (range: -90 to 90). |
| lease_down_payment | – | – | Search listings with exact down payment in lease offers or range. |
| lease_emp | – | – | Search listings with lease Estimated Monthly Payment (EMI) or range. |
| lease_term | – | – | Search listings with exact lease term, or range (min-max e.g. 30-60). |
| longitude | – | – | Longitude component of location (range: -180 to 180). |
| make | – | – | To filter listings on their make (comma-separated values). |
| match | – | – | Comma separated list of fields for exact match (e.g., year,make,model,trim). |
| mc_category | – | – | Filter based on mc_category (Dealer, Dealership Group, etc.). |
| mc_dealer_id | – | – | To filter listings on their mc_dealer_id. |
| mc_dealership_group_id | – | – | To filter listings on their mc_dealership_group_id. |
| mc_dealership_group_name | – | – | To filter listings on their mc_dealership_group_name. |
| mc_location_id | – | – | To filter listings on their mc_location_id. |
| mc_rooftop_id | – | – | To filter listings on their mc_rooftop_id. |
| mc_sub_dealership_group_id | – | – | To filter listings on their mc_sub_dealership_group_id. |
| mc_sub_dealership_group_name | – | – | To filter listings on their mc_sub_dealership_group_name. |
| mc_website_id | – | – | Website id to filter the listings. |
| miles_range | – | – | Miles range to filter listings (format: min-max e.g. 1000-5000). |
| model | – | – | To filter listings on their model (comma-separated values). |
| model_variant | – | – | Model variant filter. |
| msrp_range | – | – | MSRP range to filter listings (format: min-max e.g. 1000-5000). |
| nodedup | – | – | If true, API will give results without is_searchable. |
| num_owners | – | – | Number of owners filter. |
| owned | – | – | When used with dealer_id, returns listings owned by dealer. |
| photo_links | – | – | Boolean to include only listings that have photo_links. |
| photo_links_cached | – | – | Boolean to include only listings with cached photo_links. |
| plot | – | – | If true, results in around 25k coordinates with limited fields to plot. |
| postal_code | – | – | To filter listing on postal code around which they are listed. |
| price_change_range | – | – | Price change range to filter listings. |
| price_range | – | – | Price range to filter listings (format: min-max e.g. 1000-5000). |
| radius | – | – | Radius around the search location in miles (max: 100 for recent search). |
| range_facets | – | – | Comma separated list of numeric fields for range facets. |
| rows | – | – | Number of results to return. Default is 10. Max is 50. |
| seating_capacity | – | – | To filter on vehicle seating capacity. |
| sold | – | – | Boolean parameter to fetch only sold listings. |
| sort_by | – | – | Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above. |
| sort_order | – | – | Sort order - asc or desc. Default sort order is asc. |
| source | – | – | To filter listing on their source (comma-separated URLs). |
| start | – | – | Page number to fetch results. Default is 0. Max pagination: 10000. |
| state | – | – | To filter listing on State in which they are listed. |
| stats | – | – | List of fields for which stats need to be generated. |
| stock_no | – | – | To filter listing on their stock number on lot. |
| transmission | – | – | To filter listing on their transmission (comma-separated values). |
| trim | – | – | To filter listing on their trim (comma-separated values). |
| ulez_compliant | – | – | Filter for ULEZ compliant vehicles. |
| variant | – | – | To filter listing on their variant (comma-separated values). |
| vdp_url | – | – | Vehicle details page URL filter. |
| vehicle_type | – | – | To filter listing on their vehicle type (comma-separated values). |
| vrm | – | – | Vehicle Registration Mark (VRM) filter. |
| wheelbase_category | – | – | To filter listing on their wheelbase category. |
| write_off_category | – | – | Write off category filter. |
| year | – | – | To filter listing on their year (comma-separated values). |
| year_range | – | – | Year range to filter listings (format: min-max e.g. 2019-2021). |
| ymmt | – | – | Comma separated list of Year, Make, Model, Trim combinations. |
| zip | – | – | To filter listing on ZIP around which they are listed. |
Structured output declared, but exposes no named fields.
No examples provided.
How do I install the MarketCheck API MCP server?
MarketCheck API is a hosted endpoint at https://developers.marketcheck.com/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · developers.marketcheck.com
claude mcp add --transport http com-marketcheck-api 'https://developers.marketcheck.com/api/mcp'
What is the MarketCheck API MCP server?
MarketCheck API is an MCP server listed in the public MCP registry as com.marketcheck/api. MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history. This page covers its hosted endpoint (https://developers.marketcheck.com/api/mcp).
Is the MarketCheck API MCP server safe to use?
MarketCheck API scores 89 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the MarketCheck API MCP server expose?
MarketCheck API exposes 13 tools: search_active_cars, search_past_90_days, predict_price_with_comparables, get_car_history, decode_vin_neovin, and 8 more. Their descriptions and schemas cost roughly 18,843 tokens of context every time the server is loaded.
Does the MarketCheck API MCP server require authentication?
Yes. MarketCheck API asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the MarketCheck API MCP server still maintained?
MarketCheck API is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.