# OpenDealer MCP Server MCP server

Automotive inventory search for AI assistants: vehicles, dealers, deals, and market data.

## Links
- Registry page: https://www.getdrio.com/mcp/app-opendealer-mcp
- Website: https://opendealer.pro

## Install
- Endpoint: https://mcp.opendealer.app/rpc
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.opendealer.app/rpc
- Header: Authorization

## Tools
- search_vehicles (Search Vehicles) - Search for vehicles across dealerships (Meilisearch-backed NL + structured filters).

Preferred tool order for assistants:
1. list_facets or list_research_makes/list_research_models to discover valid values
2. filter_vehicles when make/model/year/price/location are known (exact hard filters)
3. search_vehicles with q for prose/conceptual queries (optionally useLlmSearchPath=true)
4. get_vehicle / get_deal_score / research_model for depth

When the ask implies analysis (good deal?, safety, budget, timing, dealer plan), continue with a shopping playbook from initialize instructions or resource opendealer://assistant/shopping-playbooks — do not stop at raw search results.

Location modes (choose ONE): zip+radius, lat+lng+radius, city+state+radius, county+state+radius — or embed location in q.

Forgiving matching: model variants, color families, typo tolerance. Hard caps (price_max, year, radius) are never relaxed. mode=hybrid for conceptual queries.

CRITICAL: Use the 'url' field from each result. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- filter_vehicles (Filter Vehicles (Structured)) - Preferred structured inventory lookup when make/model/year/color/location are known.

Uses exact hard filters (keyword mode, no embeddings) via the Runtime /v1/llm/filter path. Resolve exact make/model names with list_research_makes and list_research_models first. For prose or conceptual queries, use search_vehicles instead.

Often the first step in shopping playbooks (budget_coach, safety_first, price_drop_sniper, dealer_crawl). After results, chain get_deal_score / get_vehicle_history / check_recalls / compare_vehicles when the user needs a recommendation, not just a list. See opendealer://assistant/shopping-playbooks.

CRITICAL: Use the 'url' field from each result. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- list_facets (List Inventory Facets) - Discover available filter values and counts (makes, body types, fuel types, price/year ranges) for the live inventory.

Call this before filter_vehicles when you need valid dimension values. Optional make/near/radius scopes the facet counts. Endpoint: https://mcp.opendealer.app/rpc
- list_research_makes (List Research Makes) - Browse the research catalog of vehicle makes (with model and inventory counts). Use to resolve exact make names/slugs before filter_vehicles or research_model. Endpoint: https://mcp.opendealer.app/rpc
- list_research_models (List Research Models) - List models for a make from the research catalog (MSRP/body summaries). Use before filter_vehicles or research_model when the model name is uncertain. Endpoint: https://mcp.opendealer.app/rpc
- get_vehicle (Get Vehicle Details) - Get complete details for a specific vehicle by VIN.

Returns comprehensive Schema.org Vehicle data including:
• Full specifications (engine, transmission, drivetrain)
• High-resolution images
• Current pricing and availability
• NHTSA NCAP safety rating summary (when available)
• NHTSA open recall summary (YMM-granular, when available)
• Dealer contact information

Starting point for the vehicle_dossier playbook. For buy/no-buy questions, continue with get_deal_score → get_vehicle_history → check_recalls → get_similar_vehicles.

CRITICAL: Only use the 'url' field from the response. NEVER invent URLs. NEVER construct URLs with opendealer domains - the 'url' field points to the dealer's website. Endpoint: https://mcp.opendealer.app/rpc
- check_recalls (Check NHTSA Recalls) - Get NHTSA open safety recalls for a vehicle by VIN.

Returns recall campaigns resolved at the year/make/model level (YMM-granular). A recall listed for the model year may not apply to every VIN — the response includes NHTSA's disclaimer and campaign details (component, summary, remedy status, Park It / Park Outside advisories).

Use this when a shopper asks about recalls, safety campaigns, or whether a specific model has open NHTSA notices. Required step in vehicle_dossier and safety_first playbooks; always include the YMM-granularity disclaimer. Endpoint: https://mcp.opendealer.app/rpc
- get_dealer (Get Dealership Details) - Get comprehensive information about a specific dealership.

Returns Google-enriched dealer knowledge optimized for assistants:
• Name, address, phone, website
• Google rating, review count, hours, business status
• Inventory count and OpenDealer profile links
• Contact points for sales / customer service

Use this when a shopper asks "tell me about X dealership" or needs hours/ratings for a known dealer. Prefer a slug from dealers_near or search results.

CRITICAL: Only use URL fields from the response (website, urls.*). NEVER invent or construct URLs. Endpoint: https://mcp.opendealer.app/rpc
- get_safety_rating (Get NHTSA Safety Rating) - Get NHTSA 5-Star Safety Ratings for a year/make/model (no VIN required).

Answers questions like "is a 2023 RAV4 safe for my family" with:
• Overall and crash-test star ratings (when published)
• Rollover rating / possibility
• NHTSA-evaluated ADAS availability (ESC, FCW, LDW)

Ratings are model-year granular from the NHTSA NCAP cache. If no confident rating exists, the tool reports that honestly rather than guessing. For VIN-specific listing details use get_vehicle; for open recalls use check_recalls.

CRITICAL: Only use the 'sourceUrl' field from the response for NHTSA links. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- get_vehicle_history (Get Vehicle Price History) - Get OpenDealer listing history for a VIN: price changes, days on lot, and status.

Answers "has this VIN dropped in price" and days-on-lot narratives from retained snapshots (including vehicles that left a dealer feed). Returns:
• Chronological price history with per-snapshot changes
• Days on market / lot signals and badges (price_drop, long_on_lot)
• Active vs no-longer-listed status when known

Does not invent a deal score for sold vehicles — use get_deal_score for live market scoring. Essential for price_drop_sniper and vehicle_dossier playbooks when shoppers ask about reductions or negotiation leverage. CRITICAL: Only use URL fields from the response when present. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- dealers_near (Find Nearby Dealers) - Find dealerships near a location.

Location modes (choose ONE):
• zip + radius (miles)
• lat + lng + radius
• city + state + radius
• county + state + radius

Returns dealer information including:
• Name, address, phone, website
• Distance from search location
• Current inventory count
• Business hours (when available) Endpoint: https://mcp.opendealer.app/rpc
- dealer_inventory (Browse Dealer Inventory) - Browse the complete inventory of a specific dealership.

IMPORTANT: Use the exact dealer slug from a previous dealers_near or search_vehicles response. Do NOT guess dealer IDs.

Useful when a user wants to see what a particular dealer has in stock.
Supports all vehicle filters (make, model, price, etc.).

CRITICAL: Only use URLs from the response. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- compare_vehicles (Compare Vehicles) - Compare 2-5 vehicles side by side.

Provide a list of VINs to compare. Returns a structured comparison including:
• Specifications comparison (engine, MPG, features)
• Price comparison with market context
• Pros and cons for each vehicle
• Recommendation based on value Endpoint: https://mcp.opendealer.app/rpc
- get_deal_score (Get Deal Score) - Get AI-powered deal scoring and market insights for a vehicle.

Returns comprehensive analysis including:
• Deal score (1-100) with rating (Great, Good, Fair, Poor)
• Price comparison vs market average
• Days on lot analysis
• Price history and trends
• Similar vehicles in the market

Core step in vehicle_dossier, budget_coach, price_drop_sniper, and dealer_crawl playbooks. Pair with get_vehicle_history and check_recalls for buy/no-buy answers. Endpoint: https://mcp.opendealer.app/rpc
- get_market_overview (Get Market Overview) - Get high-level automotive market statistics.

Returns aggregated market data including:
• Total vehicles and dealers in inventory
• Average pricing by segment
• Top makes by volume
• Market velocity indicators
• New vs Used breakdown Endpoint: https://mcp.opendealer.app/rpc
- get_market_segment (Get Market Segment Data) - Get detailed pricing and market data for a specific vehicle segment.

Useful for understanding fair market value for a make/model/year combination.
Returns pricing statistics including:
• Average, median, min, max prices
• Price percentiles (10th, 25th, 75th, 90th)
• Average mileage and days on lot
• Certified vs non-certified pricing difference Endpoint: https://mcp.opendealer.app/rpc
- list_market_segments (List Market Segments) - Browse market segments with pricing statistics (modelcode, median price, sample size). Use to discover modelcodes for get_market_segment / get_market_trends. Endpoint: https://mcp.opendealer.app/rpc
- get_market_trends (Get Market Price Trends) - Price trends over time for a market segment (modelcode). Returns timeline of median/avg prices and days-on-lot. Endpoint: https://mcp.opendealer.app/rpc
- get_market_velocity (Get Market Velocity) - How quickly vehicles sell by segment (fastest/slowest days on lot). Optional make/type filters. Endpoint: https://mcp.opendealer.app/rpc
- compare_market (Compare Market Segments) - Compare pricing across market segments. Provide modelcodes[] or make (optionally with model). Endpoint: https://mcp.opendealer.app/rpc
- get_suggested_rates (Get Suggested Finance Rates) - National average suggested auto loan APRs (not a credit offer). Optional filters: condition (new/used), term_months (36–84), credit_tier. Endpoint: https://mcp.opendealer.app/rpc
- research_model (Research a Vehicle Model) - Get the full research payload for a vehicle model (not a specific listing).

Returns manufacturer reference data joined with live market data:
• All trims with MSRPs, engine/body specs, and EPA fuel economy
• NHTSA 5-Star safety ratings and open recall count
• Live inventory count and price range on OpenDealer

Use this when a shopper asks "tell me about the Honda Civic", "what trims does the RAV4 come in", or "how much is a 2025 F-150". For a specific listed vehicle, use get_vehicle with a VIN instead.

CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs. Endpoint: https://mcp.opendealer.app/rpc
- compare_models (Compare Vehicle Models) - Compare 2-4 vehicle models side by side (model-level, not specific listings).

Provide composite make-model slugs like "honda-civic" or "toyota-corolla". Returns:
• Winner-by-dimension deltas: price, fuel economy, horsepower, seating, towing, NHTSA safety, live median listing price
• Full research payload for each model (trims, MSRPs, specs)

Use this for "Civic vs Corolla" style questions. To compare specific listed vehicles by VIN, use compare_vehicles instead.

CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs. Endpoint: https://mcp.opendealer.app/rpc
- get_vehicle_rankings (Get Vehicle Rankings) - Get data-driven vehicle rankings (e.g., best SUVs, most fuel-efficient cars).

Call without arguments to list all ranking categories. Pass a category slug (e.g., "best-suvs") for the full scored ranking.

Rankings are computed from public data with a published methodology: NHTSA safety ratings, EPA fuel economy, manufacturer pricing, and live market availability. There is no paid placement; each entry includes its transparent score breakdown.

CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs. Endpoint: https://mcp.opendealer.app/rpc
- get_similar_vehicles (Get Similar Vehicles) - Find similar on-lot vehicles for a VIN ("you may also like"). Uses semantic similarity when available, with make/model filter fallback.

CRITICAL: Use the 'url' or listing fields from each result. NEVER invent URLs. Endpoint: https://mcp.opendealer.app/rpc
- ui_select_vehicle (Select Vehicle (App)) - App-only: record a vehicle selection from the results widget. Not for model use — hosts filter via _meta.ui.visibility. Endpoint: https://mcp.opendealer.app/rpc
- ui_page_vehicle_results (Page Vehicle Results (App)) - App-only: paginate or refresh vehicle results using the same Runtime paths as filter_vehicles / search_vehicles (geo-correct). No widget remount — omit resourceUri. Not for model use. Endpoint: https://mcp.opendealer.app/rpc

## Resources
- opendealer://assistant/shopping-playbooks - Multi-tool shopping playbooks for AI assistants: VIN dossier, budget coach, model shortlist, timing advisor, dealer crawl, safety-first, price-drop sniper, trim-to-lot, value hunter, and closer. Read this to chain OpenDealer tools creatively. MIME type: text/markdown
- opendealer://inventory/overview - High-level statistics about the current vehicle inventory including total count, price ranges, and popular makes. MIME type: application/json
- opendealer://market/overview - Aggregated market statistics including pricing trends, velocity metrics, and segment analysis. MIME type: application/json
- opendealer://makes - List of all vehicle makes available in the inventory with counts. MIME type: application/json
- opendealer://body-types - List of all vehicle body types available with counts. MIME type: application/json
- ui://opendealer/vehicle-search@808f536d - Conversation carousel of vehicle tool results (search/filter/similar). No in-widget filters. MIME type: text/html;profile=mcp-app
- ui://opendealer/vehicle-detail@aa6b9195 - Compact listing card with price, key specs, dealer, and CTAs. MIME type: text/html;profile=mcp-app
- ui://opendealer/dealer-map@8b283d24 - Map view of nearby dealerships returned by dealers_near. MIME type: text/html;profile=mcp-app
- ui://opendealer/dealer-profile@5d668905 - Dealer lockup plus carousel of inventory from dealer_inventory tool results. MIME type: text/html;profile=mcp-app
- ui://opendealer/deal-score@a4a068f5 - Deal score with price history chart and market position. MIME type: text/html;profile=mcp-app
- ui://opendealer/compare@be2a5679 - Side-by-side comparison for 2-5 vehicles. MIME type: text/html;profile=mcp-app
- ui://opendealer/market-snapshot@a8777591 - Compact market overview or segment stats card. MIME type: text/html;profile=mcp-app
- ui://opendealer/rankings-strip@e2bbcd13 - Horizontal strip of ranked vehicle models. MIME type: text/html;profile=mcp-app

## Prompts
- search_cars - Search for Cars Search for vehicles near a location with optional filters Arguments: location, criteria
- find_dealers - Find Dealers Find car dealerships near a location Arguments: location
- check_deal - Check if Deal is Good Analyze if a vehicle is priced fairly compared to market Arguments: vin
- compare_cars - Compare Vehicles Compare 2-5 vehicles side by side Arguments: vins
- market_insights - Market Insights Get market pricing data for a specific vehicle type Arguments: vehicle
- vehicle_details - Vehicle Details Get full details for a specific vehicle by VIN Arguments: vin
- dealer_stock - Dealer Stock Browse inventory at a specific dealership Arguments: dealer, filters
- market_overview - Market Overview Get overall automotive market statistics and trends Arguments: filter
- check_recalls - Check Safety Recalls Look up NHTSA open safety recalls for a vehicle by VIN Arguments: vin
- vehicle_dossier - VIN Buy / No-Buy Dossier Full shopping dossier for a VIN: deal score, price history, recalls, safety, similar listings, and rough payment estimate Arguments: vin, location
- budget_coach - Budget / Payment Coach Turn a monthly payment into a local inventory shortlist with deal scores (national avg APR guidance) Arguments: location, monthly_payment, criteria, credit_tier
- model_shortlist - Model Shortlist → Inventory Rank and compare models, then pull live local listings and VIN-compare finalists Arguments: location, need
- timing_advisor - Buy Now vs Wait Use market trends and velocity to advise whether to buy now or wait, then show local inventory Arguments: vehicle, location
- dealer_crawl - Dealer Visit Planner Plan a multi-dealer shopping route with hours, ratings, and must-see VINs at each stop Arguments: location, criteria, stops
- safety_first - Safety-First Shortlist Filter inventory then rank by NHTSA safety ratings and open recalls Arguments: location, criteria
- price_drop_sniper - Price-Drop Targets Find local listings with price-drop or long-on-lot signals, then score the deals Arguments: location, criteria
- trim_to_lot - Trim Guide → Local Stock Explain which trim fits the need, then show matching local inventory Arguments: make, model, needs, location
- value_hunter - Cross-Segment Value Hunter Compare competing models/segments on fit, price, and velocity, then show undervalued local stock Arguments: options, location
- closer - Final Pick + Plan B Recommend a primary VIN and backup, with dealer hours/contact (read-only; no lead submission) Arguments: vins, priorities

## Metadata
- Owner: app.opendealer
- Version: 2.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 2, 2026
- Source: https://registry.modelcontextprotocol.io