Skip to main content
Glama
JOY Automart MCP Server

JOY Automart MCP Server

Official

Get car details

get_vehicle
Read-onlyIdempotent

Retrieve a car listing’s public specifications, asking price, and inspection evidence by listing ID or slug to evaluate a vehicle before a purchase enquiry.

Instructions

Read a car listing's public specifications, asking price and inspection evidence; search_vehicles discovers candidates and compare_vehicles compares them.

  • Resolve an ID or slug to the returned canonical listing_id before counting offers. It identifies an advertisement; multiple advertisements do not establish independent inspection evidence.

  • Pass a non-empty auction_id to get_auction; an absent link means unknown auction status. Use search_auctions for discovery and prepare_vehicle_handoff for a selected car's human enquiry.

  • Anonymous fresh lookup. Missing facts stay unknown; a not-found listing requires a fresh search. Seller contacts and reserve prices stay private, and nothing is reserved.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "vehicle_id": "<vehicle_id>"
    },
    "name": "get_vehicle"
  }
}

Input Schema

NameRequiredDescriptionDefault
vehicle_idYeslisting_id returned by search_vehicles, or slug from a public JOY listing URL. Use only the ID/slug (letters/digits, dots, underscores, hyphens; starts with a letter/digit), not the URL, VIN or registration number.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.0.2
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "error": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "error": {
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    },
      +    "inspection": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "battery_health_percent": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "final_grade": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "identity_match": {
      +          "type": [
      +            "string",
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "overall_score": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "qc_approved_at": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "repair_estimate_bdt": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "final_grade",
      +        "overall_score",
      +        "repair_estimate_bdt",
      +        "battery_health_percent",
      +        "identity_match",
      +        "qc_approved_at"
      +      ],
      +      "type": "object"
      +    },
      +    "vehicle_detail": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "auction_id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "body_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "condition": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "currency": {
      +          "const": "BDT",
      +          "type": "string"
      +        },
      +        "description": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "fuel_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "hub": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "images": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "maxItems": 8,
      +          "type": "array"
      +        },
      +        "inspection_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "listing_id": {
      +          "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$",
      +          "type": "string"
      +        },
      +        "make": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "mileage_km": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "model": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price_bdt": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "transmission": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "trim": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": "string"
      +        },
      +        "verified": {
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "verified_inspection": {
      +          "$ref": "#/$defs/inspection"
      +        },
      +        "year": {
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "listing_id",
      +        "make",
      +        "model",
      +        "trim",
      +        "condition",
      +        "fuel_type",
      +        "transmission",
      +        "body_type",
      +        "hub",
      +        "inspection_status",
      +        "status",
      +        "year",
      +        "price_bdt",
      +        "mileage_km",
      +        "verified",
      +        "description",
      +        "auction_id",
      +        "images",
      +        "url",
      +        "currency"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "oneOf": [
      +    {
      +      "$ref": "#/$defs/vehicle_detail"
      +    },
      +    {
      +      "$ref": "#/$defs/error"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. Changed1 schema field changedv1.0.1
    • changedInput schema / properties / vehicle_id / description
      Previous value: -"listing_id or slug from search_vehicles."New value: +"listing_id returned by search_vehicles, or slug from a public JOY listing URL. Use only the ID/slug (letters/digits, dots, underscores, hyphens; starts with a letter/digit), not the URL, VIN or registration number."
  3. First observedv1.0.0

TDQS

A4.8/5.0
Behavior5/5

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

Beyond the read-only, idempotent and non-destructive annotations, the description discloses meaningful behavior: it is an anonymous fresh lookup, missing facts stay unknown, seller contacts and reserve prices remain private, and nothing is reserved. It also clarifies that the canonical listing_id identifies an advertisement rather than independent inspection evidence.

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?

The description is front-loaded with the core purpose and then uses bullets to separate sibling routing, identifier semantics, auction-link behavior and privacy constraints. It is information-dense but largely earns its space; minor trimming could make it tighter for a one-parameter tool.

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?

Given the existing output schema and annotations, the description supplies the remaining operational context an agent needs: canonical ID handling, privacy constraints, fresh-lookup behavior, not-found handling and auction-link interpretation. Nothing essential appears 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 100%, so the schema already defines vehicle_id as a listing_id or slug. The description adds useful semantic nuance by explaining that an ID or slug resolves to the returned canonical listing_id and that the identifier denotes an advertisement, not necessarily independent inspection evidence.

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?

The description states a specific verb and resource: reading a car listing's public specifications, asking price and inspection evidence. It also explicitly distinguishes this tool from search_vehicles (discovery) and compare_vehicles (comparison), so an agent can identify its role without opening sibling schemas.

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?

It names multiple alternatives and the exact conditions for using them: search_vehicles for discovery, compare_vehicles for comparison, search_auctions for auction discovery, get_auction when an auction_id is present, and prepare_vehicle_handoff for a human enquiry. It also states that a not-found listing requires a fresh search.

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