{"name":"app.opendealer/mcp","title":"OpenDealer MCP Server","url":"https://mcp.opendealer.app/rpc","host":"mcp.opendealer.app","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":2},"findings":[{"rule":"mcp-tools-changed","severity":"info","message":"Its tools changed since last week. Tools 21 described. Where: check_recalls, compare_market, compare_vehicles, dealer_inventory, dealers_near and 16 more.","fix":"","where":["check_recalls","compare_market","compare_vehicles","dealer_inventory","dealers_near","filter_vehicles","get_deal_score","get_dealer","get_market_overview","get_market_segment","get_market_trends","get_market_velocity","get_safety_rating","get_similar_vehicles","get_suggested_rates","get_vehicle","get_vehicle_history","list_facets","list_market_segments","list_verticals","search_vehicles"],"count":21},{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports 2.3.0; the registry lists 2.0.0.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"OpenDealer MCP Server","version":"2.3.0","title":null},"capabilities":["completions","prompts","resources","tools"]},"sign_in":null,"tools":[{"name":"search_vehicles","title":"Search Vehicles","description":"Forgiving vehicle search (Meilisearch): natural-language q, typo-tolerant make/model/color, optional structured filters. Use when the shopper query is fuzzy or exploratory.\n\nUse filter_vehicles instead when make/model/year/body/price/location are known — it applies exact hard filters via GET /v1/vehicles and returns trustworthy totals. Listings with zero photos are omitted.\n\nDiscovery order: list_facets / list_research_makes → filter_vehicles (structured) or search_vehicles (exploratory) → get_vehicle / get_deal_score for depth.\n\nLocation (choose ONE): zip+radius, lat+lng+radius, city+state+radius, county+state+radius — or embed location in q. q may also be a 17-character VIN for exact lookup.\n\nWhen the ask implies analysis (deal, safety, budget, timing, dealer plan), chain shopping playbooks from initialize instructions or opendealer://assistant/shopping-playbooks.\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["q","zip","lat","lng","city","state","county","near","radius","make","model","trim","color","class","subtype","displacementMin","displacementMax","seats","drive","yearMin","yearMax","priceMin","priceMax","mileageMax","bodyType","fuelType","transmission","drivetrain","condition","certified","priceChangeMin","priceChangeMax","dealerId","hasImages","inventoryStatus","vehicleModelDate","year","limit","page","sortBy","sortOrder","mode","semanticRatio","vertical"],"required":[],"price_stated_usd":null},{"name":"filter_vehicles","title":"Filter Vehicles (Structured)","description":"Preferred structured inventory lookup when make/model/year/color/location are known.\n\nExact hard filters only via GET /v1/vehicles (same Meilisearch collection as search_vehicles). Totals match the filters you pass. Listings with zero photos are omitted. fuelType is the canonical label. transmission and drivetrain match every indexed raw string in that bucket (automatic includes \"8-Speed Automatic\"). A 503 powertrain_filter_unavailable means that facet list could not be read, not that zero cars match. Resolve make/model with list_research_makes / list_research_models first. Map shopper prose onto labeled keys; use search_vehicles only for fuzzy NL or VIN-in-q lookup.\n\nOften 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.\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["make","model","color","class","subtype","displacementMin","displacementMax","seats","drive","yearMin","yearMax","priceMin","priceMax","mileageMax","bodyType","fuelType","transmission","drivetrain","condition","certified","priceChangeMin","priceChangeMax","near","zip","lat","lng","city","state","county","radius","dealerId","dealerSlug","hasImages","strictLocation","vehicleModelDate","year","limit","page","sortBy","sortOrder","fields","identifier","vertical"],"required":[],"price_stated_usd":null},{"name":"list_facets","title":"List Inventory Facets","description":"Discover canonical filter tokens and counts from the live search index (same values GET /v1/vehicles accepts: make, bodyType e.g. suv, fuelType e.g. gasoline, transmission e.g. automatic, drivetrain e.g. awd, plus price/year ranges). Counts match filter_vehicles totals for each token under the same make, condition, and location.\n\nCall this before filter_vehicles when you need valid dimension values. Optional make, condition, certified, near, and radius scope the facet counts.","read_only":true,"destructive":false,"inputs":["make","condition","certified","class","dealerSlug","near","radius","vertical"],"required":[],"price_stated_usd":null},{"name":"list_research_makes","title":"List Research Makes","description":"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.","read_only":true,"destructive":false,"inputs":["q","limit"],"required":[],"price_stated_usd":null},{"name":"list_research_models","title":"List Research Models","description":"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.","read_only":true,"destructive":false,"inputs":["make"],"required":["make"],"price_stated_usd":null},{"name":"get_vehicle","title":"Get Vehicle Details","description":"Get complete details for a specific vehicle by listingId or VIN.\n\nWhen a VIN is listed at multiple dealer rooftops, a VIN-only lookup returns an envelope of every listing (type vehicle_listings) with no single-store price, seller, or url. Pass listingId to fetch one store.\n\nReturns comprehensive Schema.org Vehicle data including:\n• Full specifications (engine, transmission, drivetrain)\n• High-resolution images\n• Current pricing and availability\n• NHTSA NCAP safety rating summary (when available)\n• NHTSA open recall summary (YMM-granular, when available)\n• Dealer contact information\n\nStarting point for the vehicle_dossier playbook. For buy/no-buy questions, continue with get_deal_score → get_vehicle_history → check_recalls → get_similar_vehicles.\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["vin","listingId","view","dealerId","dealerSlug","includeSold","vertical"],"required":[],"price_stated_usd":null},{"name":"check_recalls","title":"Check Recalls","description":"Open safety recalls for a listing.\n\nPass vertical when the request names one. Cars use NHTSA (year, make, and model; a campaign may not apply to every VIN). Off-road uses CPSC. Call this with the off-road listing id; the tool reads GET /v2/listings/{listingId}/recalls and does not use the cars-only /v1 path for that id.\n\nEvery response names the source and states one outcome in words: \"confirmed for this VIN\", \"possible for this year, make, and model\", \"no matching published recall\", or \"coverage unavailable\". An empty list is not \"no recalls.\" Say the outcome. Do not invent a recall or a VIN range.\n\nRequired step in vehicle_dossier and safety_first playbooks.","read_only":true,"destructive":false,"inputs":["vin","listingId","vertical"],"required":[],"price_stated_usd":null},{"name":"get_dealer","title":"Get Dealership Details","description":"Get comprehensive information about a specific dealership.\n\nReturns Google-enriched dealer knowledge optimized for assistants:\n• Name, address, phone, website\n• Google rating, review count, hours, business status\n• Inventory count and OpenDealer profile links\n• Contact points for sales / customer service\n\nUse 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. A display name binds only when it matches one rooftop. Shared names (two Jay Hatfield stores, or just \"Honda\") return candidate slugs instead of picking one.\n\nCRITICAL: Only use URL fields from the response (website, urls.*). NEVER invent or construct URLs.","read_only":true,"destructive":false,"inputs":["dealerId","vertical"],"required":["dealerId"],"price_stated_usd":null},{"name":"get_safety_rating","title":"Get NHTSA Safety Rating","description":"Get NHTSA 5-Star Safety Ratings for a year/make/model (no VIN required).\n\nAnswers questions like \"is a 2023 RAV4 safe for my family\" with:\n• Overall and crash-test star ratings (when published)\n• Rollover rating / possibility\n• NHTSA-evaluated ADAS availability (ESC, FCW, LDW)\n\nRatings 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.\n\nCRITICAL: Only use the 'sourceUrl' field from the response for NHTSA links. NEVER invent URLs.","read_only":true,"destructive":false,"inputs":["year","make","model","vertical"],"required":["year","make","model"],"price_stated_usd":null},{"name":"get_vehicle_history","title":"Get Vehicle Price History","description":"Pass vertical when the request names one. Use the vertical facet to narrow a blended result. Skip a tool that has no data for that vertical.\n\nGet OpenDealer listing history for a VIN or listing id: price changes, days on lot, and status.\n\nAnswers \"has this VIN dropped in price\" and days-on-lot narratives from retained snapshots (including vehicles that left a dealer feed). Returns:\n• Chronological price history with per-snapshot changes\n• Days on market / lot signals and badges (price_drop, long_on_lot)\n• Active vs no-longer-listed status when known\n\nDoes 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.","read_only":true,"destructive":false,"inputs":["vin","listingId","dealerId","dealerSlug","vertical"],"required":[],"price_stated_usd":null},{"name":"dealers_near","title":"Find Nearby Dealers","description":"Find dealerships near a location.\n\nLocation modes (choose ONE):\n• zip + radius (miles)\n• lat + lng + radius\n• city + state + radius\n• county + state + radius\n\nReturns dealer information including:\n• Name, address, phone, website\n• Slug (the public handle for get_dealer and dealer_inventory; the public list does not include internal dealer UUIDs)\n• Distance from search location\n• Current inventory count\n• Business hours (when available)\n\nResponse `total` is the full match count for the query (ignores `limit`/`offset`), same population as get_market_overview inventory.activeDealers when unfiltered.","read_only":true,"destructive":false,"inputs":["q","zip","lat","lng","city","state","county","radius","limit","offset","vertical"],"required":[],"price_stated_usd":null},{"name":"dealer_inventory","title":"Browse Dealer Inventory","description":"Browse the complete inventory of a specific dealership.\n\nIMPORTANT: Use the exact dealer slug from a previous dealers_near or search_vehicles response. Do NOT guess dealer IDs.\n\nUseful when a user wants to see what a particular dealer has in stock.\nSupports all vehicle filters (make, model, price, etc.). Listings with zero photos are omitted.\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["dealerId","make","model","subtype","displacementMin","displacementMax","seats","drive","yearMin","yearMax","priceMin","priceMax","mileageMax","bodyType","fuelType","transmission","drivetrain","condition","certified","vehicleModelDate","year","limit","page","sortBy","sortOrder","view","fields","vertical"],"required":["dealerId"],"price_stated_usd":null},{"name":"compare_vehicles","title":"Compare Vehicles","description":"Compare 2-5 vehicles side by side.\n\nReturns a structured comparison including specs, price context, and per-vehicle cite fields (vin + shop url).\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["vins","listingIds","vertical"],"required":[],"price_stated_usd":null},{"name":"get_deal_score","title":"Get Deal Score","description":"Pass vertical when the request names one. Use the vertical facet to narrow a blended result. Skip a tool that has no data for that vertical.\n\nGet AI-powered deal scoring and market insights for a vehicle.\n\nReturns comprehensive analysis including:\n• Deal score (1-100) with rating (Great, Good, Fair, Poor)\n• Price comparison vs market average\n• Days on lot analysis\n• Price history and trends\n• Similar vehicles in the market\n\nCore 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.","read_only":true,"destructive":false,"inputs":["vin","listingId","dealerId","dealerSlug","vertical"],"required":[],"price_stated_usd":null},{"name":"get_market_overview","title":"Get Market Overview","description":"Pass vertical when the request names one. Use the vertical facet to narrow a blended result. Skip a tool that has no data for that vertical.\n\nGet high-level market statistics for one vertical. Off-road segments are that vertical's classes.\n\nReturns aggregated market data including:\n• inventory.totalVehicles — searchable listings on the live index (priced, not sold)\n• inventory.activeDealers — active dealers with at least one priced vehicle (internet price or MSRP greater than 0). Same population as dealers_near and Shop, not every status=active account\n• marketData — YMM cohort snapshot medians and sample sizes\n• Top makes by segment volume (canonical make labels)\n• New vs Used vs CPO breakdown","read_only":true,"destructive":false,"inputs":["make","condition","vertical"],"required":[],"price_stated_usd":null},{"name":"get_market_segment","title":"Get Market Segment Data","description":"Get detailed pricing and market data for a specific vehicle segment.\n\nUseful for understanding fair market value for a make/model/year combination.\nReturns pricing statistics including:\n• Average, median, min, max prices\n• Price percentiles (10th, 25th, 75th, 90th)\n• Average mileage and days on lot\n• Certified vs non-certified pricing difference","read_only":true,"destructive":false,"inputs":["cohortKey","year","condition","certified","vertical"],"required":[],"price_stated_usd":null},{"name":"list_market_segments","title":"List Market Segments","description":"Browse market segments with pricing statistics (cohortKey, median price, sample size). Use cohortKey with get_market_segment / get_market_trends.","read_only":true,"destructive":false,"inputs":["make","model","cohortKey","year","yearMin","yearMax","condition","certified","page","limit","minSampleSize","vertical"],"required":[],"price_stated_usd":null},{"name":"get_market_trends","title":"Get Market Price Trends","description":"Price trends over time for a market segment (cohortKey). Returns timeline of median/avg prices and days-on-lot.","read_only":true,"destructive":false,"inputs":["cohortKey","cohortGrain","year","condition","certified","days","vertical"],"required":[],"price_stated_usd":null},{"name":"get_market_velocity","title":"Get Market Velocity","description":"How quickly vehicles sell by segment (fastest/slowest days on lot). Optional make/type filters.","read_only":true,"destructive":false,"inputs":["make","condition","limit","vertical"],"required":[],"price_stated_usd":null},{"name":"compare_market","title":"Compare Market Segments","description":"Compare pricing across market segments. Provide cohortKeys or make (optionally with model).","read_only":true,"destructive":false,"inputs":["cohortKeys","make","model","year","condition","vertical"],"required":[],"price_stated_usd":null},{"name":"get_suggested_rates","title":"Get Suggested Finance Rates","description":"National average suggested auto loan APRs for cars (not a credit offer). Other verticals return \"Not available for this vertical\" until that vertical has a rate source. Optional filters: condition (new/used), termMonths (36–84), creditTier.","read_only":true,"destructive":false,"inputs":["condition","termMonths","creditTier","vertical"],"required":[],"price_stated_usd":null},{"name":"research_model","title":"Research a Vehicle Model","description":"Get the full research payload for a vehicle model (not a specific listing).\n\nReturns manufacturer reference data joined with live market data:\n• All trims with MSRPs, engine/body specs, and EPA fuel economy\n• NHTSA 5-Star safety ratings and open recall count\n• Live inventory count and price range on OpenDealer\n\nUse 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.\n\nCRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.","read_only":true,"destructive":false,"inputs":["make","model","year"],"required":["make","model"],"price_stated_usd":null},{"name":"compare_models","title":"Compare Vehicle Models","description":"Compare 2-4 vehicle models side by side (model-level, not specific listings).\n\nProvide composite make-model slugs like \"honda-civic\" or \"toyota-corolla\". Returns:\n• Winner-by-dimension deltas: price, fuel economy, horsepower, seating, towing, NHTSA safety, live median listing price\n• Full research payload for each model (trims, MSRPs, specs)\n\nUse this for \"Civic vs Corolla\" style questions. To compare specific listed vehicles by VIN, use compare_vehicles instead.\n\nCRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.","read_only":true,"destructive":false,"inputs":["models","year"],"required":["models"],"price_stated_usd":null},{"name":"get_vehicle_rankings","title":"Get Vehicle Rankings","description":"Get data-driven vehicle rankings (e.g., best SUVs, most fuel-efficient cars).\n\nCall without arguments to list all ranking categories. Pass a category slug (e.g., \"suvs\") for the full scored ranking.\n\nRankings 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.\n\nCRITICAL: Only use the 'url' field from the response for links. NEVER invent or construct URLs.","read_only":true,"destructive":false,"inputs":["category"],"required":[],"price_stated_usd":null},{"name":"get_similar_vehicles","title":"Get Similar Vehicles","description":"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).\n\nCRITICAL: CITE: Each vehicle's cite object is `vin` + `url` (that listing's own host). 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.","read_only":true,"destructive":false,"inputs":["vin","limit","vertical"],"required":["vin"],"price_stated_usd":null},{"name":"list_verticals","title":"List Verticals","description":"Live shopper verticals: key, label, host, identifier kind, example classes, which tool families work, and whether the vertical is public. Reserved hosts are omitted. Omit vertical on other tools for every public vertical (cars and off-road).","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null}],"tools_listed":26,"samples":[{"kind":"tool","name":"search_vehicles","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"filter_vehicles","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"resource","name":"opendealer://assistant/shopping-playbooks","is_error":false,"price_asked_usd":null,"networks":null},{"kind":"resource","name":"opendealer://inventory/overview","is_error":false,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2026-12-27","days_after_check":47,"issuer":"Google Trust Services"},"registry":{"version":"2.0.0","status":200,"published_at":"2026-07-02T21:45:53.023827Z","website_url":"https://opendealer.pro","repository":null},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/app.opendealer/mcp","badge":{"url":"https://agoranome.com/mcp-servers/app.opendealer/mcp/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/app.opendealer/mcp/badge.svg)](https://agoranome.com/mcp-servers/app.opendealer/mcp)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}