Skip to main content
Glama
Sign In

dealer-direct-inventory

by app.web.dealer-direct-mcp
OverviewDiscussionsAdmin

Start Shielded Proxy AI Relay & Agent Negotiation (Verify Lot Status & OTD)

start_shielded_inquiry

Open a privacy-shielded, buyer-directed AI relay thread ('Verified Buyer #XXXX via DealerDirect AI Relay') with a dealership WITHOUT exposing the buyer's personal email or phone number. Operates as 50-state self-serve software where the buyer is sole principal ($0.00 deal/reveal/broker fee, $0.00 dealer fee forever). Sends an ADF/XML + plain-text checklist, a 15-second human Deal-Desk link, and a machine-to-machine JSON endpoint for Dealership AI Agents, and optionally runs a bounded multi-round Agent Auto-Negotiation Playbook.

Input Schema

NameRequiredDescriptionDefault
buyer_zipYesBuyer's 5-digit US registration ZIP code (e.g., '33131') for accurate tax, title, tag, and OTD calculation.
questionsNoOptional custom verification questions for the sales manager (for classics, defaults automatically include cold-start video, undercarriage rust check, numbers-matching stampings, and enclosed shipping quote).
promo_codeNoOptional VIP / friend promo code to activate a complimentary Buyer Shield Pass.
vehicle_idYesCanonical vehicle ID or 17-character VIN to verify and quote.
buyer_pass_idNoOptional active DealerDirect Buyer Shield Pass ID (e.g., 'bp_...') to open a 2nd or 3rd concurrent shielded negotiation thread under the same flat pass.
auto_negotiateNoIf true (or when walk_away_otd_usd is set), activates the buyer's deterministic bounded Agent Auto-Negotiation Playbook to automatically strip hidden add-ons, cite lower competing quotes on the same pass, and counter across up to max_auto_rounds before pausing for buyer approval.
financing_typeNoBuyer's planned payment or financing method (default: 'undecided').
target_otd_usdNoOptional opening firm Out-The-Door goal offer in whole USD.
max_auto_roundsNoMaximum autonomous counter-offer rounds (1-5, default 3) when auto_negotiate is enabled.
ready_to_sign_byNoOptional buyer timeline commitment (e.g., 'Saturday 5:00 PM').
trade_in_summaryNoOptional trade-in summary if applicable (e.g., '2019 Honda Accord EX-L, 54k miles, clean title').
auto_strip_addonsNoClean-OTD audit rule (default true): automatically reply requesting removal of any hidden dealer add-ons/markups.
walk_away_otd_usdNoOptional buyer-authorized maximum walk-away Out-The-Door ceiling in whole USD for bounded multi-round AI auto-negotiation.
cross_shop_leverageNoIf true (default), automatically cites any lower verified OTD quote from sibling threads on the same Buyer Shield Pass during auto-negotiation.
request_cold_start_videoNoClassic/collector option: explicitly request a cold-start & idle walkaround video.
request_undercarriage_photosNoClassic/collector option: request lift/undercarriage frame & floorpan rust verification.
request_numbers_matching_checkNoClassic/collector option: request engine block/VIN stamping numbers-matching verification.
request_enclosed_shipping_quoteNoClassic/collector option: request an insured enclosed-carrier shipping quote to buyer_zip.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • addedInput schema / properties / auto_negotiate
      Added value: +{
+  "description": "If true (or when walk_away_otd_usd is set), activates the buyer's deterministic bounded Agent Auto-Negotiation Playbook to automatically strip hidden add-ons, cite lower competing quotes on the same pass, and counter across up to max_auto_rounds before pausing for buyer approval.",
+  "type": "boolean"
+}
    • changedInput schema / properties / auto_strip_addons / description
      Previous value: -"Guided Semi-Autopilot option (default true): automatically reply once requesting removal of any hidden dealer add-ons/markups on Round 1 while keeping price counter-offers buyer-approved."New value: +"Clean-OTD audit rule (default true): automatically reply requesting removal of any hidden dealer add-ons/markups."
    • changedInput schema / properties / buyer_pass_id / description
      Previous value: -"Optional active DealerDirect Buyer Shield Pass ID (e.g., 'bp_...') to open a 2nd or 3rd concurrent shielded negotiation thread under the same pass."New value: +"Optional active DealerDirect Buyer Shield Pass ID (e.g., 'bp_...') to open a 2nd or 3rd concurrent shielded negotiation thread under the same flat pass."
    • addedInput schema / properties / cross_shop_leverage
      Added value: +{
+  "description": "If true (default), automatically cites any lower verified OTD quote from sibling threads on the same Buyer Shield Pass during auto-negotiation.",
+  "type": "boolean"
+}
    • addedInput schema / properties / max_auto_rounds
      Added value: +{
+  "description": "Maximum autonomous counter-offer rounds (1-5, default 3) when auto_negotiate is enabled.",
+  "type": "integer"
+}
    • changedInput schema / properties / promo_code / description
      Previous value: -"Optional VIP / friend concierge promo code to activate a complimentary Buyer Shield Pass."New value: +"Optional VIP / friend promo code to activate a complimentary Buyer Shield Pass."
    • changedInput schema / properties / target_otd_usd / description
      Previous value: -"Optional opening firm Out-The-Door target offer in whole USD."New value: +"Optional opening firm Out-The-Door goal offer in whole USD."
    • addedInput schema / properties / walk_away_otd_usd
      Added value: +{
+  "description": "Optional buyer-authorized maximum walk-away Out-The-Door ceiling in whole USD for bounded multi-round AI auto-negotiation.",
+  "type": "integer"
+}
  2. Changed3 schema fields changed
    • addedInput schema / properties / auto_strip_addons
      Added value: +{
+  "description": "Guided Semi-Autopilot option (default true): automatically reply once requesting removal of any hidden dealer add-ons/markups on Round 1 while keeping price counter-offers buyer-approved.",
+  "type": "boolean"
+}
    • addedInput schema / properties / buyer_pass_id
      Added value: +{
+  "description": "Optional active DealerDirect Buyer Shield Pass ID (e.g., 'bp_...') to open a 2nd or 3rd concurrent shielded negotiation thread under the same pass.",
+  "type": "string"
+}
    • addedInput schema / properties / promo_code
      Added value: +{
+  "description": "Optional VIP / friend concierge promo code to activate a complimentary Buyer Shield Pass.",
+  "type": "string"
+}
  3. Changed5 schema fields changed
    • changedInput schema / properties / questions / description
      Previous value: -"Optional custom verification questions for the sales manager (defaults to physical lot check, 2 keys, smoke-free, and mandatory add-ons disclosure)."New value: +"Optional custom verification questions for the sales manager (for classics, defaults automatically include cold-start video, undercarriage rust check, numbers-matching stampings, and enclosed shipping quote)."
    • addedInput schema / properties / request_cold_start_video
      Added value: +{
+  "description": "Classic/collector option: explicitly request a cold-start & idle walkaround video.",
+  "type": "boolean"
+}
    • addedInput schema / properties / request_enclosed_shipping_quote
      Added value: +{
+  "description": "Classic/collector option: request an insured enclosed-carrier shipping quote to buyer_zip.",
+  "type": "boolean"
+}
    • addedInput schema / properties / request_numbers_matching_check
      Added value: +{
+  "description": "Classic/collector option: request engine block/VIN stamping numbers-matching verification.",
+  "type": "boolean"
+}
    • addedInput schema / properties / request_undercarriage_photos
      Added value: +{
+  "description": "Classic/collector option: request lift/undercarriage frame & floorpan rust verification.",
+  "type": "boolean"
+}
  4. Added

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations supplied, the description carries the full burden and does substantial work: it discloses that a named proxy thread is created, that three outbound artifacts are sent to the dealer, that auto-negotiation is bounded (max_auto_rounds) and pauses for buyer approval, and that add-on stripping and cross-quote citation happen automatically. Gaps remain on permission/auth requirements, idempotency, and whether a thread is created or reused when buyer_pass_id is present.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core capability is front-loaded in the first sentence, which is good. However, the middle sentence carries marketing padding that does not help an agent act ('50-state self-serve software', '$0.00 deal/reveal/broker fee, $0.00 dealer fee forever'), and the final sentence packs four distinct delivery mechanisms plus optional negotiation into one unwieldy clause.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-parameter mutating tool with no annotations and no output schema, the description explains the outbound side well but leaves the return contract entirely unstated, including whether a thread ID is produced for use with get_deal_thread and burn_proxy_thread. Failure modes, timing expectations, and what the buyer/agent must do next are also unaddressed, so an agent cannot plan the follow-up call from this description alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every one of the 18 parameters is already documented in the schema, setting the baseline at 3. The description restates the auto-negotiation behavior (strip hidden add-ons, cite lower competing quotes, bounded rounds) but mirrors the schema wording rather than adding new semantics such as units, precedence between auto_negotiate and walk_away_otd_usd, or what happens if target_otd_usd exceeds walk_away_otd_usd.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource: open a privacy-shielded, buyer-directed AI relay thread with a dealership, and describes the artifacts it emits (ADF/XML + plain-text checklist, deal-desk link, JSON endpoint for dealer agents). It is clear what the tool does, but it never differentiates itself from siblings such as submit_lead or accept_deal_and_reveal, so an agent must infer the boundary between starting a shielded thread and submitting a plain lead.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: the tool is what you call to verify lot status and OTD under a shield, and optional auto-negotiation is gated on auto_negotiate/walk_away_otd_usd. There is no explicit when-not guidance (e.g., when to prefer submit_lead, or what to do if a thread already exists beyond the buyer_pass_id note in the schema) and no prerequisites or sequencing against get_deal_thread or burn_proxy_thread.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All dealer-direct-inventory toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources