Skip to main content
Glama

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

TableJSON Schema
NameRequiredDescriptionDefault
countryNoOptional consistency assertion: must equal the rooftop's country; omit it unless you are checking.
identityYes
rooftop_slugYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNo
errorNoUnknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message "unknown thread_id" (anti-enumeration).
freshnessNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • 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"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources