global.rootz.cars/marketplace
Official19 toolsAI-native used car marketplace. 145K+ vehicles, 4300+ dealers, 13 US states, 20 MCP tools.
AI-powered used car marketplace with 145K+ vehicles from 4300+ dealers across 13 US states.
Captured live from the server via tools/list.
cars_search
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.
Parameters (15)
- makestring
Car make (e.g. Toyota, Honda, BMW)
- modelstring
Car model (e.g. Camry, Civic, 3 Series)
- year_mininteger
Minimum model year
- year_maxinteger
Maximum model year
- price_minnumber
Minimum price in USD
- price_maxnumber
Maximum price in USD
- mileage_maxinteger
Maximum mileage
- citystring
Dealer city (e.g. Miami)
- statestring
Dealer state (e.g. FL)
- zipstring
Dealer ZIP code prefix
- body_typestring
Body type (Sedan, SUV, Truck, Coupe, Van, etc.)
- fuel_typestring
Fuel type (Gasoline, Diesel, Electric, Hybrid)
- drivetrainstring
Drivetrain (FWD, RWD, AWD, 4WD)
- limitinteger
Max results (default 20)
- offsetinteger
Pagination offset
cars_vehicle
Get full details for a specific vehicle by VIN. Returns specs, price, mileage, photos, recalls, and dealer info.
Parameters (1)
- vinstringrequired
17-character Vehicle Identification Number
cars_dealers
Search for car dealers by city, state, or ZIP code.
Parameters (4)
- citystring
City name
- statestring
State abbreviation (e.g. FL)
- zipstring
ZIP code or prefix
- limitinteger
Max results
cars_dealer_inventory
Get all vehicles at a specific dealer.
Parameters (3)
- dealer_idintegerrequired
Dealer ID
- limitinteger
- offsetinteger
cars_history
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.
Parameters (1)
- vinstringrequired
17-character Vehicle Identification Number
cars_stats
Get database statistics: total vehicles, dealers, coverage by state, top makes.
No parameters.
cars_session_create
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.
Parameters (11)
- zipstring
Buyer ZIP code for location-aware search
- radiusinteger
Search radius in miles (default 50)
- budget_maxnumber
Maximum budget
- makesstring
Comma-separated preferred makes (e.g. "Ford,Toyota")
- body_typesstring
Comma-separated body types (e.g. "Truck,SUV")
- paymentstring
How they plan to pay: cash, financing, lease (learn this naturally — don't interrogate)
- timelinestring
When they want to buy: browsing, this week, this month, no rush (pick up on cues)
- trade_instring
Brief trade-in description if mentioned: "2019 Civic, ~85K miles" (use cars_session_tradein for full profile later)
- namestring
Buyer first name if they share it naturally
- notesstring
Free-text buyer notes — what they care about, why they're looking
- agent_idstring
Your agent identifier (claude, grok, gpt, perplexity)
cars_session_read
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.
Parameters (2)
- sessionstringrequired
Session hash (the short code from the URL)
- agent_idstring
Your agent identifier (for tracking who read it)
cars_session_add_car
Add a vehicle to the buyer's shopping session. Include a fit score (1-10) and notes explaining why you recommend it.
Parameters (5)
- sessionstringrequired
Session hash
- vinstringrequired
17-character VIN of vehicle to add
- scoreinteger
AI fit score 1-10 (how well it matches preferences)
- notesstring
Why you recommend this vehicle
- agent_idstring
Your agent identifier
cars_session_interest
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.
Parameters (4)
- sessionstringrequired
Session hash
- vinstringrequired
VIN of vehicle buyer is interested in
- messagestring
Optional message to include for the dealer
- agent_idstring
Your agent identifier
cars_session_message
Post a message to the session. Use for buyer questions, AI analysis notes, or responses. The dealer and other AI agents can see these.
Parameters (6)
- sessionstringrequired
Session hash
- contentstringrequired
Message content
- from_rolestring
Role: buyer, ai, or system
- vehicle_vinstring
Optional: which vehicle this is about
- msg_typestring
Type: note, question, answer, offer, alert
- agent_idstring
Your agent identifier
cars_session_compare
Get a structured comparison of all vehicles tracked in a session — specs, pricing, market context side by side. Great for helping the buyer decide.
Parameters (1)
- sessionstringrequired
Session hash
cars_session_deal
Get the current deal status — offers received, messages exchanged, unread count. Use to check if the dealer has responded.
Parameters (1)
- sessionstringrequired
Session hash
cars_session_reply
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.
Parameters (4)
- sessionstringrequired
Session hash
- vinstringrequired
VIN of the vehicle being discussed
- messagestringrequired
The follow-up message to send to the dealer
- agent_idstring
Your agent identifier
cars_session_notify
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".
Parameters (4)
- sessionstringrequired
Session hash
- emailstringrequired
Buyer's email address
- modestring
Notification mode: "bcc" (private), "cc" (visible to dealer), or "none"
- agent_idstring
Your agent identifier
cars_session_tradein
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).
Parameters (19)
- sessionstringrequired
Session hash
- vinstring
Trade-in vehicle VIN (17 chars). If provided, the server decodes year/make/model/trim via NHTSA.
- platestring
License plate number (alternative to VIN)
- plate_statestring
State the plate is registered in (e.g. FL, TX)
- yearinteger
Model year (auto-filled if VIN provided)
- makestring
Make (auto-filled if VIN provided)
- modelstring
Model (auto-filled if VIN provided)
- trimstring
Trim level
- colorstring
Exterior color
- mileageinteger
Current odometer reading
- title_typestring
Title status: clean, salvage, rebuilt, lien
- accidentsstring
Accident history: none, minor, moderate, major, unknown
- warning_lightsinteger
Dashboard warning lights on? 0=no, 1=yes
- tire_conditionstring
Tire condition: good, fair, needs_replacement
- body_damagestring
Body damage: none, minor, moderate, significant
- mechanical_issuesstring
Known mechanical issues (free text)
- modificationsstring
Aftermarket modifications (free text)
- notesstring
Additional notes about the trade-in
- agent_idstring
Your agent identifier
cars_session_tradein_read
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.
Parameters (1)
- sessionstringrequired
Session hash
cars_feedback
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.
Parameters (6)
- categorystringrequired
Feedback category: search, session, email, photos, data, ux, missing_feature, bug, general
- ratinginteger
Satisfaction 1-5 (1=poor, 5=excellent)
- messagestringrequired
Your feedback — what worked, what didn't, what would help
- user_happyinteger
Was the human user happy? 1=yes, 0=no, omit if unknown
- sessionstring
Session hash (optional — helps us understand context)
- agent_idstring
Your agent identifier
cars_session_visit
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.
Parameters (7)
- sessionstringrequired
Session hash
- vinstringrequired
VIN of the vehicle they want to see
- visit_typestring
Type: test_drive, purchase, trade_appraisal, general
- datestring
Preferred date (e.g. "Saturday", "2026-05-10")
- timestring
Preferred time (e.g. "morning", "2pm")
- notesstring
Buyer notes for the dealer (e.g. "Ask for Mike", "Bringing my wife")
- agent_idstring
Your agent identifier
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://cars.rootz.global/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.