Skip to main content
Glama
JOY Automart MCP Server

JOY Automart MCP Server

Official

Search cars for sale

search_vehicles
Read-onlyIdempotent

Find cars for sale in JOY Auto Exchange by make, model, price, year, fuel type, and verification status, with sorting and paging.

Instructions

Discover cars for sale in JOY Auto Exchange; use get_vehicle for detail, compare_vehicles for a shortlist or search_auctions for auction links.

  • Separate manufacturer and model: make='Toyota', query='Premio', max_price_bdt=3000000 expresses a Premio within 30 lakh. Filters intersect; a single 'Toyota Premio' phrase can miss a listing whose fields store those words separately.

  • Choose a priced-budget search or POA discovery deliberately. include_unpriced does not cancel numeric price bounds; omit both bounds when unknown-price cars must remain candidates. Asking prices are neither bids nor valuations.

  • Anonymous live read. Keep filters/sort fixed while paging; empty results are valid and missing prices remain unknown. Verification is inspection evidence, not a warranty. No seller is contacted or car reserved.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_vehicles"
  }
}

Input Schema

NameRequiredDescriptionDefault
makeNoCase-insensitive manufacturer prefix, e.g. Toyota. Combine with query='Premio' for that model; omit to include all makes.
pageNoOne-based results page, 1 through 500; defaults to 1. Keep filters and sort unchanged when paging.
sortNoResult order: latest (default: verified first, then newest), price_asc (lowest stated price first), price_desc (highest first), or year_desc (newest model year first). Stable tie-breaks support paging; no valuation is performed.latest
queryNoCase-insensitive phrase within make, model or trim; use query='Premio' with make='Toyota', not one combined 'Toyota Premio' phrase. Known Bangla/Banglish vocabulary is normalized; unsupported words may be dropped. Use known English model words for precision; omit to browse.
max_yearNoInclusive latest model year, 1950 through 2100. Omit for no upper-year filter; supply a value no less than min_year.
min_yearNoInclusive earliest model year, 1950 through 2100. Omit for no lower-year filter; supply a value no greater than max_year.
fuel_typeNoCase-insensitive prefix of a public listing's fuel label, e.g. hybrid. Copy a known label where possible; omit to include all fuel types.
page_sizeNoMaximum results requested per page, 1 through 20; defaults to 10. total is the matching population, which may exceed this page's item count.
max_price_bdtNoInclusive maximum stated asking price in Bangladesh taka, e.g. 3000000 means ৳30 lakh. Omit for no maximum; no less than min_price_bdt.
min_price_bdtNoInclusive minimum stated asking price in Bangladesh taka, e.g. 2000000 means ৳20 lakh. Omit for no minimum; no greater than max_price_bdt.
verified_onlyNoTrue requires the storefront's verified flag, approved inspection status and a non-empty inspection ID; false (default) also permits other public listings. Verification is not a vehicle warranty.
include_unpricedNoTrue includes price-on-application or otherwise unpriced listings; false (default) excludes them. A missing asking price is unknown, never zero.

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"
      +    },
      +    "vehicle": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "body_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "browse_url": {
      +          "type": "string"
      +        },
      +        "condition": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "fuel_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "hub": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "image": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "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"
      +          ]
      +        },
      +        "verified": {
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "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",
      +        "image",
      +        "browse_url"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "oneOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "currency": {
      +          "const": "BDT",
      +          "type": "string"
      +        },
      +        "items": {
      +          "items": {
      +            "$ref": "#/$defs/vehicle"
      +          },
      +          "maxItems": 20,
      +          "type": "array"
      +        },
      +        "page": {
      +          "maximum": 500,
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "page_size": {
      +          "maximum": 20,
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "total": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "total",
      +        "page",
      +        "page_size",
      +        "currency",
      +        "items"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "$ref": "#/$defs/error"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. Changed17 schema fields changedv1.0.1
    • addedInput schema / properties / fuel_type / description
      Added value: +"Case-insensitive prefix of a public listing's fuel label, e.g. hybrid. Copy a known label where possible; omit to include all fuel types."
    • changedInput schema / properties / include_unpriced / description
      Previous value: -"Include vehicles with a pending or undisclosed asking price (POA)."New value: +"True includes price-on-application or otherwise unpriced listings; false (default) excludes them. A missing asking price is unknown, never zero."
    • addedInput schema / properties / make / description
      Added value: +"Case-insensitive manufacturer prefix, e.g. Toyota. Combine with query='Premio' for that model; omit to include all makes."
    • addedInput schema / properties / max_price_bdt / description
      Added value: +"Inclusive maximum stated asking price in Bangladesh taka, e.g. 3000000 means ৳30 lakh. Omit for no maximum; no less than min_price_bdt."
    • addedInput schema / properties / max_year / description
      Added value: +"Inclusive latest model year, 1950 through 2100. Omit for no upper-year filter; supply a value no less than min_year."
    • addedInput schema / properties / max_year / maximum
      Added value: +2100
    • addedInput schema / properties / max_year / minimum
      Added value: +1950
    • addedInput schema / properties / min_price_bdt / description
      Added value: +"Inclusive minimum stated asking price in Bangladesh taka, e.g. 2000000 means ৳20 lakh. Omit for no minimum; no greater than max_price_bdt."
    • addedInput schema / properties / min_year / description
      Added value: +"Inclusive earliest model year, 1950 through 2100. Omit for no lower-year filter; supply a value no greater than max_year."
    • addedInput schema / properties / min_year / maximum
      Added value: +2100
    • addedInput schema / properties / min_year / minimum
      Added value: +1950
    • addedInput schema / properties / page / description
      Added value: +"One-based results page, 1 through 500; defaults to 1. Keep filters and sort unchanged when paging."
    • addedInput schema / properties / page / maximum
      Added value: +500
    • addedInput schema / properties / page_size / description
      Added value: +"Maximum results requested per page, 1 through 20; defaults to 10. total is the matching population, which may exceed this page's item count."
    • addedInput schema / properties / query / description
      Added value: +"Case-insensitive phrase within make, model or trim; use query='Premio' with make='Toyota', not one combined 'Toyota Premio' phrase. Known Bangla/Banglish vocabulary is normalized; unsupported words may be dropped. Use known English model words for precision; omit to browse."
    • addedInput schema / properties / sort / description
      Added value: +"Result order: latest (default: verified first, then newest), price_asc (lowest stated price first), price_desc (highest first), or year_desc (newest model year first). Stable tie-breaks support paging; no valuation is performed."
    • addedInput schema / properties / verified_only / description
      Added value: +"True requires the storefront's verified flag, approved inspection status and a non-empty inspection ID; false (default) also permits other public listings. Verification is not a vehicle warranty."
  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?

Annotations already declare a safe, idempotent, closed-world read; the description adds substantial context on top: anonymous access, no seller contacted and no car reserved, empty results are valid, missing prices stay unknown, and verification is inspection evidence rather than a warranty. These are exactly the behavioral traits an agent cannot infer from the hint flags.

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?

Purpose and sibling routing are front-loaded, and the three bullets each carry distinct, non-redundant guidance. It is denser than a minimal definition and a few clauses (e.g. the paging reminder) repeat schema text, but nothing is padding.

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?

With an output schema present, the description needn't explain return values, and it doesn't. For a 12-parameter search tool it covers the remaining gaps — filter intersection semantics, paging stability, unpriced-listing handling, and the limits of verification — so an agent can call it correctly and interpret results honestly.

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 baseline is 3; the description earns an upgrade by explaining cross-parameter interaction that the schema states only per-field — notably that include_unpriced does not cancel numeric price bounds, and that asking prices are neither bids nor valuations. The make/query split is also reinforced, though it largely restates the schema's own wording.

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 ('Discover cars for sale in JOY Auto Exchange') and immediately distinguishes itself from three siblings: get_vehicle for detail, compare_vehicles for shortlists, search_auctions for auction links. An agent can route correctly without opening any 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 names alternatives and the conditions selecting them, plus tactical guidance on splitting make/query and on choosing a priced-budget search versus POA discovery. It even flags the failure mode (a combined 'Toyota Premio' phrase can miss listings), which is guidance no schema field provides.

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