{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","name":"app.web.dealer-direct-mcp/dealer-direct-inventory","short_name":"dealer-direct-inventory-mcp","title":"DealerDirect National New & Used Car Inventory MCP","description":"Direct-from-dealer New, Used, and Certified Pre-Owned car inventory MCP server across 50+ US franchise dealerships in 9 states (FL, GA, TX, NC, AZ, CA, IL, MI, NJ). Search real-time dealership inventory directly from source dealer websites with zero aggregator middlemen and submit consent-gated buyer leads directly to dealers.","version":"2.1.0","protocol_version":"2025-03-26","official_registry_status":{"registry":"https://registry.modelcontextprotocol.io","server_name":"app.web.dealer-direct-mcp/dealer-direct-inventory","status":"active"},"endpoints":{"mcp":"https://dealer-direct-mcp.web.app/mcp","llms_txt":"https://dealer-direct-mcp.web.app/llms.txt","docs":"https://dealer-direct-mcp.web.app/docs","rest_vehicles":"https://dealer-direct-mcp.web.app/api/v1/vehicles","rest_dealers":"https://dealer-direct-mcp.web.app/api/v1/dealers","rest_leads":"https://dealer-direct-mcp.web.app/api/v1/leads"},"remotes":[{"transport_type":"streamable-http","url":"https://dealer-direct-mcp.web.app/mcp"}],"authentication":{"discovery_and_search":"none (public anonymous access)","lead_submission":"explicit buyer consent required (consent: true + buyer_email or buyer_phone)","lead_status":"dealer_api_key required"},"coverage_summary":{"states":["AZ","CA","FL","GA","IL","MI","NC","NJ","TX"],"regions":["South Florida (Miami / Fort Lauderdale)","West, Midwest & Northeast (CA / AZ / IL / NJ)","Tampa Bay & Gulf Coast, FL","Central Florida (Orlando)","Atlanta & Georgia","Texas (Austin / Houston / DFW)","Carolinas (Charlotte / Raleigh)","Palm Beach & Treasure Coast, FL","North Florida (Jacksonville)"],"total_dealers":64,"total_available_vehicles":5271,"new_vehicles":2358,"used_and_certified_vehicles":2913},"tools":[{"name":"search_inventory","title":"Search Dealer-Direct New & Used Car Inventory","description":"Search live dealer-direct New, Used, and Certified Pre-Owned car inventory across Miami and South Florida dealerships. Supports natural free-text query, condition ('new', 'used', 'certified'), make, model, trim, year_min/year_max, price_max, mileage_max, zip + radius_miles (geo search), fuel_type, drivetrain, transmission, body_style, certified_only, and dealer_id. Every vehicle includes freshness timestamps (last_seen_at) and a direct link to the dealer's own VDP (source_url). Empty searches return closest-match suggestions.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Optional free-text search query (e.g., 'new SUV', 'used AWD', 'Ford Explorer', 'Honda Civic')."},"condition":{"type":"string","enum":["new","used","certified"],"description":"Filter by vehicle condition ('new', 'used', or 'certified'). Omit to search all conditions."},"state":{"type":"string","description":"2-letter US state code filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."},"city":{"type":"string","description":"City name filter (e.g., 'Miami', 'Orlando', 'Tampa', 'Jacksonville', 'Atlanta', 'Austin', 'Houston', 'Phoenix')."},"region":{"type":"string","description":"Regional market filter (e.g., 'South Florida', 'Central Florida', 'Tampa Bay', 'North Florida', 'Atlanta', 'Texas', 'Carolinas', 'West')."},"make":{"type":"string","description":"Vehicle make (e.g., 'BMW', 'Toyota', 'Mazda', 'Tesla', 'Audi', 'Ford')."},"model":{"type":"string","description":"Vehicle model (e.g., 'CX-30', 'Model Y', 'Camry', 'X2', '3 Series')."},"trim":{"type":"string","description":"Vehicle trim or submodel (e.g., 'Long Range', 'xDrive28i', 'SE')."},"year_min":{"type":"integer","description":"Minimum model year (e.g., 2020)."},"year_max":{"type":"integer","description":"Maximum model year (e.g., 2026)."},"price_max":{"type":"number","description":"Maximum advertised price in USD (e.g., 25000)."},"mileage_max":{"type":"integer","description":"Maximum odometer mileage in miles (e.g., 60000)."},"zip":{"type":"string","description":"5-digit US ZIP code for geo-radius search (e.g., '33140' for Miami Beach, '33169' for Miami Gardens)."},"radius_miles":{"type":"number","description":"Search radius in miles from the ZIP centroid (default: 25, max: 500)."},"fuel_type":{"type":"string","description":"Fuel type filter ('Gasoline', 'Hybrid', 'Electric', 'Plug-In Hybrid', 'Diesel')."},"drivetrain":{"type":"string","description":"Drivetrain filter ('AWD', 'FWD', 'RWD', '4WD')."},"transmission":{"type":"string","description":"Transmission filter (e.g., 'Automatic', 'Manual')."},"body_style":{"type":"string","description":"Vehicle body style ('SUV', 'Sedan', 'Truck', 'Coupe', 'Convertible', 'Hatchback', 'Van')."},"certified_only":{"type":"boolean","description":"If true, only return factory Certified Pre-Owned (CPO) vehicles."},"dealer_id":{"type":"string","description":"Filter by specific dealer ID (e.g., 'dealer_north_miami_mitsubishi')."},"sort_by":{"type":"string","enum":["price","price_asc","price_desc","mileage","distance","newest"],"description":"Sort order for results (default: 'price')."},"limit":{"type":"integer","description":"Max vehicles to return per page (1-100, default: 20)."},"page":{"type":"integer","description":"Page number for pagination (1-based, default: 1)."}},"additionalProperties":false}},{"name":"get_vehicle","title":"Get Full Vehicle Details & Dealership VDP Info","description":"Retrieve the complete canonical record for a single vehicle by its vehicle_id or 17-character VIN. Returns full specifications, pricing breakdown & fee disclosures, price history, all high-res photo URLs, dealer contact info, and source_url back to the dealer's VDP.","inputSchema":{"type":"object","properties":{"id_or_vin":{"type":"string","description":"The canonical vehicle ID (e.g., 'veh_north-miami-mitsubishi_...') or 17-character VIN (e.g., '3MVDMBBM7SM754223')."}},"required":["id_or_vin"],"additionalProperties":false}},{"name":"list_dealers","title":"List Participating Dealerships & Live Regional Coverage","description":"List all indexed dealerships on the platform across 9 US regions and states, their physical locations, website platforms, last crawl timestamps, live available New and Used inventory counts, and price ranges.","inputSchema":{"type":"object","properties":{"state":{"type":"string","description":"Optional 2-letter US state filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."},"region":{"type":"string","description":"Optional regional market filter (e.g., 'South Florida', 'Orlando', 'Tampa Bay', 'Atlanta', 'Texas')."}},"additionalProperties":false}},{"name":"submit_lead","title":"Submit Qualified Buyer Lead to Dealership","description":"Submit a buyer inquiry/lead directly to a participating dealership for a specific vehicle or general inventory inquiry. Requires explicit buyer consent (consent=true) and at least one contact method (buyer_email or buyer_phone). Returns a lead_id and delivery status.","inputSchema":{"type":"object","properties":{"vehicle_id":{"type":"string","description":"Vehicle ID or 17-character VIN the buyer is inquiring about."},"dealer_id":{"type":"string","description":"Dealer ID (optional if vehicle_id is provided; required for general dealer inquiries)."},"buyer_name":{"type":"string","description":"Full name of the prospective buyer."},"buyer_email":{"type":"string","description":"Buyer's email address (at least one of buyer_email or buyer_phone is required)."},"buyer_phone":{"type":"string","description":"Buyer's phone number (at least one of buyer_email or buyer_phone is required)."},"message":{"type":"string","description":"Buyer's intent, questions, test-drive request, or trade-in/insurance notes."},"consent":{"type":"boolean","description":"Explicit buyer consent flag. Must be true to create and deliver the lead to the dealership."}},"required":["buyer_name","consent"],"additionalProperties":false}},{"name":"get_lead_status","title":"Get Lead Delivery & Billing Status (Dealer-Authenticated)","description":"Check the delivery state, webhook/email attempts, duplicate flag, and billing ledger status of a submitted lead. Requires dealer_api_key.","inputSchema":{"type":"object","properties":{"lead_id":{"type":"string","description":"The unique lead ID returned by submit_lead."},"dealer_api_key":{"type":"string","description":"Dealer API key for authentication."}},"required":["lead_id","dealer_api_key"],"additionalProperties":false}}]}