Car Handshake
Find and compare live vehicle inventory from participating US dealers and contact them with consent.
我该使用它吗
质量与安全性
B
发现（4）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains suspicious base64-like encoded string在 shop_vehicles 中
- LOWTool 'get_dealership' description lacks action verb在 get_dealership 中
- LOWTool 'fetch' suggests web access but openWorldHint=false在 fetch 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~7,419token 数（工具定义）
~7.9 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 5.80%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"inventory": {
"url": "https://mcp.carhandshake.com/mcp"
}
}
}远程端点
https://mcp.carhandshake.com/mcpstreamable-http它能做什么
工具清单
工具（10）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢shop_vehicles(request, country, location_text, radius_miles, nationwide, ...)
Use for live US/CA cars/SUVs/trucks/EVs/motorcycles/RVs/trailers by place (near me), budget, mileage, make/model, condition, body, fuel, features, named dealer, or live-listing recommendation. Quebec excluded. Call once; never retry/refine/broaden. Fallback stays in-country; filters exact. Facts only; web only if asked. Named-dealer stock: find_dealerships then shop. Not repair/reliability/facts/MSRP/out-of-market, named-source, web-only, or no-app. Verbatim request; never ask for ZIP/postal.
输入模式
{
"type": "object",
"properties": {
"request": {
"type": "string",
"minLength": 2,
"maxLength": 500,
"description": "Verbatim shopper request."
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
],
"description": "US default; CA supported outside Quebec."
},
"location_text": {
"type": "string",
"maxLength": 120,
"description": "Free-text city/place/state/postal exactly as the shopper supplied; never ask for a ZIP code."
},
"radius_miles": {
"type": "number",
"minimum": 1,
"maximum": 500,
"description": "US miles; CA kilometres. Fallback widens geography only; filters remain exact."
},
"nationwide": {
"type": "boolean"
},
"vehicle_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"car",
"motorcycle",
"trailer",
"rv",
"other"
]
},
"maxItems": 5
},
"makes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"models": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"trims": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"conditions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"new",
"used",
"cpo"
]
},
"maxItems": 3
},
"bodies": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"fuels": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"drivelines": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"transmissions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"exterior_colors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"interior_colors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"features": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Classes: third_row, awd_4wd, tow_package, apple_carplay, android_auto, adaptive_cruise, leather, heated_seats, ev_range_200_plus."
},
"dealer_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"maxItems": 50
},
"year_min": {
"type": "integer",
"minimum": 1886,
"maximum": 2200
},
"year_max": {
"type": "integer",
"minimum": 1886,
"maximum": 2200
},
"price_min": {
"type": "integer",
"minimum": 0
},
"price_max": {
"type": "integer",
"minimum": 0
},
"mileage_max": {
"type": "integer",
"minimum": 0
},
"displacement_cc_min": {
"type": "integer",
"minimum": 0
},
"displacement_cc_max": {
"type": "integer",
"minimum": 0
},
"electric_range_min": {
"type": "number",
"minimum": 0
},
"electric_range_max": {
"type": "number",
"minimum": 0
},
"dc_fast_charge": {
"type": "boolean"
},
"charge_ports": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50
},
"statuses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"available",
"intransit"
]
},
"maxItems": 2,
"description": "Omit unless status is explicit; omission searches both available and intransit."
},
"sort_by": {
"type": "string",
"enum": [
"relevance",
"distance",
"price",
"mileage",
"year",
"freshness"
],
"description": "Default: relevance."
},
"sort_direction": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"cursor": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$",
"maxLength": 12288
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"request"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"total_relation": {
"type": "string",
"enum": [
"eq",
"gte"
]
},
"matches": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"listing": {
"type": "object",
"additionalProperties": false,
"properties": {
"listing_id": {
"type": "string",
"format": "uuid"
},
"vin": {
"type": "string"
},
"stock": {
"type": [
"string",
"null"
]
},
"year": {
"type": "integer"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"trim": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": "string",
"enum": [
"car",
"motorcycle",
"trailer",
"rv",
"other"
]
},
"displacement_cc": {
"type": [
"number",
"null"
]
},
"battery_kwh": {
"type": [
"number",
"null"
]
},
"motor_power_hp": {
"type": [
"number",
"null"
]
},
"dc_fast_charge": {
"type": [
"boolean",
"null"
]
},
"charge_port": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
],
"enum": [
"new",
"used",
"cpo",
null
]
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"driveline": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"exterior_color": {
"type": [
"string",
"null"
]
},
"interior_color": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"integer",
"null"
]
},
"currency": {
"type": "string",
"enum": [
"USD",
"CAD"
]
},
"msrp": {
"type": [
"integer",
"null"
]
},
"mileage": {
"type": [
"integer",
"null"
]
},
"electric_range_miles": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string",
"enum": [
"available",
"intransit"
]
},
"primary_photo_url": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"distance_miles": {
"type": [
"number",
"null"
]
},
"dealer": {
"type": "object",
"additionalProperties": false,
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"agent_card_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"dealer_id",
"name",
"domain",
"agent_card_url"
]
},
"location": {
"type": "object",
"additionalProperties": false,
"properties": {
"location_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"address_line_1": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"geocode_precision": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"location_id",
"name",
"country"
]
},
"listing_url": {
"type": [
"string",
"null"
]
},
"listing_url_source": {
"type": [
"string",
"null"
],
"enum": [
"car_handshake",
"dealer_vdp",
null
]
}
},
"required": [
"listing_id",
"year",
"make",
"model",
"vehicle_type",
"status",
"dealer",
"location"
]
},
"fit_reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"tradeoffs": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"listing",
"fit_reasons",
"tradeoffs"
]
}
},
"next_action": {
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"interpreted_request": {
"type": "object",
"additionalProperties": false,
"properties": {
"original": {
"type": [
"string",
"null"
]
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"location": {
"type": [
"object",
"null"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"postal",
"place",
"region"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"region_code": {
"type": "string"
},
"label": {
"type": "string"
},
"confidence": {
"type": "number"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"region_code": {
"type": "string"
},
"label": {
"type": "string"
},
"inventory_count": {
"type": "integer"
}
}
}
}
},
"required": [
"kind",
"country",
"region_code",
"label",
"confidence",
"latitude",
"longitude",
"candidates"
]
}
},
"required": [
"original",
"assumptions",
"location"
]
},
"applied_filters": {
"type": "object",
"additionalProperties": false,
"properties": {
"vehicle_types": {
"type": "array",
"items": {
"type": "string"
}
},
"makes": {
"type": "array",
"items": {
"type": "string"
}
},
"models": {
"type": "array",
"items": {
"type": "string"
}
},
"trims": {
"type": "array",
"items": {
"type": "string"
}
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"bodies": {
"type": "array",
"items": {
"type": "string"
}
},
"fuels": {
"type": "array",
"items": {
"type": "string"
}
},
"drivelines": {
"type": "array",
"items": {
"type": "string"
}
},
"transmissions": {
"type": "array",
"items": {
"type": "string"
}
},
"exterior_colors": {
"type": "array",
"items": {
"type": "string"
}
},
"interior_colors": {
"type": "array",
"items": {
"type": "string"
}
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"dealer_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"year_min": {
"type": "integer"
},
"year_max": {
"type": "integer"
},
"price_min": {
"type": "integer"
},
"price_max": {
"type": "integer"
},
"mileage_max": {
"type": "integer"
},
"displacement_cc_min": {
"type": "integer"
},
"displacement_cc_max": {
"type": "integer"
},
"electric_range_min": {
"type": "number"
},
"electric_range_max": {
"type": "number"
},
"dc_fast_charge": {
"type": "boolean"
},
"charge_ports": {
"type": "array",
"items": {
"type": "string"
}
},
"statuses": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"suggested_relaxations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"action": {
"type": "string",
"enum": [
"expand_radius",
"remove_filter",
"search_nationwide"
]
},
"field": {
"type": "string"
},
"suggestion": {
"type": "string"
}
},
"required": [
"action",
"field",
"suggestion"
]
}
},
"coverage": {
"type": "object",
"additionalProperties": false,
"properties": {
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"mode": {
"type": "string",
"enum": [
"radius",
"region",
"viewport",
"nationwide"
]
},
"radius_miles": {
"type": [
"number",
"null"
]
},
"region_code": {
"type": [
"string",
"null"
]
}
},
"required": [
"country",
"mode",
"radius_miles",
"region_code"
]
},
"fallback": {
"type": "object",
"additionalProperties": false,
"properties": {
"applied": {
"type": "boolean"
},
"stage": {
"type": "string",
"enum": [
"requested",
"double_radius",
"statewide",
"drop_softest_filter",
"national",
"national_inventory"
]
},
"relaxed_filters": {
"type": "array",
"items": {
"type": "string"
}
},
"attempted_stages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"applied",
"stage",
"relaxed_filters",
"attempted_stages"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"properties": {
"catalog_snapshot_at": {
"type": "string",
"format": "date-time"
},
"newest_listing_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"catalog_snapshot_at",
"newest_listing_updated_at"
]
}
},
"required": [
"total",
"total_relation",
"matches",
"next_action",
"next_cursor",
"interpreted_request",
"applied_filters",
"suggested_relaxations",
"coverage",
"freshness",
"fallback"
],
"additionalProperties": false
}🟢get_vehicle(listing_id)
For full detail, pass exact shop_vehicles listing_id; returns dealer.dealer_id.
输入模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"listing_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"format": "uuid"
},
"vin": {
"type": "string"
},
"stock": {
"type": [
"string",
"null"
]
},
"year": {
"type": "integer"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"trim": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": "string",
"enum": [
"car",
"motorcycle",
"trailer",
"rv",
"other"
]
},
"displacement_cc": {
"type": [
"number",
"null"
]
},
"battery_kwh": {
"type": [
"number",
"null"
]
},
"motor_power_hp": {
"type": [
"number",
"null"
]
},
"dc_fast_charge": {
"type": [
"boolean",
"null"
]
},
"charge_port": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
],
"enum": [
"new",
"used",
"cpo",
null
]
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"driveline": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"exterior_color": {
"type": [
"string",
"null"
]
},
"interior_color": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"integer",
"null"
]
},
"currency": {
"type": "string",
"enum": [
"USD",
"CAD"
]
},
"msrp": {
"type": [
"integer",
"null"
]
},
"mileage": {
"type": [
"integer",
"null"
]
},
"electric_range_miles": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string",
"enum": [
"available",
"intransit"
]
},
"primary_photo_url": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"distance_miles": {
"type": [
"number",
"null"
]
},
"dealer": {
"type": "object",
"additionalProperties": false,
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"agent_card_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"dealer_id",
"name",
"domain",
"agent_card_url"
]
},
"location": {
"type": "object",
"additionalProperties": false,
"properties": {
"location_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"address_line_1": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"geocode_precision": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"location_id",
"name",
"country"
]
},
"listing_url": {
"type": [
"string",
"null"
]
},
"listing_url_source": {
"type": [
"string",
"null"
],
"enum": [
"car_handshake",
"dealer_vdp",
null
]
},
"description": {
"type": [
"string",
"null"
]
},
"engine": {
"type": [
"string",
"null"
]
},
"city_mpg": {
"type": [
"integer",
"null"
]
},
"highway_mpg": {
"type": [
"integer",
"null"
]
},
"photos": {
"type": "array",
"items": {
"type": "string"
}
},
"features": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"listing_id",
"year",
"make",
"model",
"vehicle_type",
"status",
"dealer",
"location"
],
"additionalProperties": false
}🟢search(query)
Citation only; never shopping/detail/compare. Search once, then fetch exact IDs.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 500,
"description": "Vehicle-shopping query, verbatim."
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url"
]
}
},
"next_action": {
"type": "string"
}
},
"required": [
"results",
"next_action"
],
"additionalProperties": false
}🟢fetch(id)
Citation only after search; never shopping/detail. Fetch one exact ID.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Exact listing ID returned by search."
}
},
"required": [
"id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"id",
"title",
"text",
"url"
],
"additionalProperties": false
}🟢compare_vehicles(listing_ids, priorities)
Only for explicit comparison: after exactly one shop_vehicles call, pass 2-4 distinct returned listing IDs. Never search or shop again.
输入模式
{
"type": "object",
"properties": {
"listing_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 2,
"maxItems": 4,
"description": "2-4 exact IDs returned by shop_vehicles."
},
"priorities": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"description": "Shopper priorities, up to eight."
}
},
"required": [
"listing_ids"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"vehicles": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"listing": {
"type": "object",
"additionalProperties": false,
"properties": {
"listing_id": {
"type": "string",
"format": "uuid"
},
"vin": {
"type": "string"
},
"stock": {
"type": [
"string",
"null"
]
},
"year": {
"type": "integer"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"trim": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": "string",
"enum": [
"car",
"motorcycle",
"trailer",
"rv",
"other"
]
},
"displacement_cc": {
"type": [
"number",
"null"
]
},
"battery_kwh": {
"type": [
"number",
"null"
]
},
"motor_power_hp": {
"type": [
"number",
"null"
]
},
"dc_fast_charge": {
"type": [
"boolean",
"null"
]
},
"charge_port": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
],
"enum": [
"new",
"used",
"cpo",
null
]
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"driveline": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"exterior_color": {
"type": [
"string",
"null"
]
},
"interior_color": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"integer",
"null"
]
},
"currency": {
"type": "string",
"enum": [
"USD",
"CAD"
]
},
"msrp": {
"type": [
"integer",
"null"
]
},
"mileage": {
"type": [
"integer",
"null"
]
},
"electric_range_miles": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string",
"enum": [
"available",
"intransit"
]
},
"primary_photo_url": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"distance_miles": {
"type": [
"number",
"null"
]
},
"dealer": {
"type": "object",
"additionalProperties": false,
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"agent_card_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"dealer_id",
"name",
"domain",
"agent_card_url"
]
},
"location": {
"type": "object",
"additionalProperties": false,
"properties": {
"location_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"address_line_1": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"geocode_precision": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"location_id",
"name",
"country"
]
},
"listing_url": {
"type": [
"string",
"null"
]
},
"listing_url_source": {
"type": [
"string",
"null"
],
"enum": [
"car_handshake",
"dealer_vdp",
null
]
},
"description": {
"type": [
"string",
"null"
]
},
"engine": {
"type": [
"string",
"null"
]
},
"city_mpg": {
"type": [
"integer",
"null"
]
},
"highway_mpg": {
"type": [
"integer",
"null"
]
},
"photos": {
"type": "array",
"items": {
"type": "string"
}
},
"features": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"listing_id",
"year",
"make",
"model",
"vehicle_type",
"status",
"dealer",
"location"
]
},
"advantages": {
"type": "array",
"items": {
"type": "string"
}
},
"tradeoffs": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"listing",
"advantages",
"tradeoffs"
]
}
},
"missing_listing_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"recommendation": {
"type": "object",
"additionalProperties": false,
"properties": {
"listing_id": {
"type": "string",
"format": "uuid"
},
"reason": {
"type": "string"
},
"next_action": {
"type": "string"
}
},
"required": [
"listing_id",
"reason",
"next_action"
]
},
"compared": {
"type": "integer",
"minimum": 2,
"maximum": 4
}
},
"required": [
"vehicles",
"missing_listing_ids",
"recommendation",
"compared"
],
"additionalProperties": false
}🟢find_dealerships(query, country, location, limit)
Use this once to find dealerships by name/place with IDs, addresses, and listing counts. Named stock: one shop_vehicles call with a returned dealer_id. For contacts or sales/service hours: get_dealership once.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
],
"description": "US default; CA for Canada. Quebec excluded."
},
"location": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Place or postal text exactly as supplied."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"dealerships": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"agent_card_url": {
"type": [
"string",
"null"
]
},
"locations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"location_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"address_line_1": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"geocode_precision": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"location_id",
"name",
"country"
]
}
},
"vehicle_count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"dealer_id",
"name",
"domain",
"agent_card_url",
"locations",
"vehicle_count"
]
}
},
"interpreted_location": {
"type": [
"object",
"null"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"postal",
"place",
"region"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"region_code": {
"type": "string"
},
"label": {
"type": "string"
},
"confidence": {
"type": "number"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"region_code": {
"type": "string"
},
"label": {
"type": "string"
},
"inventory_count": {
"type": "integer"
}
}
}
}
},
"required": [
"kind",
"country",
"region_code",
"label",
"confidence",
"latitude",
"longitude",
"candidates"
]
},
"next_action": {
"type": "string"
}
},
"required": [
"total",
"dealerships",
"interpreted_location",
"next_action"
],
"additionalProperties": false
}🟢get_dealership(dealer_id)
Use this with an exact dealer_id to return every public rooftop, contact, site, capability, and named sales/service schedule.
输入模式
{
"type": "object",
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"dealer_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"dealer_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"agent_card_url": {
"type": [
"string",
"null"
]
},
"locations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"location_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"address_line_1": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string",
"enum": [
"US",
"CA"
]
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"geocode_precision": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
},
"public_phone": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
]
},
"schedules": {
"type": "array",
"description": "Published rooftop schedules with named sales, service, or other department hours.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"monday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"tuesday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"wednesday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"thursday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"friday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"saturday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
},
"sunday": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
]
}
},
"required": [
"name"
]
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"location_id",
"name",
"country",
"public_phone",
"schedules",
"capabilities"
]
}
},
"vehicle_count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"dealer_id",
"name",
"domain",
"agent_card_url",
"locations",
"vehicle_count"
],
"additionalProperties": false
}🔴schedule_test_drive(listing_id, dry_run, first_name, last_name, email, ...)
After explicit consent and confirmation, request a test drive for this listing.
输入模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"format": "uuid",
"description": "Exact listing_id from prior results."
},
"dry_run": {
"type": "boolean",
"default": false,
"description": "Validate with no dealer contact."
},
"first_name": {
"type": "string",
"description": "First name."
},
"last_name": {
"type": "string",
"description": "Last name."
},
"email": {
"type": "string",
"description": "Email (or phone required)."
},
"phone": {
"type": "string",
"description": "E.164 phone (or email required)."
},
"preferred_contact": {
"type": "string",
"enum": [
"email",
"phone",
"sms",
"any"
]
},
"consent_text": {
"type": "string",
"description": "Accepted consent words; never fabricate consent."
},
"allowed_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"email",
"phone",
"sms"
]
},
"minItems": 1,
"maxItems": 3,
"description": "Consent channels."
},
"consent_granted_at": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:(?:[0-5]\\d|60)(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)(?![\\s\\S])",
"description": "Consent timestamp (RFC 3339)."
},
"message": {
"type": "string",
"maxLength": 4000,
"description": "Dealer note."
},
"idempotency_key": {
"type": "string",
"description": "Unique retry key."
},
"appointment_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"listing_id",
"first_name",
"last_name",
"consent_text",
"allowed_channels",
"consent_granted_at",
"idempotency_key"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"lead_id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"received",
"duplicate",
"validated"
]
}
},
"required": [
"lead_id",
"status"
],
"additionalProperties": false
}🔴request_trade_in_appraisal(listing_id, dry_run, first_name, last_name, email, ...)
After explicit consent and confirmation, request a trade-in appraisal for this listing.
输入模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"format": "uuid",
"description": "Exact listing_id from prior results."
},
"dry_run": {
"type": "boolean",
"default": false,
"description": "Validate with no dealer contact."
},
"first_name": {
"type": "string",
"description": "First name."
},
"last_name": {
"type": "string",
"description": "Last name."
},
"email": {
"type": "string",
"description": "Email (or phone required)."
},
"phone": {
"type": "string",
"description": "E.164 phone (or email required)."
},
"preferred_contact": {
"type": "string",
"enum": [
"email",
"phone",
"sms",
"any"
]
},
"consent_text": {
"type": "string",
"description": "Accepted consent words; never fabricate consent."
},
"allowed_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"email",
"phone",
"sms"
]
},
"minItems": 1,
"maxItems": 3,
"description": "Consent channels."
},
"consent_granted_at": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:(?:[0-5]\\d|60)(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)(?![\\s\\S])",
"description": "Consent timestamp (RFC 3339)."
},
"message": {
"type": "string",
"maxLength": 4000,
"description": "Dealer note."
},
"idempotency_key": {
"type": "string",
"description": "Unique retry key."
},
"trade_in_year": {
"type": "integer",
"minimum": 1886,
"maximum": 2200
},
"trade_in_make": {
"type": "string"
},
"trade_in_model": {
"type": "string"
},
"trade_in_trim": {
"type": "string"
},
"trade_in_mileage": {
"type": "integer",
"minimum": 0
},
"trade_in_condition": {
"type": "string"
}
},
"required": [
"listing_id",
"first_name",
"last_name",
"trade_in_year",
"trade_in_make",
"trade_in_model",
"consent_text",
"allowed_channels",
"consent_granted_at",
"idempotency_key"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"lead_id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"received",
"duplicate",
"validated"
]
}
},
"required": [
"lead_id",
"status"
],
"additionalProperties": false
}🔴submit_vehicle_inquiry(listing_id, dry_run, first_name, last_name, email, ...)
After explicit consent and confirmation, send this listing's dealer a question.
输入模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"format": "uuid",
"description": "Exact listing_id from prior results."
},
"dry_run": {
"type": "boolean",
"default": false,
"description": "Validate with no dealer contact."
},
"first_name": {
"type": "string",
"description": "First name."
},
"last_name": {
"type": "string",
"description": "Last name."
},
"email": {
"type": "string",
"description": "Email (or phone required)."
},
"phone": {
"type": "string",
"description": "E.164 phone (or email required)."
},
"preferred_contact": {
"type": "string",
"enum": [
"email",
"phone",
"sms",
"any"
]
},
"consent_text": {
"type": "string",
"description": "Accepted consent words; never fabricate consent."
},
"allowed_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"email",
"phone",
"sms"
]
},
"minItems": 1,
"maxItems": 3,
"description": "Consent channels."
},
"consent_granted_at": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:(?:[0-5]\\d|60)(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)(?![\\s\\S])",
"description": "Consent timestamp (RFC 3339)."
},
"message": {
"type": "string",
"maxLength": 4000,
"description": "Dealer note."
},
"idempotency_key": {
"type": "string",
"description": "Unique retry key."
}
},
"required": [
"listing_id",
"first_name",
"last_name",
"message",
"consent_text",
"allowed_channels",
"consent_granted_at",
"idempotency_key"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"lead_id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"received",
"duplicate",
"validated"
]
}
},
"required": [
"lead_id",
"status"
],
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本10 个工具
已验证未记录版本10 个工具
已验证未记录版本10 个工具