{"$schema":"https://smithery.ai/schemas/server-card-v1.json","version":"1.2.1","protocolVersion":"2025-11-25","serverInfo":{"name":"DealerMax","title":"DealerMax — Italian Automotive Cross-Dealer Search","displayName":"DealerMax","version":"1.2.1","homepage":"https://dealermax.app","websiteUrl":"https://dealermax.app","documentationUrl":"https://developers.dealermax.app/mcp","logoUrl":"https://dealermax.app/assets/dealermax-wordmark-light.png","iconUrl":"https://dealermax.app/assets/dealermax-wordmark-light.png","icons":[{"src":"https://dealermax.app/assets/dealermax-wordmark-light.png","mimeType":"image/png"},{"src":"https://dealermax.app/assets/dealermax-wordmark-light.svg","mimeType":"image/svg+xml"}],"license":"CC-BY-4.0","vendor":{"name":"DealerMax","url":"https://dealermax.app","contactEmail":"support@dealermax.app"},"tags":["automotive","cars","italy","marketplace","search","rental","leasing","nlt","knowledge-base"],"categories":["Travel & Transportation","E-Commerce","Search & Data Extraction"],"language":"it,en"},"transport":{"type":"streamable-http","endpoint":"https://mcp.dealermax.app/mcp/"},"authentication":{"required":false,"schemes":[]},"capabilities":{"tools":true,"resources":false,"prompts":false,"logging":false},"tools":[{"name":"get_vehicle_specs","title":"Get vehicle technical specs","description":"Public technical specifications for vehicles in the Italian market. Returns brand, model, trim, fuel type, engine (displacement / HP / kW / cylinders / torque / Euro class), CO2 emissions, fuel consumption (urban / extra-urban / combined), top speed, 0-100 acceleration, dimensions (length / width / height / wheelbase), weight, boot capacity, doors, seats, segment, transmission, drivetrain, tyres, BEV charging info, novice-driver eligibility. Excludes proprietary catalog codes and commercial price lists.","annotations":{"title":"Get vehicle technical specs","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":["string","null"],"description":"Free-text search (e.g. 'Mazda 3 2024', 'Peugeot 2008 ibrido'). Searches brand, model, trim and engine descriptions."},"brand":{"type":["string","null"],"description":"Filter by brand, case-insensitive (e.g. 'BMW', 'Toyota')."},"model":{"type":["string","null"],"description":"Filter by model, case-insensitive (e.g. 'X1', 'Yaris Cross')."},"fuel_type":{"type":["string","null"],"description":"Fuel type: benzina, diesel, ibrida, elettrica, gpl, metano."},"limit":{"type":"integer","description":"Maximum results to return (1-30, default 5).","minimum":1,"maximum":30,"default":5}}},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"search_vehicles","title":"Search used vehicles (DealerMax network)","description":"Cross-dealer semantic search on Italian used vehicles. Filters: region (regione/provincia/citta case-insensitive), brand, fuel type, max budget. Italian + English natural-language queries.","annotations":{"title":"Search used vehicles (DealerMax network)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Italian or English semantic query (e.g. 'SUV ibrido familiare', 'berlina diesel automatica km certificati', 'city car prima auto')."},"region":{"type":["string","null"],"description":"Filter by dealer geo. Accepts region name ('Lombardia'), 2-letter province code ('MI'), full province name ('Milano'), or city ('Cusago'). Case-insensitive, accent-insensitive."},"budget_max":{"type":["integer","null"],"description":"Maximum budget in EUR (vehicle sale price, VAT included)."},"brand":{"type":["string","null"],"description":"Car brand, case-insensitive (e.g. 'BMW', 'Toyota', 'Audi')."},"fuel_type":{"type":["string","null"],"description":"Fuel type: benzina, diesel, ibrida, elettrica, gpl, metano."},"limit":{"type":"integer","description":"Maximum results to return (1-30, default 10).","minimum":1,"maximum":30,"default":10}},"required":["query"]},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"search_nlt_offers","title":"Search NLT (long-term rental) offers","description":"Cross-dealer semantic search on Italian long-term rental (Noleggio Lungo Termine) offers. Filters: max monthly fee, max contract length (36/48/60 months), region, vehicle category (segmento/alimentazione/cambio), auto vs commercial (vehicle_type/vcom_type), minimum seats.","annotations":{"title":"Search NLT (long-term rental) offers","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Italian or English semantic query (e.g. 'elettrica city car under 300/mese', 'SUV ibrido per famiglia', 'BMW X1 con manutenzione inclusa')."},"durata_max_mesi":{"type":["integer","null"],"description":"Max contract duration in months (typical: 36, 48, 60)."},"canone_max":{"type":["integer","null"],"description":"Maximum monthly fee in EUR (VAT included)."},"region":{"type":["string","null"],"description":"Filter by dealer geo. Accepts region name ('Lombardia'), 2-letter province code ('MI', 'MB', 'NO'), full province name ('Milano', 'Monza'), or city ('Cusago', 'Magenta', 'Bellusco', 'Novara'). Case-insensitive, accent-insensitive."},"segmento":{"type":["array","null"],"items":{"type":"string"},"description":"Autovettura category slugs (auto only). Accepts: suv-compatti, suv-piccoli, suv-medi, suv-grandi, utilitarie, superutilitarie, medio-inferiori, medie, superiori, fuoristrada, multispazio."},"alimentazione":{"type":["array","null"],"items":{"type":"string"},"description":"Fuel slugs. Accepts: elettrico, ibrido-benzina, ibrido-diesel, benzina, diesel, gpl, metano."},"cambio":{"type":["array","null"],"items":{"type":"string"},"description":"Transmission slugs. Accepts: automatico, automatico-sequenziale, automatico-doppia-frizione, cvt, manuale."},"vehicle_type":{"type":["string","null"],"enum":["auto","vcom",null],"description":"Macro category: 'auto' (autovetture) or 'vcom' (commercial light vehicles ≤35 q.li). Default null = both."},"vcom_type":{"type":["array","null"],"items":{"type":"string"},"description":"VCOM macro types (applies when vehicle_type='vcom' or null). Accepts: furgoni, cassonati, multispazio, pickup, bus."},"min_seats":{"type":["integer","null"],"minimum":1,"description":"Minimum number of seats (e.g. 7 for people-movers / 9-seat vans / NCC, 9 for 9-seaters only). Each result exposes its actual seat count in the `seats` field. Mirrors the dealer-site '7 o + posti' filter."},"limit":{"type":"integer","description":"Maximum results to return (1-30, default 10).","minimum":1,"maximum":30,"default":10}},"required":["query"]},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"get_vehicle_details","title":"Get vehicle details","description":"Full detail of a single vehicle: specs, price, photos, dealer, optional podcast. Accepts a UUID or a slug ending in UUID.","annotations":{"title":"Get vehicle details","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"vehicle_slug":{"type":"string","description":"Vehicle identifier. Accepts a pure UUID (id_auto) or a friendly slug like 'marca-modello-id_auto' (the trailing UUID segment is extracted)."}},"required":["vehicle_slug"]},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"get_nlt_offer_details","title":"Get NLT offer details","description":"Full detail of a single NLT (long-term rental) offer: all 18 duration×km quotations, 3 anticipo scenarios in EUR (zero/medium/standard), image gallery, category tags, included accessories, network_offers with all DealerMax pioneer dealers proposing the offer (each with own monthly fee calculation). Use after search_nlt_offers to deepen a specific result.","annotations":{"title":"Get NLT offer details","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Unique slug of the NLT offer (e.g. 'business-audi-q3-q3-35-2-0-tdi-business-advanced-s-tronic'). Obtain via the 'slug' field of a search_nlt_offers hit."}},"required":["slug"]},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"find_dealer","title":"Find dealer (directory)","description":"Directory of active dealers in the DealerMax network. Filter by region (region name, province name or 2-letter code, or city) and brand.","annotations":{"title":"Find dealer (directory)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"region":{"type":["string","null"],"description":"Filter by Italian region name ('Lombardia', 'Sicilia'), 2-letter province code ('MI', 'PA'), full province name ('Milano', 'Palermo'), or city ('Cusago', 'Buccinasco'). Case-insensitive, accent-insensitive. Internal map resolves the 110 Italian provinces into the 20 ISTAT regions."},"brand":{"type":["string","null"],"description":"Filter dealers who sell this car brand (case-insensitive)."},"services":{"type":["array","null"],"items":{"type":"string"},"description":"List of dealer services (NOT yet supported — field not normalized in DB)."}}},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}},{"name":"get_market_intel","title":"Get automotive market intelligence","description":"Italian automotive knowledge base: editorial guides, glossary terms, FAQ, automotive news. Semantic search.","annotations":{"title":"Get automotive market intelligence","readOnlyHint":true,"idempotentHint":true,"openWorldHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Italian semantic query (e.g. 'incentivi auto elettriche 2026', 'differenza ibrido plug-in vs full hybrid', 'NLT vantaggi e svantaggi')."},"types":{"type":["array","null"],"items":{"type":"string","enum":["guide","glossary","faq","news"]},"description":"Subset of content types to search: ['guide', 'glossary', 'faq', 'news']. Default: all four."},"limit":{"type":"integer","description":"Maximum total results to return (1-30, default 5).","minimum":1,"maximum":30,"default":5}},"required":["query"]},"outputSchema":{"type":"object","additionalProperties":true,"description":"Structured JSON payload. Shape varies per tool but always JSON object."}}],"_meta":{"performance":{"tools_list_p99_ms":200,"tools_call_p99_ms":1200},"geography":"Italy","data_freshness":"Inventory and offers updated by dealers in real time. KB content refreshed daily.","rate_limit":"Fair-use per IP. Public read-only endpoint.","registry":{"official_name":"app.dealermax/public-search","registry_url":"https://registry.modelcontextprotocol.io/v0.1/servers/app.dealermax%2Fpublic-search/versions/latest","auth":"DNS Ed25519 TXT on dealermax.app"},"nlweb":{"enabled":true,"ask_endpoint_template":"https://{dealer-domain}/ask","server_card_template":"https://{dealer-domain}/.well-known/nlweb.json","spec_url":"https://github.com/microsoft/NLWeb","method":"GET","mode":"list","supported_schemas":["Car","Article","DefinedTerm","Question","Answer","NewsArticle","Brand","PodcastEpisode","PodcastSeries","VideoObject","Offer","Organization","AutoDealer"]}},"configSchema":{"type":"object","properties":{},"additionalProperties":false,"description":"DealerMax MCP server is public read-only. No API key, no OAuth, no user configuration required."}}