{"name":"OpenDealer MCP Server","version":"2.2.1","protocol":"mcp-2025-11-25","description":"Automotive inventory search for AI assistants. Search vehicles, find dealers, compare options, and get market insights.","capabilities":{"tools":true,"resources":true,"prompts":true},"tools":[{"name":"search_vehicles","title":"Search Vehicles","description":"Search for vehicles across dealerships (Meilisearch-backed NL + structured filters).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"filter_vehicles","title":"Filter Vehicles (Structured)","description":"Preferred structured inventory lookup when make/model/year/color/location are known.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_facets","title":"List Inventory Facets","description":"Discover available filter values and counts (makes, body types, fuel types, price/year ranges) for the live inventory.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_research_makes","title":"List Research Makes","description":"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.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_research_models","title":"List Research Models","description":"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.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_vehicle","title":"Get Vehicle Details","description":"Get complete details for a specific vehicle by VIN.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"check_recalls","title":"Check NHTSA Recalls","description":"Get NHTSA open safety recalls for a vehicle by VIN.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_dealer","title":"Get Dealership Details","description":"Get comprehensive information about a specific dealership.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_safety_rating","title":"Get NHTSA Safety Rating","description":"Get NHTSA 5-Star Safety Ratings for a year/make/model (no VIN required).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_vehicle_history","title":"Get Vehicle Price History","description":"Get OpenDealer listing history for a VIN: price changes, days on lot, and status.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dealers_near","title":"Find Nearby Dealers","description":"Find dealerships near a location.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dealer_inventory","title":"Browse Dealer Inventory","description":"Browse the complete inventory of a specific dealership.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"compare_vehicles","title":"Compare Vehicles","description":"Compare 2-5 vehicles side by side.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_deal_score","title":"Get Deal Score","description":"Get AI-powered deal scoring and market insights for a vehicle.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_market_overview","title":"Get Market Overview","description":"Get high-level automotive market statistics.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_market_segment","title":"Get Market Segment Data","description":"Get detailed pricing and market data for a specific vehicle segment.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_market_segments","title":"List Market Segments","description":"Browse market segments with pricing statistics (modelcode, median price, sample size). Use to discover modelcodes for get_market_segment / get_market_trends.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_market_trends","title":"Get Market Price Trends","description":"Price trends over time for a market segment (modelcode). Returns timeline of median/avg prices and days-on-lot.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_market_velocity","title":"Get Market Velocity","description":"How quickly vehicles sell by segment (fastest/slowest days on lot). Optional make/type filters.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"compare_market","title":"Compare Market Segments","description":"Compare pricing across market segments. Provide modelcodes[] or make (optionally with model).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_suggested_rates","title":"Get Suggested Finance Rates","description":"National average suggested auto loan APRs (not a credit offer). Optional filters: condition (new/used), term_months (36–84), credit_tier.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"research_model","title":"Research a Vehicle Model","description":"Get the full research payload for a vehicle model (not a specific listing).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"compare_models","title":"Compare Vehicle Models","description":"Compare 2-4 vehicle models side by side (model-level, not specific listings).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_vehicle_rankings","title":"Get Vehicle Rankings","description":"Get data-driven vehicle rankings (e.g., best SUVs, most fuel-efficient cars).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_similar_vehicles","title":"Get Similar Vehicles","description":"Find similar on-lot vehicles for a VIN (\"you may also like\"). Uses semantic similarity when available, with make/model filter fallback.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[{"uri":"opendealer://assistant/shopping-playbooks","name":"Shopping Playbooks","description":"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.","mimeType":"text/markdown"},{"uri":"opendealer://inventory/overview","name":"Inventory Overview","description":"High-level statistics about the current vehicle inventory including total count, price ranges, and popular makes.","mimeType":"application/json"},{"uri":"opendealer://market/overview","name":"Market Overview","description":"Aggregated market statistics including pricing trends, velocity metrics, and segment analysis.","mimeType":"application/json"},{"uri":"opendealer://makes","name":"Available Makes","description":"List of all vehicle makes available in the inventory with counts.","mimeType":"application/json"},{"uri":"opendealer://body-types","name":"Body Types","description":"List of all vehicle body types available with counts.","mimeType":"application/json"},{"uri":"ui://opendealer/vehicle-search","name":"Vehicle Search Widget","description":"Interactive grid of vehicle search results with photos, filters, sorting, and compare functionality.","mimeType":"text/html;profile=mcp-app"},{"uri":"ui://opendealer/vehicle-detail","name":"Vehicle Detail Widget","description":"Full vehicle details with photo gallery, specifications, deal score, and dealer contact information.","mimeType":"text/html;profile=mcp-app"},{"uri":"ui://opendealer/dealer-map","name":"Dealer Map Widget","description":"Map view of nearby dealerships with inventory counts and contact information.","mimeType":"text/html;profile=mcp-app"},{"uri":"ui://opendealer/dealer-profile","name":"Dealer Profile Widget","description":"Dealer profile lockup with image, contact details, and browseable inventory grid.","mimeType":"text/html;profile=mcp-app"},{"uri":"ui://opendealer/deal-score","name":"Deal Score Widget","description":"Interactive deal scoring with price history chart, market analysis spectrum bar, and market position stats.","mimeType":"text/html;profile=mcp-app"},{"uri":"ui://opendealer/compare","name":"Vehicle Compare Widget","description":"Side-by-side comparison table for 2-5 vehicles with highlighted best values.","mimeType":"text/html;profile=mcp-app"}],"resourceTemplates":[{"uriTemplate":"opendealer://vehicles/{vin}","name":"Vehicle Details","description":"Complete details for a specific vehicle by VIN","mimeType":"application/json"},{"uriTemplate":"opendealer://dealers/{dealerId}","name":"Dealer Profile","description":"Complete profile for a specific dealership","mimeType":"application/json"},{"uriTemplate":"opendealer://dealers/{dealerId}/inventory","name":"Dealer Inventory","description":"Current inventory for a specific dealership","mimeType":"application/json"},{"uriTemplate":"opendealer://market/segments/{modelcode}","name":"Market Segment","description":"Market pricing data for a specific vehicle segment","mimeType":"application/json"}],"prompts":[{"name":"search_cars","title":"Search for Cars","description":"Search for vehicles near a location with optional filters","arguments":[{"name":"location","description":"ZIP code, city/state, or address (e.g., \"92688\" or \"Irvine, CA\")","required":true},{"name":"criteria","description":"What you are looking for (e.g., \"Honda Civic under $25,000\" or \"SUV with AWD\")","required":false}]},{"name":"find_dealers","title":"Find Dealers","description":"Find car dealerships near a location","arguments":[{"name":"location","description":"ZIP code, city/state, or address","required":true}]},{"name":"check_deal","title":"Check if Deal is Good","description":"Analyze if a vehicle is priced fairly compared to market","arguments":[{"name":"vin","description":"The 17-character VIN of the vehicle to analyze","required":true}]},{"name":"compare_cars","title":"Compare Vehicles","description":"Compare 2-5 vehicles side by side","arguments":[{"name":"vins","description":"Comma-separated list of VINs to compare (e.g., \"VIN1,VIN2,VIN3\")","required":true}]},{"name":"market_insights","title":"Market Insights","description":"Get market pricing data for a specific vehicle type","arguments":[{"name":"vehicle","description":"The make, model, and year (e.g., \"2024 Honda Civic\" or \"Toyota RAV4\")","required":true}]},{"name":"vehicle_details","title":"Vehicle Details","description":"Get full details for a specific vehicle by VIN","arguments":[{"name":"vin","description":"The 17-character VIN of the vehicle","required":true}]},{"name":"dealer_stock","title":"Dealer Stock","description":"Browse inventory at a specific dealership","arguments":[{"name":"dealer","description":"The dealer name or slug (e.g., \"rancho-santa-margarita-honda\")","required":true},{"name":"filters","description":"Optional filters like make, model, price range (e.g., \"Honda under $30,000\")","required":false}]},{"name":"market_overview","title":"Market Overview","description":"Get overall automotive market statistics and trends","arguments":[{"name":"filter","description":"Optional filter by make or vehicle type (e.g., \"Honda\" or \"Used\")","required":false}]},{"name":"check_recalls","title":"Check Safety Recalls","description":"Look up NHTSA open safety recalls for a vehicle by VIN","arguments":[{"name":"vin","description":"The 17-character VIN of the vehicle to check for recalls","required":true}]},{"name":"vehicle_dossier","title":"VIN Buy / No-Buy Dossier","description":"Full shopping dossier for a VIN: deal score, price history, recalls, safety, similar listings, and rough payment estimate","arguments":[{"name":"vin","description":"The 17-character VIN to evaluate","required":true},{"name":"location","description":"Optional ZIP or city/state for similar nearby alternatives","required":false}]},{"name":"budget_coach","title":"Budget / Payment Coach","description":"Turn a monthly payment into a local inventory shortlist with deal scores (national avg APR guidance)","arguments":[{"name":"location","description":"ZIP code or city/state","required":true},{"name":"monthly_payment","description":"Target monthly payment in USD (e.g., \"350\")","required":true},{"name":"criteria","description":"Optional vehicle criteria (e.g., \"used AWD SUV\" or \"Honda CR-V\")","required":false},{"name":"credit_tier","description":"Optional credit tier for rate guidance (e.g., \"good\", \"excellent\")","required":false}]},{"name":"model_shortlist","title":"Model Shortlist → Inventory","description":"Rank and compare models, then pull live local listings and VIN-compare finalists","arguments":[{"name":"location","description":"ZIP code or city/state for local inventory","required":true},{"name":"need","description":"What they need (e.g., \"family SUVs under $35k\" or \"efficient sedans\")","required":true}]},{"name":"timing_advisor","title":"Buy Now vs Wait","description":"Use market trends and velocity to advise whether to buy now or wait, then show local inventory","arguments":[{"name":"vehicle","description":"Make/model or segment (e.g., \"used Toyota RAV4\")","required":true},{"name":"location","description":"Optional ZIP or city/state for local listings","required":false}]},{"name":"dealer_crawl","title":"Dealer Visit Planner","description":"Plan a multi-dealer shopping route with hours, ratings, and must-see VINs at each stop","arguments":[{"name":"location","description":"ZIP code or city/state","required":true},{"name":"criteria","description":"What to look for in stock (e.g., \"AWD SUVs under $28k\")","required":true},{"name":"stops","description":"Optional max number of dealer stops (default 3)","required":false}]},{"name":"safety_first","title":"Safety-First Shortlist","description":"Filter inventory then rank by NHTSA safety ratings and open recalls","arguments":[{"name":"location","description":"ZIP code or city/state","required":true},{"name":"criteria","description":"Vehicle criteria (e.g., \"3-row SUV under $40k\")","required":true}]},{"name":"price_drop_sniper","title":"Price-Drop Targets","description":"Find local listings with price-drop or long-on-lot signals, then score the deals","arguments":[{"name":"location","description":"ZIP code or city/state","required":true},{"name":"criteria","description":"Vehicle criteria (e.g., \"Honda CR-V under $30k\")","required":true}]},{"name":"trim_to_lot","title":"Trim Guide → Local Stock","description":"Explain which trim fits the need, then show matching local inventory","arguments":[{"name":"make","description":"Vehicle make (e.g., \"Honda\")","required":true},{"name":"model","description":"Vehicle model (e.g., \"CR-V\")","required":true},{"name":"needs","description":"Must-have features (e.g., \"CarPlay and AWD\")","required":true},{"name":"location","description":"ZIP code or city/state","required":true}]},{"name":"value_hunter","title":"Cross-Segment Value Hunter","description":"Compare competing models/segments on fit, price, and velocity, then show undervalued local stock","arguments":[{"name":"options","description":"Options to compare (e.g., \"used Mazda CX-5 vs new Honda CR-V\")","required":true},{"name":"location","description":"ZIP code or city/state","required":true}]},{"name":"closer","title":"Final Pick + Plan B","description":"Recommend a primary VIN and backup, with dealer hours/contact (read-only; no lead submission)","arguments":[{"name":"vins","description":"Comma-separated shortlist of VINs (2–5)","required":true},{"name":"priorities","description":"What matters most (e.g., \"lowest mileage, AWD, under $25k\")","required":false}]}],"endpoints":{"jsonRpc":"/rpc","wellKnown":"/.well-known/mcp.json"},"documentation":"https://opendealer.shop/ai","support":"support@opendealer.app"}