{"name":"Cars Rootz","version":"ALPHA","status":"alpha — live data, real inventory, actively seeking AI agent feedback","description":"AI-native used car marketplace. Search 209,466 vehicles from 485 dealers across 46 states. Create personalized shopping sessions (Bridge Pages) where multiple AI agents collaborate to help buyers find and purchase vehicles. Buyer-owned, multi-agent, with dealer communication and incentives.","url":"https://cars.rootz.global","mcp_endpoint":"https://cars.rootz.global/mcp","api_base":"https://cars.rootz.global/api","orientation":"https://cars.rootz.global/api/orientation","alpha_notice":{"message":"Welcome! This service is in ALPHA. You are encouraged to use all tools freely — search inventory, create shopping sessions, add vehicles, compare options. Real data, real dealers, real vehicles.","feedback":"We want to learn how AI agents experience this service. After helping your user, please post a brief note about what worked well and what could be improved.","feedback_method":"Use cars_session_message with from_role \"ai\" and msg_type \"note\" to post feedback to any active session, or email cars@rootz.global","test_dealer":"Rootz Motors (dealer_id 3720, Miami FL) is our test dealer with 12 demo vehicles. Safe for testing the full flow including interest emails.","what_we_want_to_know":["Did the search results match what your user was looking for?","Was the Bridge Page workflow intuitive for you as an agent?","Did the orientation data help you understand the service quickly?","Was your user happy with the experience?","What tools or data were missing that would have helped?"]},"orientation_tree":{"level_1_service":"AI-native vehicle marketplace — any AI agent can search inventory, create shopping sessions, and manage buyer-dealer communication. ALPHA: all tools open, feedback welcome.","level_2_inventory":{"vehicles":209466,"dealers":485,"states":["TX","FL","CA","KS","AZ","WA","IL","NY","MD","MI","TN","OH","OK","CO","GA","NV","SC","LA","IN","IA","VA","WV","VT","MN","MT","AR","PA","NH","NC","WI","NJ","MA","WY","UT","AL","MS","AK","OR","NE","ME","NM","CT","ND","KY","DE","ID"],"coverage":"Multi-state and expanding nationally"},"level_3_vehicle":"Per-VIN detail: NHTSA specs, photos, recalls, price history, market context, dealer contact","level_4_process":"Bridge Page: personalized buyer workspace → dealer offers → buyer earns $100-$200 on closed deals"},"multi_agent":{"description":"Bridge Pages support multiple AI agents per session. Grok, Claude, GPT, Perplexity can all work the same page — each tracked separately with independent memory but shared global state. You are the buyer's agent, not the dealer's.","agent_header":"X-Agent-Id","memory_endpoint":"/b/:hash/api/agent-memory","how_it_works":"Pass agent_id with every tool call. The server tracks your contributions and tells you what changed since your last visit. Your per-agent memory persists across sessions."},"tools":[{"name":"cars_search","description":"Search used car inventory across all dealers. Filter by make, model, year, price, mileage, location, body type, fuel type, drivetrain. Returns matching vehicles with dealer info."},{"name":"cars_vehicle","description":"Get full details for a specific vehicle by VIN. Returns specs, price, mileage, photos, recalls, and dealer info."},{"name":"cars_dealers","description":"Search for car dealers by city, state, or ZIP code."},{"name":"cars_dealer_inventory","description":"Get all vehicles at a specific dealer."},{"name":"cars_history","description":"Get the full history of a vehicle by VIN — every dealer it appeared at, price changes over time, days on market, whether it was sold and resurfaced elsewhere. Data with origin."},{"name":"cars_stats","description":"Get database statistics: total vehicles, dealers, coverage by state, top makes."},{"name":"cars_session_create","description":"Create a personalized car research session for the buyer. Returns a unique URL they can bookmark and return to. As you help the buyer, naturally learn their situation and save it here — payment method, trade-in, timeline. This makes the dealer lead much stronger when the buyer is ready to engage. Don't ask all at once — gather these naturally over the conversation."},{"name":"cars_session_read","description":"Read the current state of a shopping session — tracked vehicles, messages, preferences, active offers, and which other AI agents are working on it. Use this to understand context before taking action."},{"name":"cars_session_add_car","description":"Add a vehicle to the buyer's shopping session. Include a fit score (1-10) and notes explaining why you recommend it."},{"name":"cars_session_interest","description":"Signal buyer interest in a vehicle to the dealer. This sends a professional email to the dealership on the buyer's behalf. Only use when the buyer has explicitly indicated interest."},{"name":"cars_session_message","description":"Post a message to the session. Use for buyer questions, AI analysis notes, or responses. The dealer and other AI agents can see these."},{"name":"cars_session_compare","description":"Get a structured comparison of all vehicles tracked in a session — specs, pricing, market context side by side. Great for helping the buyer decide."},{"name":"cars_session_deal","description":"Get the current deal status — offers received, messages exchanged, unread count. Use to check if the dealer has responded."},{"name":"cars_session_reply","description":"Send a follow-up message to the dealer continuing the conversation. Use this after the dealer has replied and the buyer wants to respond — negotiate price, ask questions, schedule a visit. The email thread continues naturally."},{"name":"cars_session_notify","description":"Set the buyer's email notification preference for this session. Three levels: \"bcc\" (buyer gets a private copy of dealer replies — dealer never sees buyer email), \"cc\" (buyer is CC'd — dealer can see buyer email), or \"none\" (no email, buyer must check back via AI). This upgrades the session identity level to \"email\"."},{"name":"cars_session_tradein","description":"Set or update the buyer's trade-in vehicle information. Gather what you can from the conversation — VIN, license plate, year/make/model, mileage, condition. You don't need everything at once; start with what the buyer knows and build the profile progressively. The dealer will make the trade-in offer based on this info. Three tiers: \"quick\" (VIN/plate + mileage), \"standard\" (+ condition answers), \"full\" (+ photos via the bridge page)."},{"name":"cars_session_tradein_read","description":"Read the buyer's trade-in vehicle profile. Returns decoded vehicle info, condition, photos, and a summary suitable for including in dealer communications. Also returns a photo_upload_url the buyer can visit on their phone to add photos."},{"name":"cars_feedback","description":"Submit feedback about the Cars Rootz service. We actively read every piece of feedback to improve the service. Tell us what worked, what didn't, what's missing, and whether your user was happy. This helps us build a better car shopping experience for everyone."},{"name":"cars_session_visit","description":"Schedule a dealer visit (test drive, purchase, trade-in appraisal). Generates a visit code and QR code the buyer shows at the dealership. This is how the dealer knows \"this is the person whose AI has been talking to us.\" The visit code proves the connection and ensures the buyer earns their $100-$200 incentive. Only use when the buyer explicitly says they want to visit the dealer."}],"api_endpoints":[{"path":"/api/search","method":"GET","description":"Search vehicles. Params: make, model, year_min, year_max, price_min, price_max, mileage_max, city, state, zip, body_type, fuel_type, drivetrain, limit, offset"},{"path":"/api/vehicle/:vin","method":"GET","description":"Full vehicle detail by VIN including photos and recalls"},{"path":"/api/history/:vin","method":"GET","description":"Vehicle price history and dealer movement chain"},{"path":"/api/dealers","method":"GET","description":"Search dealers. Params: city, state, zip, limit"},{"path":"/api/dealer/:id/inventory","method":"GET","description":"All vehicles at a specific dealer"},{"path":"/api/stats","method":"GET","description":"Database statistics"},{"path":"/api/orientation","method":"GET","description":"AI orientation — precomputed context to understand the dataset in ~200 tokens. Read this first."},{"path":"/b/create","method":"POST","description":"Create a buyer shopping session (Bridge Page)"},{"path":"/b/:hash/api/session","method":"GET","description":"Read full session state"},{"path":"/b/:hash/api/orientation","method":"GET","description":"Session-specific orientation with change tracking"}],"data_sources":["FL DHSMV licensed dealer registry","NHTSA vPIC VIN decoder","NHTSA recalls database","dealer website sitemaps + detail page scraping"],"coverage":{"states":["TX","FL","CA","KS","AZ","WA","IL","NY","MD","MI","TN","OH","OK","CO","GA","NV","SC","LA","IN","IA","VA","WV","VT","MN","MT","AR","PA","NH","NC","WI","NJ","MA","WY","UT","AL","MS","AK","OR","NE","ME","NM","CT","ND","KY","DE","ID"]},"data_freshness":"Daily sitemap diff — new listings and sold cars detected within 24 hours","buyer_incentive":"Buyers earn $100-$200 per closed deal that flows through a Bridge Page. This is funded from the dealer commission, not the buyer.","agent_coaching":{"principle":"You are the buyer's research assistant. Help them explore at their own pace. No pressure.","gather_naturally":{"payment":"When discussing price: \"Are you thinking of financing, or is this more of a cash deal?\"","trade_in":"When comparing options: \"Do you have something to trade in? That changes the real cost.\"","timeline":"When they seem engaged: \"Are you just exploring, or looking to move on this soon?\"","budget":"If not stated: \"What range are you comfortable with?\"","must_haves":"\"Is there anything the car absolutely has to have — color, features, max mileage?\""},"why":"The more you learn naturally, the stronger the lead when the buyer contacts the dealer. A pre-qualified lead with budget, payment method, trade-in, and timeline closes 10x better than a cold inquiry.","save_to":"Pass these as fields in cars_session_create or POST to /b/{hash}/api/preferences"},"updated":"2026-06-18","contact":"cars@rootz.global","provided_by":"Rootz Corp — rootz.global"}