JOY Automart
Search car parts and used/reconditioned vehicle listings in Bangladesh (BDT prices, stock).
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~8,651token 数（工具定义）
~8.4 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 6.76%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"mcp": {
"url": "https://www.joyautomart.com/mcp"
}
}
}远程端点
https://www.joyautomart.com/mcpstreamable-http它能做什么
工具清单
工具（10）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢search_parts(query, make, chassis, category, in_stock_only, ...)
Find spare-part candidates; use search_vehicles for whole cars and get_part to inspect a selected result. - Combine query/category for the item with make/chassis for its vehicle. Narrow ambiguous item text before relaxing known vehicle identity; a catalogue match never certifies fitment. - Choose stocked supply or RFQ sourcing deliberately. max_price_bdt limits the item's asking price, not the full purchase budget; check minimum quantity and delivery terms separately. Catalogue-only results need human confirmation. - page_size controls review batch size, not total supply. Keep it and the filters fixed while advancing page. Empty results are valid; an uninterpretable Bangla query returns an error. Anonymous searches reserve no stock.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "Part name, OEM reference or vehicle words in English, Bangla or Banglish; e.g. 'Axio brake pads' or 'টয়োটা এক্সিও ব্রেক প্যাড'. Omit for filtered browsing; not a part_id lookup."
},
"make": {
"type": "string",
"maxLength": 80,
"description": "Vehicle manufacturer, e.g. Toyota; narrows part candidates alongside the query. Omit if unknown."
},
"chassis": {
"type": "string",
"maxLength": 40,
"description": "Vehicle chassis/model code, e.g. NZE141 or G05; not a full VIN. Narrows candidates and does not certify fitment."
},
"category": {
"type": "string",
"maxLength": 100,
"description": "Public category label from a catalogue result, e.g. Brakes. Omit if the category is unknown."
},
"in_stock_only": {
"type": "boolean",
"default": false,
"description": "True requests currently in-stock candidates; false (default) permits other public availability states. This does not reserve stock."
},
"include_rfq_catalogue": {
"type": "boolean",
"default": false,
"description": "True also includes catalogue-only templates requiring a human parts request; false (default) omits them. Inclusion does not make an item directly purchasable."
},
"max_price_bdt": {
"type": "number",
"minimum": 0,
"description": "Inclusive maximum retail asking price in Bangladesh taka (BDT), e.g. 5000 means ৳5,000; omit for no budget ceiling. Not lakh units and not a currency conversion."
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1,
"description": "One-based results page, 1 through 500; defaults to 1. Increment to retrieve the next page with the same filters.",
"maximum": 500
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"description": "Maximum results requested per page, 1 through 20; defaults to 10. total describes all matches, not this page's item count."
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"currency": {
"type": "string",
"const": "BDT"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/part"
},
"maxItems": 20
},
"fitment_notice": {
"type": "string"
},
"query_interpreted_as": {
"type": "string"
}
},
"required": [
"total",
"page",
"page_size",
"currency",
"items",
"fitment_notice"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"part": {
"type": "object",
"properties": {
"part_id": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"name": {
"type": [
"string",
"null"
]
},
"oem_number": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"price_label": {
"type": [
"string",
"null"
]
},
"availability": {
"type": [
"string",
"null"
]
},
"stock_on_hand": {
"type": [
"number",
"null"
]
},
"minimum_order_quantity": {
"type": [
"number",
"null"
]
},
"sellable": {
"type": [
"boolean",
"null"
]
},
"fitment_candidates": {
"type": "array",
"items": {
"$ref": "#/$defs/fitment"
},
"maxItems": 8
},
"url": {
"type": [
"string",
"null"
]
},
"oem_reference_status": {
"type": [
"string",
"null"
]
},
"suppression_reason": {
"type": [
"string",
"null"
]
},
"compatibility_constraints": {
"anyOf": [
{
"$ref": "#/$defs/constraints"
},
{
"type": "null"
}
]
},
"hardware_specifications": {
"anyOf": [
{
"$ref": "#/$defs/hardware"
},
{
"type": "null"
}
]
},
"product_characteristics": {
"anyOf": [
{
"$ref": "#/$defs/classification"
},
{
"type": "null"
}
]
}
},
"required": [
"part_id",
"name",
"oem_number",
"category",
"price_bdt",
"price_label",
"availability",
"stock_on_hand",
"minimum_order_quantity",
"sellable",
"fitment_candidates",
"url",
"oem_reference_status",
"suppression_reason",
"compatibility_constraints",
"hardware_specifications",
"product_characteristics"
],
"additionalProperties": false
},
"classification": {
"type": "object",
"properties": {
"product_type": {
"type": "string"
},
"installation_type": {
"type": "string"
},
"classification_status": {
"type": "string"
},
"vehicle_specific": {
"type": "boolean"
},
"universal_accessory": {
"type": "boolean"
},
"universal_search_eligible": {
"type": "boolean"
},
"universal_constraints_verified": {
"type": "boolean"
}
},
"required": [],
"additionalProperties": false
},
"hardware": {
"type": "object",
"properties": {
"fitment_policy": {
"type": "string"
},
"application_note": {
"type": "string"
}
},
"required": [],
"additionalProperties": false
},
"constraints": {
"type": "object",
"properties": {
"constraint_type": {
"type": "string"
},
"status": {
"type": "string"
},
"verified": {
"type": "boolean"
},
"required_fields": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
}
},
"required": [],
"additionalProperties": false
},
"fitment": {
"type": "object",
"properties": {
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"chassis_code": {
"type": "string"
},
"engine": {
"type": "string"
},
"fitment_confidence": {
"type": "string"
},
"year_from": {
"type": "integer"
},
"year_to": {
"type": "integer"
},
"jdm_chassis_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"engine_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"years": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 200
}
},
"required": [],
"additionalProperties": false
}
}
}🟢get_part(part_id)
Inspect one spare part's price, supply and fitment evidence after search_parts; use prepare_part_handoff for a human enquiry. - part_id selects one catalogue record, not the OEM-number group. If several records share an OEM reference, select the buyer's intended record before lookup; never combine one record's price with another's stock or fitment. - A found record can remain unsellable. Read its minimum quantity and required fitment fields before proposing a purchase; missing price or stock means unknown, not zero. An OEM match does not certify fitment. - This anonymous lookup refreshes the selected record without reserving supply. If it is missing, search again and reconfirm any replacement with the buyer; a failed lookup does not prove the OEM part unavailable everywhere.
输入模式
{
"type": "object",
"properties": {
"part_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Exact catalogue part_id copied from search_parts, e.g. BRK-AXIO-01. This is JOY's catalogue identifier, not an OEM part number or a product URL."
}
},
"required": [
"part_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"part_id": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"name": {
"type": [
"string",
"null"
]
},
"oem_number": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"price_label": {
"type": [
"string",
"null"
]
},
"availability": {
"type": [
"string",
"null"
]
},
"stock_on_hand": {
"type": [
"number",
"null"
]
},
"minimum_order_quantity": {
"type": [
"number",
"null"
]
},
"sellable": {
"type": [
"boolean",
"null"
]
},
"fitment_candidates": {
"type": "array",
"items": {
"$ref": "#/$defs/fitment"
},
"maxItems": 8
},
"url": {
"type": [
"string",
"null"
]
},
"oem_reference_status": {
"type": [
"string",
"null"
]
},
"suppression_reason": {
"type": [
"string",
"null"
]
},
"compatibility_constraints": {
"anyOf": [
{
"$ref": "#/$defs/constraints"
},
{
"type": "null"
}
]
},
"hardware_specifications": {
"anyOf": [
{
"$ref": "#/$defs/hardware"
},
{
"type": "null"
}
]
},
"product_characteristics": {
"anyOf": [
{
"$ref": "#/$defs/classification"
},
{
"type": "null"
}
]
},
"description": {
"type": [
"string",
"null"
]
},
"verified_offer_count": {
"type": "integer",
"minimum": 0
},
"bulk_pricing": {
"type": [
"object",
"null"
],
"description": "Public storefront bulk-pricing metadata; not an accepted or locked quote."
},
"currency": {
"type": "string",
"const": "BDT"
},
"fitment_notice": {
"type": "string"
}
},
"required": [
"part_id",
"name",
"oem_number",
"category",
"price_bdt",
"price_label",
"availability",
"stock_on_hand",
"minimum_order_quantity",
"sellable",
"fitment_candidates",
"url",
"oem_reference_status",
"suppression_reason",
"compatibility_constraints",
"hardware_specifications",
"product_characteristics",
"description",
"verified_offer_count",
"bulk_pricing",
"currency",
"fitment_notice"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"classification": {
"type": "object",
"properties": {
"product_type": {
"type": "string"
},
"installation_type": {
"type": "string"
},
"classification_status": {
"type": "string"
},
"vehicle_specific": {
"type": "boolean"
},
"universal_accessory": {
"type": "boolean"
},
"universal_search_eligible": {
"type": "boolean"
},
"universal_constraints_verified": {
"type": "boolean"
}
},
"required": [],
"additionalProperties": false
},
"hardware": {
"type": "object",
"properties": {
"fitment_policy": {
"type": "string"
},
"application_note": {
"type": "string"
}
},
"required": [],
"additionalProperties": false
},
"constraints": {
"type": "object",
"properties": {
"constraint_type": {
"type": "string"
},
"status": {
"type": "string"
},
"verified": {
"type": "boolean"
},
"required_fields": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
}
},
"required": [],
"additionalProperties": false
},
"fitment": {
"type": "object",
"properties": {
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"chassis_code": {
"type": "string"
},
"engine": {
"type": "string"
},
"fitment_confidence": {
"type": "string"
},
"year_from": {
"type": "integer"
},
"year_to": {
"type": "integer"
},
"jdm_chassis_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"engine_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"years": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 200
}
},
"required": [],
"additionalProperties": false
}
}
}🟢search_vehicles(query, make, fuel_type, verified_only, include_unpriced, ...)
Research retail cars for sale; use get_vehicle for one listing, compare_vehicles for a shortlist or search_auctions to discover auction-event links. - Combine the buyer's make/model, fuel, model-year range and budget into one shortlist. verified_only narrows evidence quality, not mechanical warranty; year_desc ranks model year while latest prioritizes verified/newly listed adverts. - Decide whether POA cars belong in the shortlist. include_unpriced cannot override min_price_bdt/max_price_bdt; omit both price bounds to retain unknown-price candidates. Asking prices are neither bids nor valuations. - page_size sets the review batch; hold it, sort and filters fixed while advancing page. Anonymous live reads may return no matches. Use the selected listing's detail before enquiry; no seller is contacted or car reserved.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "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."
},
"make": {
"type": "string",
"maxLength": 60,
"description": "Case-insensitive manufacturer prefix, e.g. Toyota. Combine with query='Premio' for that model; omit to include all makes."
},
"fuel_type": {
"type": "string",
"maxLength": 40,
"description": "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."
},
"verified_only": {
"type": "boolean",
"default": false,
"description": "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."
},
"include_unpriced": {
"type": "boolean",
"default": false,
"description": "True includes price-on-application or otherwise unpriced listings; false (default) excludes them. A missing asking price is unknown, never zero."
},
"min_year": {
"type": "integer",
"description": "Inclusive earliest model year, 1950 through 2100. Omit for no lower-year filter; supply a value no greater than max_year.",
"minimum": 1950,
"maximum": 2100
},
"max_year": {
"type": "integer",
"description": "Inclusive latest model year, 1950 through 2100. Omit for no upper-year filter; supply a value no less than min_year.",
"minimum": 1950,
"maximum": 2100
},
"min_price_bdt": {
"type": "number",
"minimum": 0,
"description": "Inclusive minimum stated asking price in Bangladesh taka, e.g. 2000000 means ৳20 lakh. Omit for no minimum; no greater than max_price_bdt."
},
"max_price_bdt": {
"type": "number",
"minimum": 0,
"description": "Inclusive maximum stated asking price in Bangladesh taka, e.g. 3000000 means ৳30 lakh. Omit for no maximum; no less than min_price_bdt."
},
"sort": {
"type": "string",
"enum": [
"latest",
"price_asc",
"price_desc",
"year_desc"
],
"default": "latest",
"description": "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."
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1,
"description": "One-based results page, 1 through 500; defaults to 1. Keep filters and sort unchanged when paging.",
"maximum": 500
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"description": "Maximum results requested per page, 1 through 20; defaults to 10. total is the matching population, which may exceed this page's item count."
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"currency": {
"type": "string",
"const": "BDT"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/vehicle"
},
"maxItems": 20
}
},
"required": [
"total",
"page",
"page_size",
"currency",
"items"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"vehicle": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$"
},
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"trim": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
]
},
"fuel_type": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body_type": {
"type": [
"string",
"null"
]
},
"hub": {
"type": [
"string",
"null"
]
},
"inspection_status": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"mileage_km": {
"type": [
"number",
"null"
]
},
"verified": {
"type": [
"boolean",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"browse_url": {
"type": "string"
}
},
"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"
],
"additionalProperties": false
}
}
}🟢get_vehicle(vehicle_id)
Inspect one car listing's specifications, asking price and inspection evidence after search_vehicles; use compare_vehicles for a shortlist. - vehicle_id chooses an advertisement. Use the returned canonical listing_id to join its detail, comparison and enquiry; matching make/model or an ID/slug pair is not evidence of another independent offer. - A non-empty auction_id selects a separate event for get_auction; no link means auction status is unknown. Use prepare_vehicle_handoff after selecting the car, rather than treating inspection evidence as a warranty. - This anonymous lookup refreshes the advert. Missing facts remain unknown; a missing listing requires a new search. Seller contacts and auction reserve prices stay private, and no car is reserved.
输入模式
{
"type": "object",
"properties": {
"vehicle_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "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."
}
},
"required": [
"vehicle_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"$ref": "#/$defs/vehicle_detail"
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"vehicle_detail": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$"
},
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"trim": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
]
},
"fuel_type": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body_type": {
"type": [
"string",
"null"
]
},
"hub": {
"type": [
"string",
"null"
]
},
"inspection_status": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"mileage_km": {
"type": [
"number",
"null"
]
},
"verified": {
"type": [
"boolean",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"auction_id": {
"type": [
"string",
"null"
]
},
"images": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8
},
"url": {
"type": "string"
},
"currency": {
"type": "string",
"const": "BDT"
},
"verified_inspection": {
"$ref": "#/$defs/inspection"
}
},
"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"
],
"additionalProperties": false
},
"inspection": {
"type": "object",
"properties": {
"final_grade": {
"type": [
"string",
"null"
]
},
"overall_score": {
"type": [
"number",
"null"
]
},
"repair_estimate_bdt": {
"type": [
"number",
"null"
]
},
"battery_health_percent": {
"type": [
"number",
"null"
]
},
"identity_match": {
"type": [
"string",
"boolean",
"null"
]
},
"qc_approved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"final_grade",
"overall_score",
"repair_estimate_bdt",
"battery_health_percent",
"identity_match",
"qc_approved_at"
],
"additionalProperties": false
}
}
}🟢get_auction(auction_id)
Read one car auction's current public bid state; search_auctions discovers events and get_vehicle provides the linked car's facts. - auction_id binds every bid and deadline to one sale event. Keep that event's listing link beside the result; a bid from another event or the car's retail asking price cannot fill a missing auction value. - A saved event may have ended. Check status/end_at and refresh before answering a live-bid question; use minimum_next_bid only when returned. - Anonymous snapshots can fail for feature gating, rate limits or unknown events. Report the error; reserve prices and bidder identities stay private. Bidding requires a verified dealer and a human decision outside this tool.
输入模式
{
"type": "object",
"properties": {
"auction_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Copy auction_id from search_auctions or an auction-linked get_vehicle result, or use a known public auction ID supplied by the buyer. Supply the event identifier alone, not a listing_id or URL; never invent one."
}
},
"required": [
"auction_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"auction_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$"
},
"title": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"start_price": {
"type": [
"number",
"null"
]
},
"current_bid": {
"type": [
"number",
"null"
]
},
"bid_increment": {
"type": [
"number",
"null"
]
},
"bid_count": {
"type": [
"integer",
"null"
]
},
"end_at": {
"type": [
"string",
"null"
]
},
"extension_count": {
"type": [
"integer",
"null"
]
},
"minimum_next_bid": {
"type": "number"
},
"currency": {
"type": "string",
"const": "BDT"
},
"note": {
"type": "string"
}
},
"required": [
"auction_id",
"title",
"status",
"start_price",
"current_bid",
"bid_increment",
"bid_count",
"end_at",
"extension_count",
"currency",
"note"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
}
}
}🟢search_auctions(query, make, page, page_size)
Find auction-event links attached to public cars; use search_vehicles for car specifications and asking prices, or get_auction for one event's bid state. - Filter the linked car, not the auction title: make='Toyota' with query='Premio' targets that model's vehicle adverts. Unpriced cars remain eligible because an auction need not have a retail asking price. - page_size is a source-scan batch: inspecting 20 adverts can yield zero auction links. Keep batch size and filters fixed; follow next_page even after an empty items page. At the source limit, narrow the car filters instead of claiming an exhaustive search. - Results are links, not retail offers or bid snapshots. Source counts describe cars scanned; get_auction checks ended or gated events. Anonymous discovery exposes no private lots and places no bid.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "Make/model/trim phrase for candidate vehicles, e.g. Premio; omit to scan all public listings. Known Bangla/Banglish vocabulary is normalized."
},
"make": {
"type": "string",
"maxLength": 60,
"description": "Case-insensitive manufacturer prefix, e.g. Toyota; intersects the vehicle query. Omit for all makes."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 1,
"description": "One-based source vehicle page; use returned next_page with unchanged filters. This is not a page of guaranteed auction matches."
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"description": "Public vehicle listings inspected per source page. Auction links can be fewer than this value, including zero."
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"items": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"auction_id": {
"type": "string"
},
"listing_id": {
"type": "string"
},
"vehicle_url": {
"type": "string"
}
},
"required": [
"auction_id",
"listing_id",
"vehicle_url"
],
"additionalProperties": false
}
},
"source_listing_count": {
"type": "integer",
"minimum": 0,
"description": "Matching source vehicle listings across pages; not an auction count."
},
"scanned_listing_count": {
"type": "integer",
"minimum": 0,
"description": "Source vehicle records inspected on this page."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"has_more_source_listings": {
"type": "boolean"
},
"next_page": {
"type": [
"integer",
"null"
],
"minimum": 1,
"maximum": 500,
"description": "Next source vehicle page; may also contain no auction links. Null at the last page or the page limit."
},
"source_page_limit_reached": {
"type": "boolean"
},
"discovery_notice": {
"type": "string"
}
},
"required": [
"items",
"source_listing_count",
"scanned_listing_count",
"page",
"page_size",
"has_more_source_listings",
"next_page",
"source_page_limit_reached",
"discovery_notice"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
}
}
}🟢compare_vehicles(vehicle_ids)
Compare a selected car shortlist; use search_vehicles to discover candidates or get_vehicle for one car. - vehicle_ids chooses the adverts to include, in buyer-selected order; it does not rerun search filters. Resolve ID/slug aliases to distinct listing_id values. Repeating an advert must not create extra price evidence or imply another vehicle. - Keep unknown-price candidates visible when the buyer still wants to consider them. A cheapest result ranks only distinct, known positive prices; inspect price_comparison_complete before describing it as cheapest across the whole shortlist. Asking prices are not valuations. - Anonymous fresh lookups can partially fail. Inspect not_found/unavailable and retry temporary failures before excluding a candidate. Use prepare_vehicle_handoff after choosing; comparison reserves nothing.
输入模式
{
"type": "object",
"properties": {
"vehicle_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"minItems": 2,
"maxItems": 4,
"description": "Two to four listing_id values from search_vehicles or public listing slugs, not VINs or URLs. Choose distinct listings; repeated IDs or an ID and its slug do not provide separate price evidence."
}
},
"required": [
"vehicle_ids"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "BDT"
},
"vehicles": {
"type": "array",
"items": {
"$ref": "#/$defs/vehicle_detail"
},
"maxItems": 4
},
"not_found": {
"type": "array",
"items": {
"type": "string"
}
},
"unavailable": {
"type": "array",
"items": {
"type": "object",
"properties": {
"vehicle_id": {
"type": "string"
},
"http_status": {
"type": "integer"
},
"reason": {
"type": "string"
}
},
"required": [
"vehicle_id",
"http_status",
"reason"
],
"additionalProperties": false
}
},
"requested_listing_count": {
"type": "integer",
"minimum": 0
},
"found_listing_count": {
"type": "integer",
"minimum": 0
},
"not_found_listing_count": {
"type": "integer",
"minimum": 0
},
"unavailable_listing_count": {
"type": "integer",
"minimum": 0
},
"known_price_count": {
"type": "integer",
"minimum": 0
},
"unknown_price_count": {
"type": "integer",
"minimum": 0
},
"known_price_listing_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"unknown_price_listing_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"price_comparison_complete": {
"type": "boolean"
},
"cheapest_listing_id": {
"type": [
"string",
"null"
]
},
"price_comparison_notice": {
"type": "string"
}
},
"required": [
"currency",
"vehicles",
"not_found",
"unavailable",
"requested_listing_count",
"found_listing_count",
"not_found_listing_count",
"unavailable_listing_count",
"known_price_count",
"unknown_price_count",
"known_price_listing_ids",
"unknown_price_listing_ids",
"price_comparison_complete",
"cheapest_listing_id",
"price_comparison_notice"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"vehicle_detail": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$"
},
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"trim": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
]
},
"fuel_type": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body_type": {
"type": [
"string",
"null"
]
},
"hub": {
"type": [
"string",
"null"
]
},
"inspection_status": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"mileage_km": {
"type": [
"number",
"null"
]
},
"verified": {
"type": [
"boolean",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"auction_id": {
"type": [
"string",
"null"
]
},
"images": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8
},
"url": {
"type": "string"
},
"currency": {
"type": "string",
"const": "BDT"
},
"verified_inspection": {
"$ref": "#/$defs/inspection"
}
},
"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"
],
"additionalProperties": false
},
"inspection": {
"type": "object",
"properties": {
"final_grade": {
"type": [
"string",
"null"
]
},
"overall_score": {
"type": [
"number",
"null"
]
},
"repair_estimate_bdt": {
"type": [
"number",
"null"
]
},
"battery_health_percent": {
"type": [
"number",
"null"
]
},
"identity_match": {
"type": [
"string",
"boolean",
"null"
]
},
"qc_approved_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"final_grade",
"overall_score",
"repair_estimate_bdt",
"battery_health_percent",
"identity_match",
"qc_approved_at"
],
"additionalProperties": false
}
}
}🟢get_buying_guide
Read shared Bangladesh retail-parts payment and delivery terms before explaining a purchase; get_part supplies item eligibility and prepare_part_handoff prepares the enquiry. - No inputs: the same retail policy applies across items. Reuse it across a shortlist, then refresh before relaying fees; a buyer's address, basket or identity cannot personalize this call. - Select the returned delivery zone using the buyer's area. Retail terms do not establish vehicle, auction or trade-credit terms; route car enquiries through prepare_vehicle_handoff. - Money objects distinguish BDT from paisa; vat_bps is in basis points. If live_terms_unavailable is true, obtain human confirmation instead of inventing fees. This anonymous read accepts no quote or payment.
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"market": {
"type": "string",
"const": "Bangladesh"
},
"currency": {
"type": "string",
"const": "BDT"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"human_sales_contact": {
"type": "object",
"properties": {
"whatsapp": {
"type": "string"
},
"whatsapp_url": {
"type": "string"
}
},
"required": [
"whatsapp",
"whatsapp_url"
],
"additionalProperties": false
},
"how_to_buy": {
"type": "array",
"items": {
"type": "string"
}
},
"fitment_policy": {
"type": "string"
},
"live_terms_unavailable": {
"type": "boolean"
},
"payment_methods": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object"
}
]
}
},
"delivery_zones": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object"
}
]
}
},
"minimum_order": {
"anyOf": [
{
"$ref": "#/$defs/money"
},
{
"type": [
"number",
"null"
]
}
]
},
"free_delivery_threshold": {
"anyOf": [
{
"$ref": "#/$defs/money"
},
{
"type": [
"number",
"null"
]
}
]
},
"vat_bps": {
"type": "integer"
}
},
"required": [
"market",
"currency",
"languages",
"human_sales_contact",
"how_to_buy",
"fitment_policy"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"money": {
"type": "object",
"properties": {
"amount_minor": {
"type": "integer",
"description": "Minor currency units: 100 paisa = 1 BDT."
},
"currency": {
"type": "string"
},
"major": {
"type": "string",
"description": "Decimal amount in major currency units, formatted as text."
}
},
"required": [
"amount_minor",
"currency",
"major"
],
"additionalProperties": false
}
}
}🟢prepare_vehicle_handoff(vehicle_id, note)
Prepare a human enquiry for a selected car; use compare_vehicles before choosing and prepare_part_handoff for spare parts. - vehicle_id fixes the advert to enquire about. A slug resolves to canonical listing_id so the link and refreshed asking-price summary refer to the same advert; neither identifies an auction event. - note adds the buyer's question to that enquiry, not an instruction to change price or certify condition. It is embedded in the link; omit unnecessary personal details. - This anonymous lookup prepares links only. The human reviews and decides whether to send; JOY confirms availability, inspection and terms. No enquiry, booking, reservation, bid, order or payment is made.
输入模式
{
"type": "object",
"properties": {
"vehicle_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "A selected listing_id from search_vehicles/compare_vehicles, or a public listing slug. Supply only the ID/slug, not a full URL or VIN."
},
"note": {
"type": "string",
"maxLength": 300,
"description": "Optional human enquiry, e.g. request an inspection or confirm availability. Included in the pre-filled link; not submitted by this tool."
}
},
"required": [
"vehicle_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$"
},
"vehicle_url": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
},
"price_bdt": {
"type": [
"number",
"null"
]
},
"verified": {
"type": [
"boolean",
"null"
]
},
"inspection_status": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"const": "BDT"
}
},
"required": [
"make",
"model",
"year",
"price_bdt",
"verified",
"inspection_status",
"currency"
],
"additionalProperties": false
},
"whatsapp_enquiry_url": {
"type": "string"
},
"pricing_notice": {
"type": "string"
},
"inspection_notice": {
"type": "string"
},
"side_effects": {
"type": "string"
},
"next_step": {
"type": "string"
}
},
"required": [
"listing_id",
"vehicle_url",
"summary",
"whatsapp_enquiry_url",
"pricing_notice",
"inspection_notice",
"side_effects",
"next_step"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
}
}
}🟢prepare_part_handoff(part_id, quantity, vehicle, note)
Prepare a human parts enquiry after search_parts and get_part; use prepare_vehicle_handoff for whole cars and get_buying_guide for retail terms. - part_id fixes the selected item; quantity expresses the buyer's request, even below its minimum. Explain any gap rather than changing the request. Quantity times asking price excludes unconfirmed fees and is not an accepted quote. - vehicle supplies buyer-provided fitment context; collect missing fields identified by get_part. note qualifies that request but cannot clear fitment restrictions or change eligibility. Never invent vehicle identity. - A fresh anonymous lookup prepares links only. Text is embedded in the link, so omit unnecessary personal details. The human reviews and decides whether to send; JOY confirms fitment, stock and price. Nothing opens, reserves, orders or charges.
输入模式
{
"type": "object",
"properties": {
"part_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Exact part_id from search_parts/get_part for the selected item; not an OEM reference or product URL. The tool fetches fresh public part detail before composing the links."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1,
"description": "Number of units the buyer wants to enquire about, included in the prepared message. This is a request count, not a stock allocation."
},
"vehicle": {
"type": "string",
"maxLength": 120,
"description": "Buyer-provided make/model/year, chassis or VIN text for JOY's human fitment review. Omit if the buyer has not supplied vehicle information."
},
"note": {
"type": "string",
"maxLength": 300,
"description": "Buyer-supplied question or preference copied into the prepared enquiry, such as a request to confirm delivery or bulk terms."
}
},
"required": [
"part_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"part_id": {
"type": "string"
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"name": {
"type": [
"string",
"null"
]
},
"oem_number": {
"type": [
"string",
"null"
]
},
"oem_reference_status": {
"type": [
"string",
"null"
]
},
"suppression_reason": {
"type": [
"string",
"null"
]
},
"compatibility_constraints": {
"anyOf": [
{
"$ref": "#/$defs/constraints"
},
{
"type": "null"
}
]
},
"hardware_specifications": {
"anyOf": [
{
"$ref": "#/$defs/hardware"
},
{
"type": "null"
}
]
},
"product_characteristics": {
"anyOf": [
{
"$ref": "#/$defs/classification"
},
{
"type": "null"
}
]
},
"availability": {
"type": [
"string",
"null"
]
},
"sellable": {
"type": [
"boolean",
"null"
]
},
"fitment_notice": {
"type": "string"
},
"pricing_notice": {
"type": "string"
},
"product_url": {
"type": "string"
},
"whatsapp_order_url": {
"type": "string"
},
"side_effects": {
"type": "string"
},
"next_step": {
"type": "string"
}
},
"required": [
"part_id",
"quantity",
"name",
"oem_number",
"oem_reference_status",
"suppression_reason",
"compatibility_constraints",
"hardware_specifications",
"product_characteristics",
"availability",
"sellable",
"fitment_notice",
"pricing_notice",
"product_url",
"whatsapp_order_url",
"side_effects",
"next_step"
],
"additionalProperties": false
},
{
"$ref": "#/$defs/error"
}
],
"$defs": {
"error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"minLength": 1
}
},
"required": [
"error"
],
"additionalProperties": false
},
"classification": {
"type": "object",
"properties": {
"product_type": {
"type": "string"
},
"installation_type": {
"type": "string"
},
"classification_status": {
"type": "string"
},
"vehicle_specific": {
"type": "boolean"
},
"universal_accessory": {
"type": "boolean"
},
"universal_search_eligible": {
"type": "boolean"
},
"universal_constraints_verified": {
"type": "boolean"
}
},
"required": [],
"additionalProperties": false
},
"hardware": {
"type": "object",
"properties": {
"fitment_policy": {
"type": "string"
},
"application_note": {
"type": "string"
}
},
"required": [],
"additionalProperties": false
},
"constraints": {
"type": "object",
"properties": {
"constraint_type": {
"type": "string"
},
"status": {
"type": "string"
},
"verified": {
"type": "boolean"
},
"required_fields": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
}
},
"required": [],
"additionalProperties": false
}
}
}社区
证据
最近观测
已验证未记录版本10 个工具