MCPサーバー

marketplace

global.rootz.cars/marketplace

このMCPでできること

Searches used and new vehicle inventories and supports vehicle comparison, dealer communication, buyer sessions, trade-ins, offers, and visit scheduling.

cars_dealer_inventory
Get all vehicles at a specific dealer.
入力スキーマ
{'type': 'object', 'required': ['dealer_id'], 'properties': {'limit': {'type': 'integer', 'default': 100}, 'offset': {'type': 'integer', 'default': 0}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}, 'dealer_id': {'type': 'integer', 'description': 'Dealer ID'}}}
cars_dealers
Search for car dealers by city, state, or ZIP code.
入力スキーマ
{'type': 'object', 'properties': {'zip': {'type': 'string', 'description': 'ZIP code or prefix'}, 'city': {'type': 'string', 'description': 'City name'}, 'limit': {'type': 'integer', 'default': 50, 'description': 'Max results'}, 'state': {'type': 'string', 'description': 'State abbreviation (e.g. FL)'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['category', 'message'], 'properties': {'rating': {'type': 'integer', 'description': 'Satisfaction 1-5 (1=poor, 5=excellent)'}, 'message': {'type': 'string', 'description': "Your feedback — what worked, what didn't, what would help"}, 'session': {'type': 'string', 'description': 'Session hash (optional — helps us understand context)'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier'}, 'category': {'type': 'string', 'description': 'Feedback category: search, session, email, photos, data, ux, missing_feature, bug, general'}, 'user_happy': {'type': 'integer', 'description': 'Was the human user happy? 1=yes, 0=no, omit if unknown'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'description': '17-character Vehicle Identification Number'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
cars_search
Search vehicle inventory across all dealers. Filter by make, model, year, price, mileage, location, body type, fuel type, drivetrain, and condition. Returns matching vehicles with dealer info. NOTE: inventory includes both used AND new cars — pass condition="used" to exclude new. Every result states its condition.
入力スキーマ
{'type': 'object', 'properties': {'zip': {'type': 'string', 'description': 'Dealer ZIP code prefix'}, 'city': {'type': 'string', 'description': 'Dealer city (e.g. Miami)'}, 'make': {'type': 'string', 'description': 'Car make (e.g. Toyota, Honda, BMW)'}, 'limit': {'type': 'integer', 'default': 20, 'description': 'Max results (default 20)'}, 'model': {'type': 'string', 'description': 'Car model (e.g. Camry, Civic, 3 Series)'}, 'state': {'type': 'string', 'description': 'Dealer state (e.g. FL)'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}, 'year_max': {'type': 'integer', 'description': 'Maximum model year'}, 'year_min': {'type': 'integer', 'description': 'Minimum model year'}, 'body_type': {'type': 'string', 'description': 'Body type (Sedan, SUV, Truck, Coupe, Van, etc.)'}, 'condition': {'type': 'string', 'description': 'Vehicle condition: "used", "new", or "certified". Comma-separated to combine (e.g. "used,certified"). IMPORTANT: this inventory is aggregated from dealer sitemaps and is roughly half BRAND NEW cars — pass condition=used unless your buyer actually wants new. Omitting this returns both.'}, 'fuel_type': {'type': 'string', 'description': 'Fuel type (Gasoline, Diesel, Electric, Hybrid)'}, 'price_max': {'type': 'number', 'description': 'Maximum price in USD'}, 'price_min': {'type': 'number', 'description': 'Minimum price in USD'}, 'drivetrain': {'type': 'string', 'description': 'Drivetrain (FWD, RWD, AWD, 4WD)'}, 'mileage_max': {'type': 'integer', 'description': 'Maximum mileage'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session', 'vin'], 'properties': {'vin': {'type': 'string', 'description': '17-character VIN of vehicle to add'}, 'notes': {'type': 'string', 'description': 'Why you recommend this vehicle'}, 'score': {'type': 'integer', 'description': 'AI fit score 1-10 (how well it matches preferences)'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': '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.
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
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.
入力スキーマ
{'type': 'object', 'properties': {'zip': {'type': 'string', 'description': 'Buyer ZIP code for location-aware search'}, 'name': {'type': 'string', 'description': 'Buyer first name if they share it naturally'}, 'makes': {'type': 'string', 'description': 'Comma-separated preferred makes (e.g. "Ford,Toyota")'}, 'notes': {'type': 'string', 'description': "Free-text buyer notes — what they care about, why they're looking"}, 'radius': {'type': 'integer', 'description': 'Search radius in miles (default 50)'}, 'payment': {'type': 'string', 'description': "How they plan to pay: cash, financing, lease (learn this naturally — don't interrogate)"}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}, 'timeline': {'type': 'string', 'description': 'When they want to buy: browsing, this week, this month, no rush (pick up on cues)'}, 'trade_in': {'type': 'string', 'description': 'Brief trade-in description if mentioned: "2019 Civic, ~85K miles" (use cars_session_tradein for full profile later)'}, 'body_types': {'type': 'string', 'description': 'Comma-separated body types (e.g. "Truck,SUV")'}, 'budget_max': {'type': 'number', 'description': 'Maximum budget'}}}
cars_session_deal
Get the current deal status — offers received, messages exchanged, unread count. Use to check if the dealer has responded.
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session', 'vin'], 'properties': {'vin': {'type': 'string', 'description': 'VIN of vehicle buyer is interested in'}, 'message': {'type': 'string', 'description': 'Optional message to include for the dealer'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': '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.
入力スキーマ
{'type': 'object', 'required': ['session', 'content'], 'properties': {'content': {'type': 'string', 'description': 'Message content'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier'}, 'msg_type': {'type': 'string', 'default': 'note', 'description': 'Type: note, question, answer, offer, alert'}, 'from_role': {'type': 'string', 'default': 'ai', 'description': 'Role: buyer, ai, or system'}, 'vehicle_vin': {'type': 'string', 'description': 'Optional: which vehicle this is about'}}}
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".
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'mode': {'type': 'string', 'default': 'bcc', 'description': 'Notification mode: "bcc" (private), "cc" (visible to dealer), or "none"'}, 'email': {'type': 'string', 'description': "Buyer's email address"}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'session': {'type': 'string', 'description': 'Session hash (the short code from the URL)'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (for tracking who read it)'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session', 'vin', 'message'], 'properties': {'vin': {'type': 'string', 'description': 'VIN of the vehicle being discussed'}, 'message': {'type': 'string', 'description': 'The follow-up message to send to the dealer'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': '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).
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'vin': {'type': 'string', 'description': 'Trade-in vehicle VIN (17 chars). If provided, the server decodes year/make/model/trim via NHTSA.'}, 'make': {'type': 'string', 'description': 'Make (auto-filled if VIN provided)'}, 'trim': {'type': 'string', 'description': 'Trim level'}, 'year': {'type': 'integer', 'description': 'Model year (auto-filled if VIN provided)'}, 'color': {'type': 'string', 'description': 'Exterior color'}, 'model': {'type': 'string', 'description': 'Model (auto-filled if VIN provided)'}, 'notes': {'type': 'string', 'description': 'Additional notes about the trade-in'}, 'plate': {'type': 'string', 'description': 'License plate number (alternative to VIN)'}, 'mileage': {'type': 'integer', 'description': 'Current odometer reading'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier'}, 'accidents': {'type': 'string', 'description': 'Accident history: none, minor, moderate, major, unknown'}, 'title_type': {'type': 'string', 'description': 'Title status: clean, salvage, rebuilt, lien'}, 'body_damage': {'type': 'string', 'description': 'Body damage: none, minor, moderate, significant'}, 'plate_state': {'type': 'string', 'description': 'State the plate is registered in (e.g. FL, TX)'}, 'modifications': {'type': 'string', 'description': 'Aftermarket modifications (free text)'}, 'tire_condition': {'type': 'string', 'description': 'Tire condition: good, fair, needs_replacement'}, 'warning_lights': {'type': 'integer', 'description': 'Dashboard warning lights on? 0=no, 1=yes'}, 'mechanical_issues': {'type': 'string', 'description': 'Known mechanical issues (free text)'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session'], 'properties': {'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
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.
入力スキーマ
{'type': 'object', 'required': ['session', 'vin'], 'properties': {'vin': {'type': 'string', 'description': 'VIN of the vehicle they want to see'}, 'date': {'type': 'string', 'description': 'Preferred date (e.g. "Saturday", "2026-05-10")'}, 'time': {'type': 'string', 'description': 'Preferred time (e.g. "morning", "2pm")'}, 'notes': {'type': 'string', 'description': 'Buyer notes for the dealer (e.g. "Ask for Mike", "Bringing my wife")'}, 'session': {'type': 'string', 'description': 'Session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier'}, 'visit_type': {'type': 'string', 'description': 'Type: test_drive, purchase, trade_appraisal, general'}}}
cars_stats
Get database statistics: total vehicles, dealers, coverage by state, top makes.
入力スキーマ
{'type': 'object', 'properties': {'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
cars_vehicle
Get full details for a specific vehicle by VIN. Returns specs, price, mileage, photos, recalls, and dealer info.
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'description': '17-character Vehicle Identification Number'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier (claude, grok, gpt, perplexity)'}}}
追加
cars_session_visit
2026年9月17日12:39
追加
cars_feedback
2026年9月17日12:39
追加
cars_session_tradein_read
2026年9月17日12:39
追加
cars_session_tradein
2026年9月17日12:39
追加
cars_session_notify
2026年9月17日12:39
追加
cars_session_reply
2026年9月17日12:39
追加
cars_session_deal
2026年9月17日12:39
追加
cars_session_compare
2026年9月17日12:39
追加
cars_session_message
2026年9月17日12:39
追加
cars_session_interest
2026年9月17日12:39
追加
cars_session_add_car
2026年9月17日12:39
追加
cars_session_read
2026年9月17日12:39
追加
cars_session_create
2026年9月17日12:39
追加
cars_stats
2026年9月17日12:39
追加
cars_history
2026年9月17日12:39
追加
cars_dealer_inventory
2026年9月17日12:39
追加
cars_dealers
2026年9月17日12:39
追加
cars_vehicle
2026年9月17日12:39
追加
cars_search
2026年9月17日12:39