Agentic Dealer Network

Get vehicle details

inventory_get

Read-onlyIdempotent

Fetch one available unit by identity (VIN) from a named rooftop (rooftop_slug from network_search results). Returns the full detail shape — ordered photo gallery, options, plain-text description; embed the first few photo_urls as markdown images when presenting the vehicle. Unknown or ineligible identity/rooftop returns unit_not_found. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Input Schema

Name	Required	Description
`country`	No	Optional consistency assertion: must equal the rooftop's country; omit it unless you are checking.
`identity`	Yes
`rooftop_slug`	Yes

Output Schema

Name	Required	Description
`data`	No
`error`	No	Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message "unknown thread_id" (anti-enumeration).
`freshness`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 10, 2026

addedInput schema / properties / country

Added value: +{
+  "description": "Optional consistency assertion: must equal the rooftop's country; omit it unless you are checking.",
+  "enum": [
+    "US",
+    "CA"
+  ],
+  "type": "string"
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "data": {
+      "additionalProperties": false,
+      "properties": {
+        "market": {
+          "additionalProperties": false,
+          "properties": {
+            "country": {
+              "enum": [
+                "US",
+                "CA"
+              ],
+              "type": "string"
+            },
+            "currency": {
+              "type": "string"
+            },
+            "odometer_unit": {
+              "enum": [
+                "mi",
+                "km"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "country",
+            "currency",
+            "odometer_unit"
+          ],
+          "type": "object"
+        },
+        "unit": {
+          "allOf": [
+            {
+              "description": "The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here.",
+              "properties": {
+                "asking_price": {
+                  "minimum": 0,
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "body_style": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "carfax_one_owner": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "carfax_report_url": {
+                  "maxLength": 500,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "city_mpg": {
+                  "maximum": 999,
+                  "minimum": 1,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "condition": {
+                  "description": "Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.",
+                  "enum": [
+                    "new",
+                    "used"
+                  ]
+                },
+                "currency": {
+                  "maxLength": 3,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "description": {
+                  "maxLength": 10000,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "doors": {
+                  "maximum": 10,
+                  "minimum": 1,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "drivetrain": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "effective_price": {
+                  "description": "An unexpired special price when present, otherwise asking price; null when neither is available.",
+                  "minimum": 0,
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "effective_price_source": {
+                  "description": "The field selected for effective_price, or null when effective_price is null.",
+                  "enum": [
+                    "special_price",
+                    "asking_price",
+                    null
+                  ]
+                },
+                "engine": {
+                  "maxLength": 120,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "engine_cylinders": {
+                  "maximum": 16,
+                  "minimum": 1,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "engine_displacement": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "exterior_color": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "fuel_type": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "highway_mpg": {
+                  "maximum": 999,
+                  "minimum": 1,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "identity": {
+                  "maxLength": 30,
+                  "minLength": 5,
+                  "type": "string"
+                },
+                "interior_color": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "is_certified": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "make": {
+                  "maxLength": 80,
+                  "type": "string"
+                },
+                "model": {
+                  "maxLength": 80,
+                  "type": "string"
+                },
+                "model_year": {
+                  "maximum": 2100,
+                  "minimum": 1950,
+                  "type": "integer"
+                },
+                "msrp": {
+                  "minimum": 0,
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "odometer": {
+                  "minimum": 0,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "odometer_unit": {
+                  "enum": [
+                    "mi",
+                    "km"
+                  ],
+                  "type": "string"
+                },
+                "options": {
+                  "items": {
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "maxItems": 100,
+                  "type": [
+                    "array",
+                    "null"
+                  ]
+                },
+                "passenger_capacity": {
+                  "maximum": 20,
+                  "minimum": 1,
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "photo_urls": {
+                  "items": {
+                    "maxLength": 300,
+                    "type": "string"
+                  },
+                  "maxItems": 60,
+                  "type": [
+                    "array",
+                    "null"
+                  ]
+                },
+                "price_basis": {
+                  "const": "dealer_published",
+                  "type": "string"
+                },
+                "provenance": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "enriched_fields": {
+                      "items": {
+                        "enum": [
+                          "photo_urls",
+                          "options",
+                          "description",
+                          "vdp_url",
+                          "video_url",
+                          "city_mpg",
+                          "highway_mpg",
+                          "doors",
+                          "passenger_capacity",
+                          "engine_cylinders",
+                          "engine_displacement",
+                          "carfax_one_owner",
+                          "carfax_report_url",
+                          "is_certified",
+                          "trim",
+                          "body_style",
+                          "transmission",
+                          "drivetrain",
+                          "asking_price"
+                        ]
+                      },
+                      "maxItems": 19,
+                      "type": "array",
+                      "uniqueItems": true
+                    },
+                    "merch_updated_at": {
+                      "format": "date-time",
+                      "maxLength": 40,
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "merch_updated_at",
+                    "enriched_fields"
+                  ],
+                  "type": "object"
+                },
+                "special_expiry": {
+                  "format": "date",
+                  "maxLength": 10,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "special_price": {
+                  "minimum": 0,
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "stock_number": {
+                  "maxLength": 40,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "transmission": {
+                  "maxLength": 80,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "trim": {
+                  "maxLength": 120,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "vdp_url": {
+                  "maxLength": 500,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "video_url": {
+                  "maxLength": 500,
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "identity",
+                "condition",
+                "model_year",
+                "make",
+                "model",
+                "odometer_unit",
+                "price_basis"
+              ],
+              "type": "object"
+            },
+            {
+              "not": {
+                "required": [
+                  "date_in_stock"
+                ]
+              }
+            }
+          ]
+        }
+      },
+      "required": [
+        "unit"
+      ],
+      "type": "object"
+    },
+    "error": {
+      "additionalProperties": false,
+      "description": "Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).",
+      "properties": {
+        "auth_help_url": {
+          "description": "Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.",
+          "format": "uri",
+          "maxLength": 500,
+          "type": "string"
+        },
+        "code": {
+          "enum": [
+            "rooftop_not_found",
+            "rooftop_inactive",
+            "unit_not_found",
+            "invalid_params",
+            "rate_limited",
+            "upstream_unavailable",
+            "capability_unavailable",
+            "identity_required",
+            "quota_exceeded",
+            "unit_held",
+            "quote_expired",
+            "rooftop_paused",
+            "handoff_duplicate",
+            "idempotency_conflict",
+            "price_unavailable",
+            "snapshot_expired",
+            "artifact_too_large",
+            "cursor_invalid",
+            "cursor_expired",
+            "ambiguous_identity",
+            "unsupported_in_country"
+          ]
+        },
+        "message": {
+          "maxLength": 500,
+          "type": "string"
+        },
+        "retry_after_seconds": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "type": "object"
+    },
+    "freshness": {
+      "additionalProperties": false,
+      "properties": {
+        "by_rooftop": {
+          "additionalProperties": {
+            "additionalProperties": false,
+            "properties": {
+              "last_ingest_at": {
+                "format": "date-time",
+                "maxLength": 40,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "status": {
+                "enum": [
+                  "fresh",
+                  "stale",
+                  "no_data"
+                ]
+              }
+            },
+            "required": [
+              "status",
+              "last_ingest_at"
+            ],
+            "type": "object"
+          },
+          "maxProperties": 500,
+          "type": "object"
+        }
+      },
+      "required": [
+        "by_rooftop"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

First observedAug 10, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Annotations already declare safe, idempotent, open-world read behavior, yet the description adds substantial context beyond them: the returned detail shape, presentation instructions for photo_urls, the unit_not_found error path, and the pricing caveats around excluded fees and pricing_coverage="partial_estimate". This is a rare case where the description meaningfully exceeds the annotation signal.

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

Conciseness4/5

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

Front-loaded with the core operation, then layers output shape, error behavior, and pricing caveats in dense but functional sentences. The pricing-disclosure instructions are necessary but make the block longer than ideal; every sentence does carry operational weight.

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

Completeness5/5

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

Despite an output schema existing, the description still adds presentation and interpretation guidance (photo embedding, pricing disclosure, partial_estimate handling) that the schema cannot express. Combined with the error case and sibling routing, nothing an agent needs is missing.

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

Parameters4/5

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

Schema coverage is only 33%, so the description must compensate, and it does: it identifies 'identity' as the VIN and names the exact upstream source of 'rooftop_slug'. The optional country assertion is documented in the schema itself, but no format or validation nuance is added beyond that.

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

Purpose5/5

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

States a specific verb and resource with scope: fetch one unit by VIN from a named rooftop. It clearly distinguishes itself from network_search (source of rooftop_slug) and quote_preview (totals), so an agent can identify its role without opening the schema.

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

Usage Guidelines5/5

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

Explicitly routes the agent: rooftop_slug comes from network_search results, and quote_preview should be called for the estimated total. It also defines the failure condition (unknown/ineligible identity or rooftop returns unit_not_found), giving concrete when/when-not guidance.

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

All Agentic Dealer Network tools Inspect

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

Need Help?