MarketCheck MCP servers
Automotive market data for AI agents. MarketCheck runs three hosted Model Context Protocol servers that give Claude, ChatGPT, Cursor, VS Code and other MCP clients live access to vehicle listings, VIN decoding, price predictions, listing history and ready-made market reports for the US, Canada and the UK.
All three are remote (Streamable HTTP) servers. There is nothing to install or run locally: add the URL to your client and sign in where needed.
| Server | URL | Auth | Best for |
|---|---|---|---|
| MarketCheck API | https://developers.marketcheck.com/api/mcp |
OAuth with your MarketCheck developer account (or an API key, see below) | Developers, analysts and agents that need raw listing, pricing and VIN data |
| MarketCheck Docs | https://developers.marketcheck.com/api/docs-mcp |
None, free | Coding assistants writing an integration against the MarketCheck REST API |
| MarketCheck AI Desk | https://ai.marketcheck.com/mcp |
OAuth with your MarketCheck AI Desk account | Dealers, appraisers, lenders, insurers and car buyers who want finished reports inside chat |
These servers are also published in the official MCP Registry as com.marketcheck/api, com.marketcheck/docs and com.marketcheck/marketcheck-ai-reports. Copies of the published server.json files are in servers/.
MarketCheck API
The MarketCheck data API as MCP tools. Search active and recently off-market dealer listings, predict a vehicle's market price with the comparables behind it, pull a VIN's listing history and decode VINs with NeoVIN.
Who it is for: developers, data teams and agent builders who already use (or want to try) the MarketCheck API and want their assistant to query it directly.
Auth: OAuth. Add the URL, sign in with your MarketCheck developer account, choose which tools to allow and which API key to use, then click Allow. Usage counts against the plan of the key you pick, and you can change or revoke access any time from API Keys in the developer portal. Don't have a key yet? Sign up at developers.marketcheck.com.
For clients that cannot do OAuth, the same tools are available with an API key in the URL: https://api.marketcheck.com/mcp?api_key=YOUR_API_KEY (see the MCP getting-started guide). Treat that URL like a password.
| Tool | What it does |
|---|---|
search_active_cars |
Search active dealer listings in the US and Canada with 100+ filters: make, model, trim, year, price, miles, ZIP and radius, features. |
search_past_90_days |
Search US listings that left the market in the last 90 days, with their last asking prices, counts and days on market. |
predict_price_with_comparables |
Predict the market price for a VIN, returned with the comparable listings used to derive it. |
get_car_history |
Listing history for a VIN: asking-price changes, dealers and days on market. |
decode_vin_neovin |
Decode a VIN with NeoVIN: full specs, installed options, packages and trim. |
search_uk_active_cars |
Search active dealer listings in the UK. |
search_uk_recent_cars |
Search UK listings that left the market in the last 90 days. |
get_sold_summary |
US market summaries of vehicles that left the market, ranked and grouped by make, model, geography and more. |
get_server_info |
Server details and the tool catalog. |
MarketCheck Docs
The complete MarketCheck API documentation inside your coding assistant. It searches the docs, reads any page and returns the exact parameters and a real sample request and response for every REST endpoint, so the assistant writes working integration code the first time.
Who it is for: anyone writing code against the MarketCheck REST API.
Auth: none. It is free, needs no sign-in and does not count against any plan. It returns documentation only; to run live queries, add the MarketCheck API server as well.
| Tool | What it does |
|---|---|
search_docs |
Semantic search over the full API documentation, rate plans and API policies, with source links. |
get_doc_page |
Fetch one full documentation page as Markdown, including parameter tables and curl examples. |
list_endpoints |
List every documented REST endpoint with method, path, title, region and docs link. |
get_endpoint |
Exact reference for one endpoint: every query parameter, a real sample request and a sample response. |
get_plans_and_limits |
Current published rate plans, monthly quotas and rate limits for a region. |
MarketCheck AI Desk
On-demand vehicle valuations and market reports that run inside Claude or ChatGPT (or any MCP client) and also open as shareable hosted web reports. Ask in plain English and the assistant picks the right report.
Who it is for: dealers, appraisers, insurers, lenders and car buyers who want a finished answer rather than raw data.
Auth: OAuth. Add the URL, sign in to ai.marketcheck.com on the consent screen, then click Allow. Reports are paid from your AI Desk balance, and each report states its price before it runs. Browsing local inventory and the account tools are free. Most reports cover the US; the Vehicle Valuation Report and Full Market Capture also run for UK and Canada accounts.
Reports
| Tool | What it does |
|---|---|
generate_vehicle_valuation_report |
Vehicle Valuation Report: market valuation for one VIN with comparables, listing history and trend. |
generate_batch_vehicle_valuation |
Batch Vehicle Valuation: value a whole list of VINs in one run. |
generate_fmv_appraisal_worksheet |
ACV (Actual Cash Value) Worksheet: hand-picked comparables, mileage adjustment and insurer-offer comparison, with a branded Excel file. |
generate_total_loss_valuation_worksheet |
Total Loss Valuation Worksheet: clean-title comparables, title-brand markdown and the gap to the carrier's offer. |
generate_total_loss_report |
Total Loss Report: actual cash value for a totaled vehicle, with supporting evidence. |
generate_diminished_value_worksheet |
Diminished Value Worksheet: post-repair loss in value, argued from comparables the appraiser picks. |
generate_diminished_value_report |
Diminished Value Report: how much value an accident took, even after a quality repair. |
generate_trade_in_valuation_report |
Trade-In Valuation Report: trade-in versus private sale versus retail value for a car. |
generate_used_car_health_check |
Used Car Health Check: spec, history, price changes and red flags before you buy. |
generate_negotiation_brief |
Pre-Purchase Negotiation Brief: what to offer for a listing and how to say it. |
generate_vin_price_check |
VIN Price Check: lowest advertised price of record for a VIN, with source and timeline. |
generate_window_sticker |
Window Sticker: a factory-style window sticker PDF for a VIN, branded with your dealer profile. |
generate_stocking_guide |
Stocking Guide: what to stock and how to price it for a make and model in your area. |
generate_market_movers |
Market Movers: nameplates clearing faster than local supply. |
generate_market_quick_look |
Market Quick Look: local inventory mix, average asking prices, days on market and recent price drops. |
generate_full_market_capture |
Full Market Capture: your whole local market captured in one run, then queryable all day. |
generate_brand_model_market_pulse |
Brand & Model Market Pulse: used-market asking prices, CPO premium, days on market and top configurations. |
generate_lot_pricing_scan |
Lot Pricing Scan: every unit on a dealer's lot checked for under- or over-pricing against the market. |
generate_pricing_compliance_report |
Pricing Compliance Report: audit a dealer's inventory for advertised-price inconsistencies. |
generate_acquisition_fit_report |
Acquisition Fit Report: rank auction or trade-in candidates by how well they fit your lot. |
generate_placement_report |
Best-Buyer Placement Report: find the best-fit dealer or rooftop to buy each vehicle. |
generate_aged_inventory_prospector |
Aged Inventory Prospector: dealers in a ZIP sitting on the most aged inventory, with contact details. |
generate_lender_dealer_prospector |
Lender Dealer Prospector: dealers whose inventory matches a lender's target profile, ranked by fit. |
Shopping and data tools
| Tool | What it does |
|---|---|
browse_local_inventory |
Free. Browse cars for sale near a US ZIP code in an interactive grid with photos, asking prices and dealer links. |
search_active_cars |
Raw search over active US dealer listings. |
search_past_90_days |
Raw search over listings that left the market in the last 90 days. |
predict_price_with_comparables |
MarketCheck Price prediction for a VIN, with comparables. |
get_car_history |
Listing history for a VIN. |
decode_vin_neovin |
Full NeoVIN decode for a VIN. |
get_market_insights |
Beta. Monthly US market statistics (units, average asking price, days on market) ranked by make, model, dealer group and more. |
Account tools (free)
| Tool | What it does |
|---|---|
list_available_reports |
The report catalog with prices, descriptions and inputs. |
get_account_status |
Your AI Desk account and balance. |
add_credits |
Top up your balance. |
update_auto_topup |
Turn automatic top-up on or off, or change its amount. |
get_payment_method |
The saved card's brand, last 4 digits and expiry. |
list_invoices |
Your recent invoices. |
get_invoice |
Full details of one invoice. |
list_recent_reports |
Reports you have run recently. |
get_help |
How AI Desk works and how to get the best results. |
create_support_ticket |
Open a support ticket from chat. |
list_support_tickets |
Status of your support tickets. |
submit_feedback |
Send feedback or a feature request. |
Install
Use the URL of the server you want from the table at the top. The examples below use all three; keep only the ones you need. For the API server, clients without OAuth can use https://api.marketcheck.com/mcp?api_key=YOUR_API_KEY instead.
Claude (claude.ai and Claude Desktop)
- Open your profile menu, then Customize, Connectors, Add custom connector.
- Enter a name (for example
MarketCheck AI Desk) and the server URL, for examplehttps://ai.marketcheck.com/mcp. No API key is needed. - Click Add, then Connect, sign in and approve access.
Custom connectors are available on Claude Pro, Max, Team and Enterprise. On Team and Enterprise, an admin may need to add the connector for the workspace. AI Desk also has a one-click Add to Claude button at ai.marketcheck.com/install.
ChatGPT (developer mode)
- In ChatGPT settings, turn on Developer mode.
- Add a new plugin (connector), give it a name and paste the server URL (for example
https://ai.marketcheck.com/mcp) as the connection. Keep OAuth as the authentication method. - Save, sign in on the MarketCheck consent screen and click Allow.
Custom MCP connectors need a paid ChatGPT plan (Plus, Pro, Team, Business or Enterprise). ChatGPT shows a notice that custom MCP servers introduce risk; that is expected.
Claude Code
claude mcp add --transport http marketcheck-ai-desk https://ai.marketcheck.com/mcp
claude mcp add --transport http marketcheck-api https://developers.marketcheck.com/api/mcp
claude mcp add --transport http marketcheck-docs https://developers.marketcheck.com/api/docs-mcp
Then run /mcp inside Claude Code and choose Authenticate for the AI Desk and API servers. The docs server needs no sign-in.
Cursor
Save as .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:
{
"mcpServers": {
"marketcheck-ai-desk": { "url": "https://ai.marketcheck.com/mcp" },
"marketcheck-api": { "url": "https://developers.marketcheck.com/api/mcp" },
"marketcheck-docs": { "url": "https://developers.marketcheck.com/api/docs-mcp" }
}
}
Cursor opens a sign-in window for the servers that need one.
VS Code (GitHub Copilot agent mode)
Save as .vscode/mcp.json in your workspace, or run MCP: Open User Configuration for a global setup:
{
"servers": {
"marketcheck-ai-desk": { "type": "http", "url": "https://ai.marketcheck.com/mcp" },
"marketcheck-api": { "type": "http", "url": "https://developers.marketcheck.com/api/mcp" },
"marketcheck-docs": { "type": "http", "url": "https://developers.marketcheck.com/api/docs-mcp" }
}
}
Or from a terminal:
code --add-mcp '{"name":"marketcheck-docs","type":"http","url":"https://developers.marketcheck.com/api/docs-mcp"}'
Cline
Open the MCP Servers panel, choose Configure MCP Servers and add to cline_mcp_settings.json:
{
"mcpServers": {
"marketcheck-docs": {
"type": "streamableHttp",
"url": "https://developers.marketcheck.com/api/docs-mcp"
},
"marketcheck-api": {
"type": "streamableHttp",
"url": "https://api.marketcheck.com/mcp?api_key=YOUR_API_KEY"
}
}
}
The API server entry uses the API-key URL so it works without OAuth. Replace YOUR_API_KEY with a key from developers.marketcheck.com. AI Desk signs in with OAuth, so use it from a client that supports MCP OAuth.
Windsurf
Add to mcp_config.json (Windsurf: ~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"marketcheck-ai-desk": { "serverUrl": "https://ai.marketcheck.com/mcp" },
"marketcheck-api": { "serverUrl": "https://developers.marketcheck.com/api/mcp" },
"marketcheck-docs": { "serverUrl": "https://developers.marketcheck.com/api/docs-mcp" }
}
}
Other clients
Any client that speaks MCP over Streamable HTTP can use the same URLs. Add the URL as a remote server and approve the consent screen the first time you connect.
Try it
- "Decode VIN 1HGCM82633A123456 and show its listing history."
- "What are 2021 Toyota RAV4 XLEs listed for within 50 miles of 60601?"
- "Value this car: VIN 1HGCV2F38LA000777, 42,000 miles, ZIP 60601."
- "Using the MarketCheck docs, write a Python client for the listing-history endpoint with retry handling."
Data semantics
- Every price is an asking (listed) price as advertised by the dealer, not a transaction price.
- Listings that have left the market (off-market or "past 90 days" listings) carry their last asking price.
- The MarketCheck Price is a predicted market listing price for the vehicle, based on comparable listings.
Links
- Documentation: docs.marketcheck.com
- API keys and the developer portal: developers.marketcheck.com
- MCP setup in the portal: developers.marketcheck.com/mcp
- MarketCheck AI Desk: ai.marketcheck.com
Support
Email [email protected]. For AI Desk you can also open a ticket from chat with the create_support_ticket tool.
License
The README, configuration snippets and server.json files in this repository are released under the MIT License. The MarketCheck servers, APIs and data are proprietary services governed by MarketCheck's terms of use; this license does not cover them. MarketCheck and the MarketCheck logo are trademarks of MarketCheck.