dealers.get_booking_details
ChatGPTUse this when: User wants to book an appointment or get contact details for a specific dealer from search results. ⚠️ CRITICAL LIMITATIONS: This tool returns ONLY contact information and booking URL. It does NOT provide: - Appointment availability or scheduling details - Service center hours or wait times - Pricing, service quality, or reviews - Operational details about this specific dealer - Any information beyond basic contact details DO NOT make recommendations about: - Best time to book appointments - Service quality or reliability - Dealership practices or upselling patterns - Wait times or service speed What this ACTUALLY returns: - Booking URL (for user to schedule directly) - Phone number (for user to call) - Email and address - List of brands/products dealer carries When to use: - ✅ User needs booking URL or contact info for a specific dealer - ✅ User asks "How do I contact this dealer?" When NOT to use: - ❌ User asks about hours, availability, pricing, wait times → Tell them to use booking URL or call - ❌ Searching for dealers → Use dealers.search_nearby_by_brand instead After calling this tool: Provide ONLY the contact info returned. Direct user to booking URL for any scheduling/service questions.
dealers.list_brands
ChatGPTUse this when: User asks "what brands do you have?", "what car companies are available?", or wants to see all options before searching for dealers. What this does: Returns complete list of car manufacturers AND service providers in the network. IMPORTANT: "Brands" is overloaded - includes TWO categories: 1. Car Manufacturers: Honda, Toyota, BMW, Ford, etc. (brand-specific dealerships) 2. Service Providers: Glass Repair, Rent a Car, Auto Insurance, etc. (work with ANY vehicle) When to use: - "What car brands do you support?" - "Do you have Honda dealers?" - "What services are available?" - "Can I find glass repair shops?" When NOT to use: - User just wants nearby dealers without caring about brand → Skip this, go straight to dealers.search_by_location - General car questions like "What's the best car to buy?" or "Tell me about Honda reliability" → Use web search instead - Questions about car prices or features → Use web search instead Returns: Categorized list of car manufacturers and service providers with IDs and logos. Use this info to answer questions about brand availability.
dealers.search_by_brand
ChatGPT⚠️ STOP! DO NOT USE THIS TOOL unless user explicitly wants "ALL" or "every" dealer nationwide! If user mentions ANY location (city, state, "near me", address), use dealers.search_nearby_by_brand instead! What this returns: EVERY location for a brand nationwide (100s-1000s of results, unordered, no distance sorting). When to use (VERY RARE): - ✅ "Show me EVERY Honda dealer in your entire network" - ✅ "List ALL Toyota dealers you have" - ✅ User explicitly wants complete nationwide list When NOT to use (use dealers.search_nearby_by_brand instead): - ❌ "Honda dealers near me" → dealers.search_nearby_by_brand - ❌ "Find Chevy dealers in Charlottesville" → dealers.search_nearby_by_brand - ❌ "Toyota dealers in Virginia" → dealers.search_nearby_by_brand - ❌ "Ford dealers close to Brooklyn" → dealers.search_nearby_by_brand - ❌ ANY query with location words (near, in, at, close, nearby, around, etc.) → dealers.search_nearby_by_brand If unsure, DEFAULT to dealers.search_nearby_by_brand - it's the right tool 95% of the time. Each location includes: - business_category: Type of business (Car Dealership, Auto Glass Shop, Tire Shop, etc.) - services: Array of specific services offered (e.g., "Windshield Chip Repair", "Tire rotation") Returns: ALL brand locations (could be 1000+). Map may be slow to render.
dealers.search_nearby
ChatGPTUse this for UNIVERSAL SERVICES that all dealerships offer, or when no specific brand is mentioned. What this returns: Up to 20 nearest service locations (dealerships/repair shops) sorted by distance. LOCATION HANDLING: - If user specifies a location (city, address, "near X"), geocode it to lat/lng - If user says "near me" or doesn't specify location, USE THE USER'S KNOWN COORDINATES - do NOT ask for clarification - Always default to user's current/known location when no location is mentioned ✅ UNIVERSAL SERVICES - Use this tool (all locations offer these): - "Oil change near me" → use this tool - "Brake service" → use this tool - "Car maintenance near me" → use this tool - "Auto service" → use this tool - "Where can I get my car serviced?" → use this tool - "Car inspection" → use this tool ✅ NO BRAND MENTIONED: - "Find dealers near me" → use this tool - "Service centers near Brooklyn" → use this tool ❌ SPECIFIC BRAND - Use dealers.search_nearby_by_brand: - "Honda dealers near me" → dealers.search_nearby_by_brand - "Toyota service center" → dealers.search_nearby_by_brand ❌ SPECIALTY SERVICES - Use dealers.search_nearby_by_brand with service brand: - "Glass repair" → dealers.search_nearby_by_brand (Glass Repair brand) - "Rent a car" → dealers.search_nearby_by_brand (Rent a Car brand) - "New tires" / "Tire shop" / "Tire installation" → dealers.search_nearby_by_brand (Tire and Wheel brand) - "Wheel alignment" / "Tire rotation" → dealers.search_nearby_by_brand (Tire and Wheel brand) Each location includes: - business_category: Type of business (Car Dealership, Auto Glass Shop, Tire Shop, etc.) - services: Array of specific services offered (e.g., "Oil Change", "Brake Inspection") TIP: Read the resource data://taxonomy/category-services.json to understand which business categories offer which services. Returns: Up to 20 locations (dealerships/repair shops) sorted by distance. Map widget will render.
dealers.search_nearby_by_brand
ChatGPT✅ DEFAULT TOOL for brand queries and specialty service queries! Use this whenever user mentions a brand name or needs a specialty service. What this returns: Up to 20 nearest dealers for the specified brand, sorted by distance. LOCATION HANDLING: - If user specifies a location (city, address, "near X"), geocode it to lat/lng - If user says "near me" or doesn't specify location, USE THE USER'S KNOWN COORDINATES - do NOT ask for clarification - Always default to user's current/known location when no location is mentioned WORKFLOW: 1. Treat brand_id as UNKNOWN by default. It is ONLY "known" if: - a prior tool call in this same conversation explicitly returned a brand_id that you have kept track of (for example from dealers.list_brands or another dealers.* tool), AND - the user is clearly still talking about that same previously-selected brand. 2. If brand_id is unknown for the brand the user is asking about, first call dealers.list_brands to map the user's brand name (e.g. "Honda", "Glass Repair", "Tire and Wheel") to the correct brand_id. Ask a brief clarification question if their brand choice is ambiguous. 3. Once you have a specific brand_id value for the brand the user wants, call THIS tool with latitude + longitude + that brand_id. When to use (MOST COMMON): - ✅ "Find Honda dealers near me" → use user's known coordinates - ✅ "Honda dealers" → use user's known coordinates (location implied) - ✅ "Chevy dealers in Charlottesville" → geocode Charlottesville - ✅ "Toyota service centers near Brooklyn" → geocode Brooklyn - ✅ "Where can I service my Mazda?" → use user's known coordinates - ✅ ANY query with a brand name - ✅ "I need new tires" → get Tire and Wheel brand_id first - ✅ "Tire shop near me" → get Tire and Wheel brand_id first - ✅ "Where can I get my tires replaced?" → get Tire and Wheel brand_id first - ✅ "Wheel alignment" / "Tire rotation" → get Tire and Wheel brand_id first When NOT to use: - ❌ No brand mentioned AND not a specialty service → dealers.search_nearby instead - ❌ User wants "ALL" or "every" dealer nationwide → dealers.search_by_brand - ❌ Need booking details → dealers.get_booking_details - ❌ UNIVERSAL SERVICES (all locations offer these) → dealers.search_nearby instead: - "Oil change near me" → dealers.search_nearby - "Brake service" → dealers.search_nearby - "Car maintenance" → dealers.search_nearby - "Auto service" → dealers.search_nearby SPECIALTY SERVICE BRANDS (get brand_id from dealers.list_brands first): - "Glass Repair" brand → Returns auto glass shops - "Rent a Car" brand → Returns car rental locations - "Tire and Wheel" brand → Returns tire shops Each location includes: - business_category: Type of business (Car Dealership, Auto Glass Shop, Tire Shop, etc.) - services: Array of specific services offered (e.g., "Windshield Chip Repair", "Tire installation") TIP: Read the resource data://taxonomy/category-services.json to understand which business categories offer which services before searching. Returns: Up to 20 brand-specific locations sorted by distance. Interactive map widget renders automatically.
