MCPサーバー

OpenDealer MCP Server

app.opendealer/mcp
コマース・小売 データ・分析 公開・接続可能 MCP 2026-07-28

このMCPでできること

Searches automotive inventory, dealers, vehicle specifications, pricing, market trends, financing rates, safety ratings, recalls, and listing histories.

check_recalls
Check NHTSA Recalls
Get NHTSA open safety recalls for a vehicle by VIN. Returns recall campaigns resolved at the year/make/model level (YMM-granular). A recall listed for the model year may not apply to every VIN — the response includes NHTSA's disclaimer and campaign details (component, summary, remedy status, Park It / Park Outside advisories). Use this when a shopper asks about recalls, safety campaigns, or whether a specific model has open NHTSA notices. Required step in vehicle_dossier and safety_first playbooks; always include the YMM-granularity disclaimer.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'vin': {'type': 'string'}, 'count': {'type': 'number'}, 'recalls': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
compare_market
Compare Market Segments
Compare pricing across market segments. Provide modelcodes[] or make (optionally with model).
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'make': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['New', 'Used'], 'type': 'string', 'description': 'Vehicle type (New or Used)'}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'model': {'type': 'string', 'minLength': 1}, 'modelcodes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 10, 'minItems': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
compare_models
Compare Vehicle Models
Compare 2-4 vehicle models side by side (model-level, not specific listings). Provide composite make-model slugs like "honda-civic" or "toyota-corolla". Returns: • Winner-by-dimension deltas: price, fuel economy, horsepower, seating, towing, NHTSA safety, live median listing price • Full research payload for each model (trims, MSRPs, specs) Use this for "Civic vs Corolla" style questions. To compare specific listed vehicles by VIN, use compare_vehicles instead. CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['models'], 'properties': {'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Model year (defaults to the latest year with reference data)'}, 'models': {'type': 'array', 'items': {'type': 'string', 'minLength': 3}, 'maxItems': 4, 'minItems': 2, 'description': 'Composite make-model slugs to compare (e.g., ["honda-civic", "toyota-corolla"])'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'models': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
compare_vehicles
Compare Vehicles
Compare 2-5 vehicles side by side. Returns a structured comparison including specs, price context, and per-vehicle cite fields (vin + shop url). CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vins'], 'properties': {'vins': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}, 'maxItems': 5, 'minItems': 2, 'description': 'List of VINs to compare (2-5 vehicles)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'vehicles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'comparison': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'additionalProperties': True}
dealer_inventory
Browse Dealer Inventory
Browse the complete inventory of a specific dealership. IMPORTANT: Use the exact dealer slug from a previous dealers_near or search_vehicles response. Do NOT guess dealer IDs. Useful when a user wants to see what a particular dealer has in stock. Supports all vehicle filters (make, model, price, etc.). CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['dealerId'], 'properties': {'make': {'type': 'string', 'minLength': 1, 'description': 'Vehicle make'}, 'sort': {'enum': ['relevance', 'price_asc', 'price_desc', 'year_desc', 'mileage_asc'], 'type': 'string', 'default': 'relevance', 'description': 'Sort order'}, 'trim': {'type': 'string', 'minLength': 1, 'description': 'Trim level'}, 'view': {'enum': ['llm', 'standard', 'minimal'], 'type': 'string', 'default': 'standard', 'description': 'Response detail: standard (features/gallery, default), llm (compact), minimal'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results to return (1-100, default: 25)'}, 'model': {'type': 'string', 'minLength': 1, 'description': 'Vehicle model'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination'}, 'dealerId': {'type': 'string', 'minLength': 3, 'description': 'Dealer identifier (UUID or slug like "rsm-honda")'}, 'year_max': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Maximum model year'}, 'year_min': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Minimum model year'}, 'body_type': {'enum': ['Sedan', 'SUV', 'Truck', 'Coupe', 'Van', 'Wagon', 'Convertible', 'Hatchback'], 'type': 'string', 'description': 'Vehicle body style'}, 'certified': {'type': 'boolean', 'description': 'Filter for CPO vehicles'}, 'condition': {'enum': ['New', 'Used', 'Certified'], 'type': 'string', 'description': 'Vehicle condition'}, 'fuel_type': {'enum': ['Gasoline', 'Diesel', 'Electric', 'Hybrid', 'Plug-in Hybrid'], 'type': 'string', 'description': 'Fuel type'}, 'price_max': {'type': 'integer', 'minimum': 0, 'description': 'Maximum price in USD'}, 'price_min': {'type': 'integer', 'minimum': 0, 'description': 'Minimum price in USD'}, 'drivetrain': {'enum': ['FWD', 'RWD', 'AWD', '4WD'], 'type': 'string', 'description': 'Drivetrain configuration'}, 'mileage_max': {'type': 'integer', 'minimum': 0, 'description': 'Maximum mileage'}, 'transmission': {'enum': ['Automatic', 'Manual', 'CVT'], 'type': 'string', 'description': 'Transmission type'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'total': {'type': 'number'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'vehicles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'totalResults': {'type': 'number'}}, 'additionalProperties': True}
dealers_near
Find Nearby Dealers
Find dealerships near a location. Location modes (choose ONE): • zip + radius (miles) • lat + lng + radius • city + state + radius • county + state + radius Returns dealer information including: • Name, address, phone, website • Distance from search location • Current inventory count • Business hours (when available)
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude coordinate'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude coordinate'}, 'zip': {'type': 'string', 'pattern': '^[0-9]{5}$', 'description': '5-digit US ZIP code (e.g., 92688)'}, 'city': {'type': 'string', 'minLength': 1, 'description': 'City name'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of dealers to return (1-200, default: 50)'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter US state code (e.g., CA, TX)'}, 'county': {'type': 'string', 'minLength': 1, 'description': 'County name'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination'}, 'radius': {'type': 'integer', 'default': 50, 'maximum': 250, 'minimum': 1, 'description': 'Search radius in miles (1-250, default: 50)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'total': {'type': 'number'}, 'dealers': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
filter_vehicles
Filter Vehicles (Structured)
Preferred structured inventory lookup when make/model/year/color/location are known. Uses exact hard filters (keyword mode, no embeddings) via the Runtime /v1/llm/filter path. Resolve exact make/model names with list_research_makes and list_research_models first. Map shopper prose onto labeled keys (make, model, body, price_max, location); do not dump the sentence into search_vehicles. Often the first step in shopping playbooks (budget_coach, safety_first, price_drop_sniper, dealer_crawl). After results, chain get_deal_score / get_vehicle_history / check_recalls / compare_vehicles when the user needs a recommendation, not just a list. See opendealer://assistant/shopping-playbooks. CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'zip': {'type': 'string', 'pattern': '^[0-9]{5}$', 'description': '5-digit US ZIP code (e.g., 92688)'}, 'city': {'type': 'string', 'minLength': 1}, 'make': {'type': 'string', 'minLength': 1, 'description': 'Vehicle make (resolve via list_research_makes if unsure)'}, 'sort': {'enum': ['relevance', 'price_asc', 'price_desc', 'year_desc', 'mileage_asc', 'distance_asc'], 'type': 'string', 'default': 'relevance', 'description': 'Sort order for results'}, 'trim': {'type': 'string', 'minLength': 1}, 'color': {'type': 'string', 'minLength': 1}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results to return (1-100, default: 25)'}, 'model': {'type': 'string', 'minLength': 1, 'description': 'Vehicle model (resolve via list_research_models if unsure)'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter US state code (e.g., CA, TX)'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination'}, 'radius': {'type': 'integer', 'default': 50, 'maximum': 250, 'minimum': 1, 'description': 'Search radius in miles (1-250, default: 50)'}, 'year_max': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'year_min': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'body_type': {'enum': ['Sedan', 'SUV', 'Truck', 'Coupe', 'Van', 'Wagon', 'Convertible', 'Hatchback'], 'type': 'string', 'description': 'Vehicle body style'}, 'certified': {'type': 'boolean'}, 'condition': {'enum': ['New', 'Used', 'Certified'], 'type': 'string', 'description': 'Vehicle condition'}, 'fuel_type': {'enum': ['Gasoline', 'Diesel', 'Electric', 'Hybrid', 'Plug-in Hybrid'], 'type': 'string', 'description': 'Fuel type'}, 'price_max': {'type': 'integer', 'minimum': 0}, 'price_min': {'type': 'integer', 'minimum': 0}, 'drivetrain': {'enum': ['FWD', 'RWD', 'AWD', '4WD'], 'type': 'string', 'description': 'Drivetrain configuration'}, 'mileage_max': {'type': 'integer', 'minimum': 0}, 'transmission': {'enum': ['Automatic', 'Manual', 'CVT'], 'type': 'string', 'description': 'Transmission type'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'total': {'type': 'number'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'vehicles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'totalResults': {'type': 'number'}}, 'additionalProperties': True}
get_dealer
Get Dealership Details
Get comprehensive information about a specific dealership. Returns Google-enriched dealer knowledge optimized for assistants: • Name, address, phone, website • Google rating, review count, hours, business status • Inventory count and OpenDealer profile links • Contact points for sales / customer service Use this when a shopper asks "tell me about X dealership" or needs hours/ratings for a known dealer. Prefer a slug from dealers_near or search results. CRITICAL: Only use URL fields from the response (website, urls.*). NEVER invent or construct URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['dealerId'], 'properties': {'dealerId': {'type': 'string', 'minLength': 3, 'description': 'Dealer identifier: UUID or slug (e.g., "rsm-honda"). Prefer the slug from dealers_near or search results.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'urls': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'inventory': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'telephone': {'type': 'string'}, 'openingHours': {}, 'aggregateRating': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'additionalProperties': True}
get_deal_score
Get Deal Score
Get AI-powered deal scoring and market insights for a vehicle. Returns comprehensive analysis including: • Deal score (1-100) with rating (Great, Good, Fair, Poor) • Price comparison vs market average • Days on lot analysis • Price history and trends • Similar vehicles in the market Core step in vehicle_dossier, budget_coach, price_drop_sniper, and dealer_crawl playbooks. Pair with get_vehicle_history and check_recalls for buy/no-buy answers.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'vin': {'type': 'string'}, 'dealScore': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'priceHistory': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
get_market_overview
Get Market Overview
Get high-level automotive market statistics. Returns aggregated market data including: • Total vehicles and dealers in inventory • Average pricing by segment • Top makes by volume • Market velocity indicators • New vs Used breakdown
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'make': {'type': 'string', 'minLength': 1, 'description': 'Filter by vehicle make'}, 'type': {'enum': ['New', 'Used'], 'type': 'string', 'description': 'Filter by vehicle type'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_market_segment
Get Market Segment Data
Get detailed pricing and market data for a specific vehicle segment. Useful for understanding fair market value for a make/model/year combination. Returns pricing statistics including: • Average, median, min, max prices • Price percentiles (10th, 25th, 75th, 90th) • Average mileage and days on lot • Certified vs non-certified pricing difference
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['modelcode'], 'properties': {'type': {'enum': ['New', 'Used'], 'type': 'string', 'description': 'Vehicle type'}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Model year'}, 'certified': {'type': 'boolean', 'description': 'Filter for certified vehicles'}, 'modelcode': {'type': 'string', 'minLength': 1, 'description': 'Model code identifier (unique per make/model/year combination)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_market_trends
Get Market Price Trends
Price trends over time for a market segment (modelcode). Returns timeline of median/avg prices and days-on-lot.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['modelcode'], 'properties': {'days': {'type': 'integer', 'default': 30, 'maximum': 90, 'minimum': 7}, 'type': {'enum': ['New', 'Used'], 'type': 'string', 'description': 'Vehicle type (New or Used)'}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'certified': {'type': 'boolean'}, 'modelcode': {'type': 'string', 'minLength': 1, 'description': 'Market segment modelcode'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_market_velocity
Get Market Velocity
How quickly vehicles sell by segment (fastest/slowest days on lot). Optional make/type filters.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'make': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['New', 'Used'], 'type': 'string', 'description': 'Vehicle type (New or Used)'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_safety_rating
Get NHTSA Safety Rating
Get NHTSA 5-Star Safety Ratings for a year/make/model (no VIN required). Answers questions like "is a 2023 RAV4 safe for my family" with: • Overall and crash-test star ratings (when published) • Rollover rating / possibility • NHTSA-evaluated ADAS availability (ESC, FCW, LDW) Ratings are model-year granular from the NHTSA NCAP cache. If no confident rating exists, the tool reports that honestly rather than guessing. For VIN-specific listing details use get_vehicle; for open recalls use check_recalls. CRITICAL: Only use the 'sourceUrl' field from the response for NHTSA links. NEVER invent URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['year', 'make', 'model'], 'properties': {'make': {'type': 'string', 'minLength': 1, 'description': 'Vehicle make (e.g., "Toyota", "Honda")'}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Model year (e.g., 2023)'}, 'model': {'type': 'string', 'minLength': 1, 'description': 'Vehicle model (e.g., "RAV4", "Civic")'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['available', 'safety'], 'properties': {'make': {'type': 'string'}, 'year': {'type': 'number'}, 'model': {'type': 'string'}, 'safety': {'anyOf': [{'type': 'object', 'properties': {}, 'additionalProperties': True}, {'type': 'null'}]}, 'message': {'type': 'string'}, 'available': {'type': 'boolean'}, 'sourceUrl': {'type': 'string'}}, 'additionalProperties': True}
get_similar_vehicles
Get Similar Vehicles
Find similar on-lot vehicles for a VIN ("you may also like"). Same make/model keyword comps as the shop VDP rail (not semantic embeddings). CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}, 'limit': {'type': 'integer', 'default': 6, 'maximum': 24, 'minimum': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_suggested_rates
Get Suggested Finance Rates
National average suggested auto loan APRs (not a credit offer). Optional filters: condition (new/used), term_months (36–84), credit_tier.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'condition': {'enum': ['new', 'used'], 'type': 'string'}, 'credit_tier': {'enum': ['excellent', 'good', 'average', 'fair'], 'type': 'string'}, 'term_months': {'enum': [36, 48, 60, 72, 84], 'type': 'number'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
get_vehicle
Get Vehicle Details
Get complete details for a specific vehicle by VIN. Returns comprehensive Schema.org Vehicle data including: • Full specifications (engine, transmission, drivetrain) • High-resolution images • Current pricing and availability • NHTSA NCAP safety rating summary (when available) • NHTSA open recall summary (YMM-granular, when available) • Dealer contact information Starting point for the vehicle_dossier playbook. For buy/no-buy questions, continue with get_deal_score → get_vehicle_history → check_recalls → get_similar_vehicles. CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}, 'view': {'enum': ['llm', 'standard', 'minimal'], 'type': 'string', 'default': 'llm', 'description': 'Response format: llm (optimized for AI), standard (full details), minimal (compact)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}, 'vehicleIdentificationNumber': {'type': 'string'}}, 'additionalProperties': True}
get_vehicle_history
Get Vehicle Price History
Get OpenDealer listing history for a VIN: price changes, days on lot, and status. Answers "has this VIN dropped in price" and days-on-lot narratives from retained snapshots (including vehicles that left a dealer feed). Returns: • Chronological price history with per-snapshot changes • Days on market / lot signals and badges (price_drop, long_on_lot) • Active vs no-longer-listed status when known Does not invent a deal score for sold vehicles — use get_deal_score for live market scoring. Essential for price_drop_sniper and vehicle_dossier playbooks when shoppers ask about reductions or negotiation leverage. CRITICAL: Only use URL fields from the response when present. NEVER invent URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'vin': {'type': 'string'}, 'badges': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['active', 'sold'], 'type': 'string'}, 'summary': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'priceHistory': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
get_vehicle_rankings
Get Vehicle Rankings
Get data-driven vehicle rankings (e.g., best SUVs, most fuel-efficient cars). Call without arguments to list all ranking categories. Pass a category slug (e.g., "best-suvs") for the full scored ranking. Rankings are computed from public data with a published methodology: NHTSA safety ratings, EPA fuel economy, manufacturer pricing, and live market availability. There is no paid placement; each entry includes its transparent score breakdown. CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'category': {'type': 'string', 'minLength': 1, 'description': 'Ranking category slug (e.g., "best-suvs"). Omit to list all available categories.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'category': {'type': 'string'}, 'rankings': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'categories': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
list_facets
List Inventory Facets
Discover available filter values and counts (makes, body types, fuel types, price/year ranges) for the live inventory. Call this before filter_vehicles when you need valid dimension values. Optional make/near/radius scopes the facet counts.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'make': {'type': 'string', 'minLength': 1}, 'near': {'type': 'string', 'minLength': 1, 'description': 'Location string (ZIP or city, state) for geo-scoped facets'}, 'radius': {'type': 'integer', 'default': 50, 'maximum': 250, 'minimum': 1, 'description': 'Search radius in miles (1-250, default: 50)'}, 'certified': {'type': 'boolean'}, 'condition': {'enum': ['New', 'Used', 'Certified'], 'type': 'string', 'description': 'Vehicle condition'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
list_market_segments
List Market Segments
Browse market segments with pricing statistics (modelcode, median price, sample size). Use to discover modelcodes for get_market_segment / get_market_trends.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'make': {'type': 'string', 'minLength': 1}, 'page': {'type': 'integer', 'minimum': 1}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'modelcode': {'type': 'string', 'minLength': 1}, 'minSampleSize': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
list_research_makes
List Research Makes
Browse the research catalog of vehicle makes (with model and inventory counts). Use to resolve exact make names/slugs before filter_vehicles or research_model.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': 'Optional substring filter on make name/slug'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
list_research_models
List Research Models
List models for a make from the research catalog (MSRP/body summaries). Use before filter_vehicles or research_model when the model name is uncertain.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['make'], 'properties': {'make': {'type': 'string', 'minLength': 1, 'description': 'Make name or slug (e.g. honda)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': True}
research_model
Research a Vehicle Model
Get the full research payload for a vehicle model (not a specific listing). Returns manufacturer reference data joined with live market data: • All trims with MSRPs, engine/body specs, and EPA fuel economy • NHTSA 5-Star safety ratings and open recall count • Live inventory count and price range on OpenDealer Use this when a shopper asks "tell me about the Honda Civic", "what trims does the RAV4 come in", or "how much is a 2025 F-150". For a specific listed vehicle, use get_vehicle with a VIN instead. CRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'required': ['make', 'model'], 'properties': {'make': {'type': 'string', 'minLength': 1, 'description': 'Vehicle make slug or name (e.g., "honda", "mercedes-benz")'}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Model year (defaults to the latest year with reference data)'}, 'model': {'type': 'string', 'minLength': 1, 'description': 'Vehicle model slug or name (e.g., "civic", "e-class")'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'make': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'year': {'type': 'number'}, 'model': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'safety': {'anyOf': [{'type': 'object', 'properties': {}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}
search_vehicles
Search Vehicles
Search for vehicles across dealerships (Meilisearch-backed NL + structured filters). Preferred tool order for assistants: 1. list_facets or list_research_makes/list_research_models to discover valid values 2. filter_vehicles (map shopper intent onto labeled hard filters) 3. get_vehicle / get_deal_score / research_model for depth When the ask implies analysis (good deal?, safety, budget, timing, dealer plan), continue with a shopping playbook from initialize instructions or resource opendealer://assistant/shopping-playbooks — do not stop at raw search results. Location modes (choose ONE): zip+radius, lat+lng+radius, city+state+radius, county+state+radius — or embed location in q. Forgiving matching: model variants, color families, typo tolerance. Hard caps (price_max, year, radius) are never relaxed. Prefer filter_vehicles; do not dump shopper prose into q. CRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (canonical opendealer.shop VDP). Cite only `url` to shoppers. Never invent VDP URLs. Never cite `detailsUrl` (dealer/LotLinx). Never send shoppers to `/llm/*` HTML or `/v1/llm/*` as the human listing URL.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': 'Free-text natural-language query. You can pass a whole sentence (e.g. "new black Honda Civic sedan under $45k within 150 miles of 92672"): price/mileage/year/condition and zip+radius are parsed out as hard constraints, while make/model/color/body words are matched forgivingly. Explicit structured params override anything parsed from the sentence.'}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude coordinate'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude coordinate'}, 'zip': {'type': 'string', 'pattern': '^[0-9]{5}$', 'description': '5-digit US ZIP code (e.g., 92688)'}, 'city': {'type': 'string', 'minLength': 1, 'description': 'City name'}, 'make': {'type': 'string', 'minLength': 1, 'description': 'Vehicle make (e.g., Honda, Toyota, Tesla)'}, 'mode': {'enum': ['keyword', 'hybrid'], 'type': 'string', 'description': 'Search mode. Use hybrid for conceptual queries with little keyword overlap (e.g. "family hauler good in snow"). Hard caps still apply as filters. Falls back to keyword if semantic is unavailable.'}, 'sort': {'enum': ['relevance', 'price_asc', 'price_desc', 'year_desc', 'mileage_asc', 'distance_asc'], 'type': 'string', 'default': 'relevance', 'description': 'Sort order for results'}, 'trim': {'type': 'string', 'minLength': 1, 'description': 'Trim level (e.g., EX, Limited, Performance)'}, 'view': {'enum': ['llm', 'standard', 'minimal'], 'type': 'string', 'default': 'llm', 'description': 'Response format: llm (optimized for AI), standard (full details), minimal (compact)'}, 'color': {'type': 'string', 'minLength': 1, 'description': 'Exterior color (e.g., black, white). Resolved to color families, so "black" matches "Crystal Black Pearl".'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results to return (1-100, default: 25)'}, 'model': {'type': 'string', 'minLength': 1, 'description': 'Vehicle model (e.g., Civic, Camry, Model 3). Broad terms match all variants (Civic -> Civic Sedan/Si/Hatchback) unless narrowed by trim.'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter US state code (e.g., CA, TX)'}, 'county': {'type': 'string', 'minLength': 1, 'description': 'County name'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination'}, 'radius': {'type': 'integer', 'default': 50, 'maximum': 250, 'minimum': 1, 'description': 'Search radius in miles (1-250, default: 50)'}, 'year_max': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Maximum model year'}, 'year_min': {'type': 'integer', 'maximum': 2030, 'minimum': 1990, 'description': 'Minimum model year'}, 'body_type': {'enum': ['Sedan', 'SUV', 'Truck', 'Coupe', 'Van', 'Wagon', 'Convertible', 'Hatchback'], 'type': 'string', 'description': 'Vehicle body style'}, 'certified': {'type': 'boolean', 'description': 'Filter for Certified Pre-Owned vehicles only'}, 'condition': {'enum': ['New', 'Used', 'Certified'], 'type': 'string', 'description': 'Vehicle condition'}, 'fuel_type': {'enum': ['Gasoline', 'Diesel', 'Electric', 'Hybrid', 'Plug-in Hybrid'], 'type': 'string', 'description': 'Fuel type'}, 'price_max': {'type': 'integer', 'minimum': 0, 'description': 'Maximum price in USD'}, 'price_min': {'type': 'integer', 'minimum': 0, 'description': 'Minimum price in USD'}, 'drivetrain': {'enum': ['FWD', 'RWD', 'AWD', '4WD'], 'type': 'string', 'description': 'Drivetrain configuration'}, 'mileage_max': {'type': 'integer', 'minimum': 0, 'description': 'Maximum mileage'}, 'transmission': {'enum': ['Automatic', 'Manual', 'CVT'], 'type': 'string', 'description': 'Transmission type'}, 'semanticRatio': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Semantic blend weight 0..1 when mode=hybrid (default 0.5). Higher = more conceptual matching.'}, 'useLlmSearchPath': {'type': 'boolean', 'description': 'Legacy. Do not set. Prefer filter_vehicles with labeled hard filters.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'total': {'type': 'number'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'vehicles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'totalResults': {'type': 'number'}}, 'additionalProperties': True}
ui_page_vehicle_results
Page Vehicle Results (App)
App-only: paginate or refresh vehicle results using the same Runtime paths as filter_vehicles / search_vehicles (geo-correct). No widget remount — omit resourceUri. Not for model use.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'properties': {'q': {'type': 'string', 'minLength': 1}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude coordinate'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude coordinate'}, 'zip': {'type': 'string', 'pattern': '^[0-9]{5}$', 'description': '5-digit US ZIP code (e.g., 92688)'}, 'city': {'type': 'string', 'minLength': 1}, 'make': {'type': 'string', 'minLength': 1}, 'mode': {'enum': ['keyword', 'hybrid'], 'type': 'string'}, 'sort': {'enum': ['relevance', 'price_asc', 'price_desc', 'year_desc', 'mileage_asc', 'distance_asc'], 'type': 'string', 'default': 'relevance', 'description': 'Sort order for results'}, 'trim': {'type': 'string', 'minLength': 1}, 'view': {'enum': ['llm', 'standard', 'minimal'], 'type': 'string', 'default': 'llm', 'description': 'Response format: llm (optimized for AI), standard (full details), minimal (compact)'}, 'color': {'type': 'string', 'minLength': 1}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results to return (1-100, default: 25)'}, 'model': {'type': 'string', 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter US state code (e.g., CA, TX)'}, 'county': {'type': 'string', 'minLength': 1}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination'}, 'radius': {'type': 'integer', 'default': 50, 'maximum': 250, 'minimum': 1, 'description': 'Search radius in miles (1-250, default: 50)'}, 'source': {'enum': ['filter_vehicles', 'search_vehicles'], 'type': 'string', 'default': 'filter_vehicles', 'description': 'Which model-facing tool path to reuse for this page request'}, 'year_max': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'year_min': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'body_type': {'enum': ['Sedan', 'SUV', 'Truck', 'Coupe', 'Van', 'Wagon', 'Convertible', 'Hatchback'], 'type': 'string', 'description': 'Vehicle body style'}, 'certified': {'type': 'boolean'}, 'condition': {'enum': ['New', 'Used', 'Certified'], 'type': 'string', 'description': 'Vehicle condition'}, 'fuel_type': {'enum': ['Gasoline', 'Diesel', 'Electric', 'Hybrid', 'Plug-in Hybrid'], 'type': 'string', 'description': 'Fuel type'}, 'price_max': {'type': 'integer', 'minimum': 0}, 'price_min': {'type': 'integer', 'minimum': 0}, 'drivetrain': {'enum': ['FWD', 'RWD', 'AWD', '4WD'], 'type': 'string', 'description': 'Drivetrain configuration'}, 'mileage_max': {'type': 'integer', 'minimum': 0}, 'transmission': {'enum': ['Automatic', 'Manual', 'CVT'], 'type': 'string', 'description': 'Transmission type'}, 'semanticRatio': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'useLlmSearchPath': {'type': 'boolean'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'total': {'type': 'number'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'vehicles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Canonical opendealer.shop VDP URL. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* as the human listing URL.'}, 'vin': {'type': 'string', 'description': '17-character VIN. Part of the cite object with url.'}}, 'additionalProperties': True}}, 'totalResults': {'type': 'number'}}, 'additionalProperties': True}
ui_select_vehicle
Select Vehicle (App)
App-only: record a vehicle selection from the results widget. Not for model use — hosts filter via _meta.ui.visibility.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['vin'], 'properties': {'url': {'type': 'string', 'minLength': 1}, 'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'description': '17-character Vehicle Identification Number'}, 'make': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string', 'minLength': 1}, 'year': {'type': 'integer', 'maximum': 2030, 'minimum': 1990}, 'model': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['selected', 'action', 'message'], 'properties': {'action': {'type': 'string', 'const': 'ui_select_vehicle'}, 'message': {'type': 'string'}, 'selected': {'type': 'object', 'required': ['vin'], 'properties': {'url': {'type': 'string'}, 'vin': {'type': 'string'}, 'make': {'type': 'string'}, 'name': {'type': 'string'}, 'year': {'type': 'number'}, 'model': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
追加
ui_page_vehicle_results
2026年9月17日7:57
追加
ui_select_vehicle
2026年9月17日7:57
追加
get_similar_vehicles
2026年9月17日7:57
追加
get_vehicle_rankings
2026年9月17日7:57
追加
compare_models
2026年9月17日7:57
追加
research_model
2026年9月17日7:57
追加
get_suggested_rates
2026年9月17日7:57
追加
compare_market
2026年9月17日7:57
追加
get_market_velocity
2026年9月17日7:57
追加
get_market_trends
2026年9月17日7:57
追加
list_market_segments
2026年9月17日7:57
追加
get_market_segment
2026年9月17日7:57
追加
get_market_overview
2026年9月17日7:57
追加
get_deal_score
2026年9月17日7:57
追加
compare_vehicles
2026年9月17日7:57
追加
dealer_inventory
2026年9月17日7:57
追加
dealers_near
2026年9月17日7:57
追加
get_vehicle_history
2026年9月17日7:57
追加
get_safety_rating
2026年9月17日7:57
追加
get_dealer
2026年9月17日7:57
追加
check_recalls
2026年9月17日7:57
追加
get_vehicle
2026年9月17日7:57
追加
list_research_models
2026年9月17日7:57
追加
list_research_makes
2026年9月17日7:57
追加
list_facets
2026年9月17日7:57
追加
filter_vehicles
2026年9月17日7:57
追加
search_vehicles
2026年9月17日7:57