AutoMotion

Use 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.

Use 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.

⚠️ 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.

Use 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.

✓ 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.