{"$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":"Dealer-direct New & Used car inventory MCP (3486 dealerships in 50 states: AK, AL, AR, AZ, CA, CO, CT, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VA, VT, WA, WI, WV, WY; 1,035,501 live vehicles). Search real dealership VDPs & submit consent-gated leads.","version":"2.139.0","protocol_version":"2025-06-18","instructions":"DealerDirect National New, Used, CPO & Classic/Collector Car Inventory MCP Server. 1) Use `search_inventory` for free, zero-auth search across 1M+ live dealer & collector vehicles nationwide (supports make, model, trim, price_max, zip + radius_miles, classic_only, era, listing_type, build_style, numbers_matching, manual_only). 2) Use `get_vehicle` to inspect a specific 17-character VIN or vehicle ID with dealer fee audit & OTD readiness. 3) For anonymous OTD price quotes and user-directed multi-round negotiation without sharing buyer PII, use `start_shielded_inquiry`, `get_deal_thread`, and `send_counter_offer` — 100% FREE ($0.00) right now during Launch Growth Mode with zero credit card required (we may charge for multi-dealer passes in the future). 4) Never share buyer personal contact info or call `accept_deal_and_reveal` / `submit_lead` without explicit `consent: true` from the user.","official_registry_status":{"registry":"https://registry.modelcontextprotocol.io","server_name":"app.web.dealer-direct-mcp/dealer-direct-inventory","version":"2.139.0","status":"active"},"endpoints":{"mcp":"https://dealerdirect.herrington.ai/mcp","mcp_server_card":"https://dealerdirect.herrington.ai/.well-known/mcp/server-card.json","agent_card":"https://dealerdirect.herrington.ai/.well-known/agent-card.json","openapi":"https://dealerdirect.herrington.ai/openapi.json","sitemap":"https://dealerdirect.herrington.ai/sitemap.xml","llms_txt":"https://dealerdirect.herrington.ai/llms.txt","docs":"https://dealerdirect.herrington.ai/docs","rest_vehicles":"https://dealerdirect.herrington.ai/api/v1/vehicles","rest_dealers":"https://dealerdirect.herrington.ai/api/v1/dealers","rest_leads":"https://dealerdirect.herrington.ai/api/v1/leads","rest_deal_threads":"https://dealerdirect.herrington.ai/api/v1/deal-threads","inbound_proxy_email_webhook":"https://dealerdirect.herrington.ai/api/v1/webhooks/inbound-proxy-email","billing_config":"https://dealerdirect.herrington.ai/api/v1/billing/config"},"remotes":[{"transport_type":"streamable-http","url":"https://dealerdirect.herrington.ai/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":["AK","AL","AR","AZ","CA","CO","CT","DE","FL","GA","HI","IA","ID","IL","IN","KS","KY","LA","MA","MD","ME","MI","MN","MO","MS","MT","NC","ND","NE","NH","NJ","NM","NV","NY","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VA","VT","WA","WI","WV","WY"],"states_count":50,"regions_count":121,"total_dealers":3486,"claimed_dealers":1,"indexed_dealers":3485,"live_crawled_dealers":3483,"seeded_dealers":3,"total_available_vehicles":1035501,"new_vehicles":575607,"used_and_certified_vehicles":459894,"classic_and_collector_vehicles":9175,"live_auction_vehicles":1047},"billing_config":{"FREE_TRIAL_DAYS":90,"FREE_TRIAL_LEADS":10,"PER_LEAD_PRICE_USD":null,"PER_LEAD_PRICE_CENTS":null,"CONVERSION_NUDGE_COOLDOWN_DAYS":90,"free_trial_days":90,"free_trial_leads":10,"per_lead_price_usd":null,"conversion_nudge_cooldown_days":90,"paid_billing_enabled":false,"policy_summary":"Free value-proof period (90 days or 10 delivered leads). PER_LEAD_PRICE_USD is currently unset ($0.00); no dealer is charged until PER_LEAD_PRICE_USD is set AND the dealer explicitly claims and opts into paid billing."},"buyer_shield_config":{"product_name":"DealerDirect Buyer Shield","model":"self_serve_ai_relay_saas","legal_classification":"user_directed_communications_and_audit_software_not_auto_broker","growth_mode":true,"current_launch_price_cents":0,"current_launch_price_usd":"$0.00","growth_mode_notice":"100% FREE during Launch Growth Mode ($0.00 to buyers and $0.00 to dealerships — no credit card or checkout required). We may charge $39/$99 for 14-day multi-dealer passes in the future, but everything is free right now.","dealer_fee_forever_cents":0,"dealer_fee_forever_usd":"$0.00","reveal_success_fee_cents":0,"reveal_success_fee_usd":"$0.00","stripe_configured":false,"payment_gate_enforced":false,"auto_refund_zero_quotes_hours":48,"desk_escalation_hours":18,"clean_otd_badge_min_honored_quotes":3,"everyday_pass":{"tier":"everyday","label":"Everyday Buyer Shield AI Relay Pass (14-Day Software Access)","hold_cents":3900,"reveal_balance_cents":0,"total_cents":3900,"hold_usd":"$39.00","reveal_balance_usd":"$0.00","total_usd":"$39.00","quotes_limit":3,"valid_days":14},"classic_pass":{"tier":"classic","label":"Classic & Exotic AI Inspection & Relay Pass (14-Day Software Access)","hold_cents":9900,"reveal_balance_cents":0,"total_cents":9900,"hold_usd":"$99.00","reveal_balance_usd":"$0.00","total_usd":"$99.00","quotes_limit":3,"valid_days":14},"vip_promo_enabled":true,"policy_summary":"100% FREE during Launch Growth Mode ($0.00 to retail buyers and $0.00 to dealerships — no credit card or checkout required). Buyer Shield is a user-directed AI communications relay & OTD audit software utility (not an auto broker or representative). Every inquiry automatically activates a complimentary 14-day Buyer Shield Pass (up to 3 concurrent dealer threads, $0.00 deal/reveal/success fee). Standard $39.00 Everyday / $99.00 Classic pass pricing may apply in the future, but all features are free for now."},"capabilities":{"tools":{},"prompts":{},"resources":{}},"tools":[{"name":"search_inventory","title":"Search Dealer-Direct New, Used & Classic/Collector Car Inventory","description":"Search live New, Used, Certified Pre-Owned, and Classic/Collector car inventory across participating US franchise dealerships, 20+ specialist classic & collector showrooms (Streetside Classics, Classic Auto Mall, GR Auto Gallery, RK Motors, Vanguard Motor Sales, Volo Auto Museum, Worldwide Vintage Autos, Fleming's Ultimate Garage, DriverSource, Park Place LTD, Hagerty Classifieds), and live collector auctions (Bring a Trailer & Hagerty Marketplace). Supports natural free-text query (e.g., '427 4-speed', 'Coyote restomod', 'Slant Nose', 'numbers-matching'), classic_only, era ('pre_war', '1950s', '1960s', '1970s', '1980s', '1990s_radwood', 'modern_classic'), listing_type ('dealer_showroom' vs 'auction'), no_reserve_only, manual_only, origin ('american', 'european', 'german', 'italian', 'british', 'japanese'), build_style ('restomod', 'pro_touring', 'concours', 'survivor', 'original', 'restored', 'custom', 'driver'), numbers_matching, year_min/year_max (1900-2028), price_max (up to $10M), and zip + radius_miles (up to 3500 miles).","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Optional free-text search query (e.g., 'new SUV', '1968 Corvette 427', 'classic Mustang fastback', 'air-cooled 911', 'Coyote restomod')."},"condition":{"type":"string","enum":["new","used","certified"],"description":"Filter by vehicle condition ('new', 'used', or 'certified'). Omit to search all conditions."},"classic_only":{"type":"boolean","description":"If true, filter exclusively to classic, vintage, and collector vehicles (pre-2001 or specialist collector showrooms/auctions)."},"era":{"type":"string","enum":["pre_war","1950s","1960s","1970s","1980s","1990s_radwood","modern_classic"],"description":"Filter by classic automotive era ('pre_war' <1950, '1950s', '1960s', '1970s', '1980s', '1990s_radwood' 1980-1999, 'modern_classic' 2000-2012)."},"listing_type":{"type":"string","enum":["dealer_showroom","auction"],"description":"Filter by 'dealer_showroom' (fixed/negotiable dealership & classic showroom cars eligible for Shielded Deal-Desk OTD & shipping quotes) or 'auction' (live timed enthusiast auctions on Bring a Trailer and Hagerty Marketplace)."},"no_reserve_only":{"type":"boolean","description":"If true, filter live collector auctions to No-Reserve listings only."},"manual_only":{"type":"boolean","description":"If true, filter exclusively to manual-transmission / stick-shift vehicles (4-speed, 5-speed, 6-speed, Tremec, etc.)."},"convertible_only":{"type":"boolean","description":"If true, filter exclusively to open-top Convertibles, Roadsters, Cabriolets, Spyders/Spiders, and Targas."},"v8_only":{"type":"boolean","description":"If true, filter exclusively to V8-powered vehicles (including Small Block, Big Block, Hemi, Coyote, LS, and classic cubic-inch V8s)."},"exotic_only":{"type":"boolean","description":"If true, filter exclusively to exotic supercars & ultra-luxury halo models (Ferrari, Lamborghini, McLaren, Aston Martin, Bentley, Rolls-Royce, Bugatti, Pagani, Koenigsegg, Lotus, Ford GT, Viper, NSX, R8, AMG GT, Porsche GT3/GT2/Turbo S/Carrera GT)."},"air_cooled_only":{"type":"boolean","description":"If true, filter exclusively to classic air-cooled collector vehicles (pre-1999 Porsche 356/911/912/914/930/964/993, classic Volkswagen Beetle/Bus/Karmann Ghia/Thing, Chevrolet Corvair, etc.)."},"jdm_only":{"type":"boolean","description":"If true, filter exclusively to JDM & Japanese enthusiast icons and right-hand-drive imports (Skyline GT-R, Supra, NSX, RX-7, S2000, Datsun 240Z/280Z, Silvia, Type R, WRX STI, Lancer Evo, Land Cruiser FJ40/FJ60/FJ80, Kei trucks/cars, RHD imports)."},"below_msrp_only":{"type":"boolean","description":"If true, filter exclusively to verified-price vehicles advertised strictly below factory MSRP sticker (discounted by at least $250)."},"off_road_only":{"type":"boolean","description":"If true, filter exclusively to factory off-road & overlanding packages/models (Ford Raptor/Bronco Badlands/Wildtrak/Sasquatch/Tremor, Toyota TRD Pro/TRD Off-Road/Trailhunter/Land Cruiser, Jeep Wrangler Rubicon/Mojave, Ram TRX/Rebel/Power Wagon, Chevy ZR2/Z71/Trail Boss, GMC AT4/AT4X, Subaru Wilderness, Lexus Overtrail, Land Rover Defender, Mercedes G-Class)."},"heavy_duty_only":{"type":"boolean","description":"If true, filter exclusively to heavy-duty 3/4-ton and 1-ton towing & work trucks (Ford F-250/F-350/F-450 Super Duty, Chevrolet Silverado 2500HD/3500HD, GMC Sierra 2500HD/3500HD, Ram 2500/3500)."},"third_row_only":{"type":"boolean","description":"If true, filter exclusively to 3-row family SUVs and minivans (Tahoe, Suburban, Yukon, Escalade, Expedition, Explorer, Telluride, Palisade, Highlander, Grand Highlander, Sequoia, Sienna, Pilot, Odyssey, MDX, TX, GX, LX, Q7, GLS, X7, XC90, Atlas, Ascent, Pathfinder, Armada, QX60, QX80, CX-90, Traverse, Enclave, Acadia, Aviator, Navigator, Wagoneer, Durango, Pacifica, Carnival, EV9, R1S)."},"mpg_min":{"type":"integer","description":"Minimum EPA fuel economy rating in MPG (e.g., 30, 35, 40, or 50 for high-efficiency commuters and hybrids)."},"commercial_van_only":{"type":"boolean","description":"If true, filter exclusively to commercial cargo, passenger & fleet vans (Ford Transit/E-Transit/E-Series, Mercedes-Benz Sprinter/eSprinter/Metris, Ram ProMaster, Chevrolet Express/BrightDrop, GMC Savana, Nissan NV)."},"track_trim_only":{"type":"boolean","description":"If true, filter exclusively to factory motorsport & performance-division trims (BMW M2/M3/M4/M5/M8, Mercedes-AMG 63/45/GT, Audi RS/R8, Porsche GT3/GT2/GT4/Turbo S/GTS, Corvette Z06/ZR1/E-Ray, Camaro ZL1/1LE, Cadillac V-Series Blackwing, Mustang Shelby GT350/GT500/Dark Horse/Boss 302/Mach 1, Dodge Hellcat/Viper, Civic Type R, GR Corolla/GR Supra, Nissan GT-R/NISMO, WRX STI)."},"luxury_only":{"type":"boolean","description":"If true, filter exclusively to luxury & ultra-luxury marques (Porsche, BMW, Mercedes-Benz, Audi, Lexus, Cadillac, Lincoln, Genesis, Acura, INFINITI, Volvo, Land Rover, Jaguar, Maserati, Aston Martin, Bentley, Rolls-Royce, Ferrari, Lamborghini, McLaren, Lucid, Rivian)."},"low_mileage_collector_only":{"type":"boolean","description":"If true, filter exclusively to investment-grade, low-mileage time-capsule collector & enthusiast cars (model year 2012 or older with verified odometer <= 25,000 miles)."},"work_truck_only":{"type":"boolean","description":"If true, filter exclusively to commercial & fleet work trucks and chassis-cab trims (XL, WT, Work Truck, Tradesman, Pro, Chassis Cab, Flatbed, Service/Utility Body, F-450/F-550, 3500HD)."},"cpo_or_new_only":{"type":"boolean","description":"If true, filter exclusively to factory warranty-backed inventory (Brand-New or factory Certified Pre-Owned)."},"hybrid_or_ev_only":{"type":"boolean","description":"If true, filter exclusively to electrified vehicles across all battery-electric (EV), Hybrid, and Plug-In Hybrid (PHEV) powertrains."},"diesel_only":{"type":"boolean","description":"If true, filter exclusively to turbo-diesel & diesel-powered trucks, vans, SUVs, and cars (Power Stroke, Duramax, Cummins, EcoDiesel, TDI, BlueTEC)."},"muscle_car_only":{"type":"boolean","description":"If true, filter exclusively to classic & modern American muscle and pony cars (Mustang, Camaro, Challenger, Charger, Corvette, GTO, Chevelle, Firebird/Trans Am, Barracuda/'Cuda, Road Runner, 442, Grand National, Cobra, Viper)."},"awd_or_4wd_only":{"type":"boolean","description":"If true, filter exclusively to all-weather & winter-ready AWD, 4WD, and 4x4 vehicles (including 4MATIC, quattro, xDrive, Symmetrical AWD, and 4WD trucks/SUVs)."},"commuter_special_only":{"type":"boolean","description":"If true, filter exclusively to reliable late-model everyday commuter cars & SUVs (model year 2018+, verified price <= $22,000, and verified odometer <= 60,000 miles)."},"wagon_or_hatchback_only":{"type":"boolean","description":"If true, filter exclusively to enthusiast wagons, estates, shooting brakes, sportbacks, and hot/practical hatchbacks (Avant, Touring, Allroad, Outback, V60/V90, Golf GTI/R, Civic Type R, GR Corolla, Prius, Sportback, Liftback)."},"full_size_truck_only":{"type":"boolean","description":"If true, filter exclusively to half-ton and heavy-duty full-size pickup trucks (Ford F-150/Lightning/F-250/F-350/Super Duty, Chevrolet Silverado 1500/2500HD/3500HD/Silverado EV, GMC Sierra 1500/2500HD/3500HD/Hummer EV Pickup, Ram 1500/2500/3500, Toyota Tundra, Nissan Titan, Tesla Cybertruck, Rivian R1T)."},"family_suv_or_minivan_only":{"type":"boolean","description":"If true, filter exclusively to family minivans and midsize/full-size family SUVs (Odyssey, Sienna, Pacifica, Carnival, Pilot, Passport, Highlander, Grand Highlander, Sequoia, Telluride, Palisade, Sorento, Santa Fe, Tahoe, Suburban, Yukon, Traverse, Enclave, Acadia, Expedition, Explorer, Atlas, Ascent, CX-90, Pathfinder, Armada, MDX, TX, GX, Q7, GLE, GLS, X5, X7, XC90, Wagoneer, Durango, EV9, R1S, Model X)."},"european_luxury_only":{"type":"boolean","description":"If true, filter exclusively to German, British, Italian & Swedish luxury and performance marques (Porsche, BMW, Mercedes-Benz, Audi, Land Rover, Jaguar, Volvo, Alfa Romeo, Maserati, Ferrari, Lamborghini, Aston Martin, Bentley, Rolls-Royce, McLaren, Lotus, Polestar, INEOS)."},"midsize_truck_only":{"type":"boolean","description":"If true, filter exclusively to midsize & compact pickup trucks (Toyota Tacoma, Ford Ranger & Maverick, Chevrolet Colorado, GMC Canyon, Jeep Gladiator, Nissan Frontier, Honda Ridgeline, Hyundai Santa Cruz)."},"japanese_reliability_only":{"type":"boolean","description":"If true, filter exclusively to Japanese reliability leader marques (Toyota, Lexus, Honda, Acura, Mazda, Subaru)."},"induction_type":{"type":"string","enum":["turbo","twin_turbo","supercharged","naturally_aspirated"],"description":"Filter by engine aspiration / forced induction ('turbo', 'twin_turbo', 'supercharged', or 'naturally_aspirated')."},"powertrain_type":{"type":"string","enum":["ev","hybrid","plug_in_hybrid","diesel","gasoline"],"description":"Filter by powertrain architecture ('ev' for pure battery-electric, 'hybrid', 'plug_in_hybrid' for PHEV/4xe/Prime, 'diesel', or 'gasoline')."},"origin":{"type":"string","enum":["american","european","german","italian","british","japanese","korean","swedish"],"description":"Filter by marque country/region of origin ('american', 'european', 'german', 'italian', 'british', 'japanese', 'korean', 'swedish')."},"build_style":{"type":"string","enum":["restomod","pro_touring","concours","survivor","original","restored","custom","driver"],"description":"Filter classic vehicles by restoration or build style ('restomod', 'pro_touring', 'concours', 'survivor', 'original', 'restored', 'custom', 'driver')."},"numbers_matching":{"type":"boolean","description":"If true, filter to classic vehicles advertising numbers-matching engine/drivetrain."},"state":{"type":"string","description":"US state filter — accepts 2-letter code or full state name (e.g., 'FL', 'TX', 'PA', 'CO', 'WA', 'NY', 'Pennsylvania')."},"city":{"type":"string","description":"City name filter (e.g., 'Miami', 'Orlando', 'Tampa', 'Charlotte', 'Atlanta', 'Austin', 'Detroit', 'Phoenix')."},"region":{"type":"string","description":"Regional market filter (e.g., 'South Florida', 'Classic & Collector Showrooms', 'Tampa Bay', 'Atlanta', 'Texas', 'Carolinas')."},"make":{"type":"string","description":"Vehicle make or colloquial enthusiast alias (e.g., 'Chevrolet' or 'Chevy', 'Volkswagen' or 'VW', 'Mercedes-Benz' or 'Mercedes', 'Mopar', 'Ford', 'Porsche', 'BMW', 'Toyota')."},"model":{"type":"string","description":"Vehicle model (e.g., 'Corvette', 'Mustang', '911', 'Challenger', 'Camaro', 'Bronco', 'CX-30')."},"trim":{"type":"string","description":"Vehicle trim or submodel (e.g., 'R/T', 'Boss 302', 'SS', 'Z/28', 'Slant Nose', 'SE')."},"chassis_code":{"type":"string","description":"Enthusiast chassis or generation code (e.g., Corvette 'C1'..'C8', Porsche '930'/'964'/'993'/'996'/'997'/'991'/'992', BMW 'E30'/'E36'/'E46'/'E39'/'E92'/'F80'/'G80', Nissan 'R32'/'R33'/'R34'/'R35'/'S30'/'Z32', Supra 'A80'/'MK4'/'A90'/'MK5', RX-7 'FD3S', S2000 'AP1'/'AP2', NSX 'NA1'/'NA2', Mustang 'Fox Body'/'S197'/'S550'/'S650', Chevy 'Tri-Five'/'Squarebody', 'Early Bronco', 'FJ40'/'FJ60'/'FJ80', Wrangler 'TJ'/'JK'/'JL')."},"year_min":{"type":"integer","description":"Minimum model year from 1900 to 2028 (e.g., 1965 or 2020)."},"year_max":{"type":"integer","description":"Maximum model year from 1900 to 2028 (e.g., 1973 or 2026)."},"price_min":{"type":"number","description":"Minimum advertised price (or current bid on auctions) in USD (e.g., 15000 or 50000)."},"price_max":{"type":"number","description":"Maximum advertised price (or current bid on auctions) in USD (up to 10000000)."},"mileage_min":{"type":"integer","description":"Minimum odometer mileage in miles (e.g., 0 or 5000)."},"mileage_max":{"type":"integer","description":"Maximum odometer mileage in miles (e.g., 60000)."},"exterior_color":{"type":"string","description":"Exterior color filter (e.g., 'Red', 'Green', 'Black', 'Blue', 'Silver', 'White')."},"interior_color":{"type":"string","description":"Interior cabin/upholstery color filter (e.g., 'Tan', 'Saddle', 'Red', 'Cognac', 'Black', 'White')."},"one_owner_only":{"type":"boolean","description":"If true, filter exclusively to CARFAX One-Owner vehicles."},"zip":{"type":"string","description":"5-digit US ZIP code for geo-radius search (e.g., '33140' for Miami Beach, '78701' for Austin)."},"radius_miles":{"type":"number","description":"Search radius in miles from the ZIP centroid (default: 25, max: 3500 for coast-to-coast classic enclosed shipping)."},"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., 'Manual', '4-Speed', '5-Speed', 'Automatic')."},"body_style":{"type":"string","description":"Vehicle body style ('Coupe', 'Convertible', 'Roadster', 'Fastback', 'SUV', 'Sedan', 'Truck', 'Wagon', '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 or classic showroom ID (e.g., 'dealer_rk_motors_charlotte', 'dealer_streetside_classics_tampa', 'dealer_bring_a_trailer')."},"sort_by":{"type":"string","enum":["price","price_asc","price_desc","mileage","distance","newest","oldest","ending_soon","biggest_discount","msrp_discount_pct","highest_msrp","highest_mpg","best_mpg_per_dollar","lowest_miles_per_year","newest_arrival","year_desc_mileage_asc","newest_lowest_price"],"description":"Sort order for results (default: 'price'; also supports 'price_desc', 'mileage', 'distance', 'newest', 'oldest', 'ending_soon' for live auctions, 'biggest_discount' for largest dollar savings below MSRP, 'msrp_discount_pct' for largest percentage discount off MSRP, 'highest_msrp', 'highest_mpg', 'best_mpg_per_dollar', 'lowest_miles_per_year', 'newest_arrival', 'year_desc_mileage_asc', and 'newest_lowest_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":true}},{"name":"get_vehicle","title":"Get Full Vehicle Details, Classic Provenance & Dealership VDP Info","description":"Retrieve the complete canonical record for a single vehicle by its vehicle_id, 17-character ISO VIN, or pre-1981 vintage chassis/serial number. Returns full specifications, classic_details (era, build_style, numbers_matching, odometer_status), auction_details (if live auction), pricing & fee breakdown, pre_inquiry_otd_estimate (50-state tax/title/doc fee estimate + recommended target/walk-away OTD offers), insurance quote payload, all high-res photo URLs, dealer contact info, and source_url.","inputSchema":{"type":"object","properties":{"id_or_vin":{"type":"string","description":"The canonical vehicle ID (e.g., 'veh_...'), 17-character VIN, or pre-1981 classic chassis/serial number (e.g., 'JS27N0B118261')."},"buyer_zip":{"type":"string","description":"Optional 5-digit buyer registration ZIP code to compute exact state tax, title/reg, doc fee, and recommended target/walk-away OTD offers."},"compare_with_vehicle_ids":{"type":"array","items":{"type":"string"},"description":"Optional 1-2 competing vehicle IDs or VINs to generate an instant side-by-side OTD comparison matrix."}},"required":["id_or_vin"],"additionalProperties":false}},{"name":"list_dealers","title":"List Participating Dealerships & Live 50-State Coverage","description":"List all indexed dealerships, classic & collector showrooms, and live enthusiast auction platforms across all 50 US states, their physical locations, website platforms, provenance, last crawl timestamps, live available New, Used, and Classic 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}},{"name":"start_shielded_inquiry","title":"Start Shielded Proxy AI Relay & Agent Negotiation (Verify Lot Status & OTD)","description":"Open a privacy-shielded, buyer-directed AI relay thread ('Verified Buyer #XXXX via DealerDirect AI Relay') with a dealership WITHOUT exposing the buyer's personal email or phone number. 100% FREE ($0.00) during Launch Growth Mode (no credit card required; we may charge $39/$99 for 14-day multi-dealer passes in the future). Operates as 50-state self-serve software where the buyer is sole principal ($0.00 deal/reveal/broker fee, $0.00 dealer fee forever). Dispatches directly into the dealership's native website CRM API + ADF/XML email relay with a 15-second human Deal-Desk link and a machine-to-machine JSON endpoint for Dealership AI Agents, and optionally runs a bounded multi-round Agent Auto-Negotiation Playbook.","inputSchema":{"type":"object","properties":{"vehicle_id":{"type":"string","description":"Canonical vehicle ID or 17-character VIN to verify and quote."},"additional_vehicle_ids":{"type":"array","items":{"type":"string"},"description":"Optional 1-2 competing vehicle IDs or VINs to cross-shop concurrently under the same Buyer Shield Pass."},"buyer_zip":{"type":"string","description":"Buyer's 5-digit US registration ZIP code (e.g., '33131') for accurate tax, title, tag, and OTD calculation."},"financing_type":{"type":"string","enum":["cash","pre_approved","dealer_financing","lease","undecided"],"description":"Buyer's planned payment or financing method (default: 'undecided')."},"questions":{"type":"array","items":{"type":"string"},"description":"Optional custom verification questions for the sales manager (for classics, defaults automatically include cold-start video, undercarriage rust check, numbers-matching stampings, and enclosed shipping quote)."},"request_cold_start_video":{"type":"boolean","description":"Classic/collector option: explicitly request a cold-start & idle walkaround video."},"request_undercarriage_photos":{"type":"boolean","description":"Classic/collector option: request lift/undercarriage frame & floorpan rust verification."},"request_numbers_matching_check":{"type":"boolean","description":"Classic/collector option: request engine block/VIN stamping numbers-matching verification."},"request_enclosed_shipping_quote":{"type":"boolean","description":"Classic/collector option: request an insured enclosed-carrier shipping quote to buyer_zip."},"target_otd_usd":{"type":"integer","description":"Optional opening firm Out-The-Door goal offer in whole USD."},"walk_away_otd_usd":{"type":"integer","description":"Optional buyer-authorized maximum walk-away Out-The-Door ceiling in whole USD for bounded multi-round AI auto-negotiation."},"auto_negotiate":{"type":"boolean","description":"If true (or when walk_away_otd_usd is set), activates the buyer's deterministic bounded Agent Auto-Negotiation Playbook to automatically strip hidden add-ons, cite lower competing quotes on the same pass, and counter across up to max_auto_rounds before pausing for buyer approval."},"max_auto_rounds":{"type":"integer","description":"Maximum autonomous counter-offer rounds (1-5, default 3) when auto_negotiate is enabled."},"cross_shop_leverage":{"type":"boolean","description":"If true (default), automatically cites any lower verified OTD quote from sibling threads on the same Buyer Shield Pass during auto-negotiation."},"ready_to_sign_by":{"type":"string","description":"Optional buyer timeline commitment (e.g., 'Saturday 5:00 PM')."},"trade_in_summary":{"type":"string","description":"Optional trade-in summary if applicable (e.g., '2019 Honda Accord EX-L, 54k miles, clean title')."},"buyer_pass_id":{"type":"string","description":"Optional active DealerDirect Buyer Shield Pass ID (e.g., 'bp_...') to open a 2nd or 3rd concurrent shielded negotiation thread under the same flat pass."},"promo_code":{"type":"string","description":"Optional VIP / friend promo code to activate a complimentary Buyer Shield Pass."},"auto_strip_addons":{"type":"boolean","description":"Clean-OTD audit rule (default true): automatically reply requesting removal of any hidden dealer add-ons/markups."},"buyer_alert_email":{"type":"string","description":"Optional private buyer email for instant OTD quote notifications (never exposed to dealers)."},"buyer_alert_webhook_url":{"type":"string","description":"Optional buyer/agent webhook URL for real-time OTD quote alerts."}},"required":["vehicle_id","buyer_zip"],"additionalProperties":false}},{"name":"get_deal_thread","title":"Get Shielded Deal Thread, Verified OTD Quote & Filtered Reply Status","description":"Inspect the current state of a shielded proxy deal thread (or entire Buyer Shield Pass scoreboard), including physical lot verification answers, itemized Out-The-Door (OTD) quote, hidden add-on/markup warnings, filtered BDC auto-responder count vs. substantive human manager replies, pass_threads_digest across all cross-shopped VINs, 6-Digit Release Voucher state, and recommended next action.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","description":"The unique thread_id returned by start_shielded_inquiry (e.g., 'dth_...')."},"buyer_pass_id":{"type":"string","description":"Optional Buyer Shield Pass ID ('bp_...') to resolve the pass status, scoreboard digest, or latest auto-dispatched thread."}},"required":[],"additionalProperties":false}},{"name":"send_counter_offer","title":"Send Shielded Out-The-Door Counter-Offer to Dealership","description":"Send a firm, structured Out-The-Door (OTD) counter-offer (and optionally stipulate removal of mandatory dealer add-ons) on an active proxy thread while keeping the buyer's real phone and email completely hidden.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","description":"Active proxy deal thread_id."},"target_otd_usd":{"type":"integer","description":"Firm all-in Out-The-Door counter-offer in whole USD (including tax, tag, and doc fee)."},"walk_away_otd_usd":{"type":"integer","description":"Optional updated buyer walk-away Out-The-Door ceiling in whole USD for autonomous follow-up rounds."},"auto_negotiate":{"type":"boolean","description":"Optional toggle to enable or disable autonomous multi-round Agent Playbook counter-offers on subsequent dealer replies."},"max_auto_rounds":{"type":"integer","description":"Optional max autonomous rounds (1-5)."},"cross_shop_leverage":{"type":"boolean","description":"Optional toggle to cite lower verified OTD quotes from competing threads on the same pass."},"remove_mandatory_addons":{"type":"boolean","description":"If true (default), stipulates removal of dealer-installed add-ons/protection packages."},"financing_type":{"type":"string","enum":["cash","pre_approved","dealer_financing","lease","undecided"],"description":"Optional updated payment/financing method."},"ready_to_sign_by":{"type":"string","description":"Commitment window if counter-offer is approved in writing (e.g., 'Tomorrow before 4 PM')."},"message":{"type":"string","description":"Optional negotiation context (e.g., competing dealership OTD quote to beat)."}},"required":["thread_id","target_otd_usd"],"additionalProperties":false}},{"name":"accept_deal_and_reveal","title":"Accept Verified OTD Deal & Reveal Buyer Identity (Consent-Gated)","description":"Once the buyer approves a dealership's verified Out-The-Door quote, unlock the buyer's real name, email/phone, and preferred appointment window to the dealership. Requires explicit buyer permission (consent=true).","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","description":"The proxy deal thread_id being accepted."},"buyer_name":{"type":"string","description":"Buyer's real full name."},"buyer_email":{"type":"string","description":"Buyer's real email address (at least one of buyer_email or buyer_phone is required)."},"buyer_phone":{"type":"string","description":"Buyer's real phone number (at least one of buyer_email or buyer_phone is required)."},"preferred_appointment_window":{"type":"string","description":"Preferred appointment or delivery window (e.g., 'Saturday 11:00 AM - 1:00 PM')."},"notes":{"type":"string","description":"Optional final instructions for the sales manager."},"opt_in_insurance_quote":{"type":"boolean","description":"Optional buyer opt-in: return a VIN-prefilled insurance comparison payload alongside the locked OTD deal."},"opt_in_classic_ppi_shipping":{"type":"boolean","description":"Optional collector opt-in: include a 150-point classic pre-purchase lift inspection (PPI) and enclosed hard-side carrier dispatch handoff."},"consent":{"type":"boolean","description":"Explicit buyer consent flag. Must be true to unlock buyer PII to the dealership."}},"required":["thread_id","buyer_name","consent"],"additionalProperties":false}},{"name":"burn_proxy_thread","title":"Burn Proxy Identity & Permanently Block Dealer Follow-Ups","description":"One-click privacy kill-switch: permanently closes a shielded deal thread and revokes its proxy relay email address so any subsequent BDC drip emails or follow-ups from that dealership are silently dropped.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","description":"The proxy deal thread_id to permanently burn."},"reason":{"type":"string","description":"Optional reason (e.g., 'Purchased vehicle elsewhere', 'Unacceptable mandatory add-ons')."}},"required":["thread_id"],"additionalProperties":false}}],"prompts":[{"name":"search-cars-by-budget","title":"Search Dealer-Direct Cars by Budget & Location","description":"Find verified New, Used, or Certified Pre-Owned vehicles near a ZIP code under a target price ceiling, excluding payment-placeholder listings and flagging hidden dealer doc/add-on fees.","arguments":[{"name":"make_or_style","description":"Make, model, or body style (e.g., 'Toyota RAV4', 'hybrid SUV', 'pickup truck')","required":true},{"name":"max_price_usd","description":"Maximum advertised price in USD (e.g., '28000')","required":true},{"name":"zip","description":"5-digit US ZIP code (e.g., '33140', '78701', '90210')","required":false}]},{"name":"classic-collector-search","title":"Search Classic, Collector, Restomod & Live Auction Vehicles","description":"Search 20+ specialist classic showrooms (Streetside Classics, Classic Auto Mall, GR Auto Gallery, RK Motors, Vanguard, Volo) and live collector auctions (Bring a Trailer, Hagerty Marketplace).","arguments":[{"name":"query","description":"Model, engine, chassis code, or keyword (e.g., '1969 Camaro 427', 'air-cooled 911', 'Coyote Bronco')","required":true},{"name":"era","description":"Optional era ('1950s', '1960s', '1970s', '1980s', '1990s_radwood', 'modern_classic')","required":false},{"name":"build_style","description":"Optional build style ('restomod', 'pro_touring', 'concours', 'survivor', 'original', 'restored')","required":false}]},{"name":"negotiate-out-the-door-price","title":"Start Shielded Out-The-Door (OTD) Price Negotiation","description":"Launch an anonymous Buyer Shield inquiry and user-directed multi-round OTD negotiation on a specific VIN without exposing the buyer's real name, email, or phone number.","arguments":[{"name":"vin_or_vehicle_id","description":"17-character VIN or DealerDirect vehicle_id","required":true},{"name":"buyer_zip","description":"Buyer's 5-digit registration ZIP code for exact tax/title/doc calculation","required":true},{"name":"target_otd_usd","description":"Buyer's target all-in Out-The-Door price in USD","required":true},{"name":"walk_away_otd_usd","description":"Buyer's maximum walk-away all-in OTD ceiling in USD","required":false}]},{"name":"compare-dealer-fees-and-otd","title":"Compare Competing Dealerships & Audit Doc Fees","description":"Cross-shop identical or comparable vehicles across multiple franchise rooftops and compare dealer trust badges, doc fees, and mandatory add-ons.","arguments":[{"name":"make","description":"Vehicle make (e.g., 'Honda', 'Porsche', 'Ford')","required":true},{"name":"model","description":"Vehicle model (e.g., 'CR-V', '911', 'F-150')","required":true},{"name":"zip","description":"5-digit US ZIP code for regional comparison","required":false}]}],"resources":[{"uri":"dealerdirect://network/live-coverage","name":"Live National Dealership & Collector Network Coverage","description":"Real-time counts of indexed franchise dealerships, classic/collector showrooms, live auctions, states covered, and verified New/Used/Classic vehicles.","mimeType":"application/json"},{"uri":"dealerdirect://buyer-shield/guide","name":"Buyer Shield Non-Broker Autonomous OTD Negotiation Protocol Guide","description":"How the 50-state self-serve Buyer Shield software pass (100% FREE / $0.00 during Launch Growth Mode; future standard pricing $39 Everyday / $99 Classic & Collector, $0 reveal/broker fee forever) protects buyer PII and audits dealer Out-The-Door quotes.","mimeType":"text/markdown"},{"uri":"dealerdirect://dealers/directory","name":"Participating US Dealership & Collector Showroom Directory","description":"Directory summary of indexed US franchise dealerships and specialist classic/collector showrooms across all 50 states + DC.","mimeType":"application/json"}],"resourceTemplates":[{"uriTemplate":"dealerdirect://vehicles/{id_or_vin}","name":"Vehicle Detail & Price-Sanity Record by VIN or Vehicle ID","description":"Fetch full dealership VDP metadata, verified pricing status, and dealer fee-audit context for any 17-character VIN or vehicle_id.","mimeType":"application/json"},{"uriTemplate":"dealerdirect://otd-estimate/{id_or_vin}/{buyer_zip}","name":"50-State Pre-Inquiry Out-The-Door (OTD) Fee & Tax Estimator","description":"Compute an instant 50-state pre-inquiry Out-The-Door (OTD) estimate (state sales tax, title/reg, statutory doc-fee cap vs. dealer average, and recommended target/walk-away OTD offers) for any vehicle_id or VIN.","mimeType":"application/json"}]}