{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2026-07-28","supportedProtocolVersions":["2026-07-28","2025-11-25","2025-06-18","2025-03-26"],"serverInfo":{"name":"joy-automart","title":"JOY Automart","version":"1.2.0"},"description":"Read-only automotive parts and vehicle commerce tools for Bangladesh (BDT, English and Bangla).","documentationUrl":"https://www.joyautomart.com/AGENTS.md","transport":{"type":"streamable-http","endpoint":"https://www.joyautomart.com/mcp"},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":false,"schemes":["bearer"],"description":"Optional. A buyer-issued agent token (joyagt_...) unlocks quote, order, RFQ and order-status tools within the buyer's limits.","tokenUrl":"https://www.joyautomart.com/cars/account?section=ai-agents&portal=retail"},"instructions":"JOY Automart is Bangladesh's automotive commerce and intelligence platform. Use search_parts and get_part for spare parts (prices in BDT), search_vehicles for cars for sale, and get_buying_guide for payment and delivery terms. Never state that a part fits a vehicle unless JOY returns VIN/chassis evidence — say 'fitment to be confirmed'. Without a buyer's agent token these tools cannot place orders: use prepare_buyer_handoff so the human completes the purchase. A buyer can give their agent a token at https://www.joyautomart.com/cars/account?section=ai-agents&portal=retail; with it (Authorization: Bearer joyagt_...) the agent can also quote and place cash-on-delivery orders within the buyer's spending limits, send parts requests (RFQs) and track orders.","tools":[{"name":"search_parts","title":"Search car parts","description":"Search JOY Automart's automotive parts catalogue in Bangladesh. Accepts English, Bangla (e.g. 'টয়োটা এক্সিও ব্রেক প্যাড') or Banglish. Returns retail prices in BDT, availability and a product URL. Catalogue-only RFQ templates are omitted unless include_rfq_catalogue is true. Results are fitment candidates, not guarantees."},{"name":"get_part","title":"Get part details","description":"Full public detail for one catalogue part: BDT price, stock, minimum order, verified offers and bulk price breaks."},{"name":"search_vehicles","title":"Search cars for sale","description":"Search JOY Auto Exchange vehicle listings in Bangladesh by make, model, year, fuel and BDT price. Only stated listing facts are returned."},{"name":"get_vehicle","title":"Get car details","description":"Full public detail for one JOY Auto Exchange listing (by listing id or slug): BDT price, specs, photos and, when the car passed JOY's human QC, a summary of the inspection. Only stated listing facts are returned; seller contact details and reserves are never exposed."},{"name":"get_auction_status","title":"Auction status","description":"Public status of one live or recent JOY auction: current bid in BDT, bid count, end time and anti-snipe extensions. Observation only: bidding needs a verified dealer account and a human. The seller's reserve and bidder identities are never shown. Returns an error while live auctions are not open."},{"name":"compare_vehicles","title":"Compare cars","description":"Side-by-side comparison of 2 to 4 listings (ids or slugs from search_vehicles): price, year, mileage, fuel, verification and inspection grade. Listings that cannot be found are reported, not hidden."},{"name":"get_buying_guide","title":"Bangladesh buying terms","description":"How to buy from JOY Automart: currency (BDT), payment methods (card, bKash/Nagad/Rocket, cash on delivery), Dhaka and nationwide delivery zones and fees, human contact, and how an authenticated agent can place orders."},{"name":"prepare_buyer_handoff","title":"Prepare purchase handoff","description":"Compose the links a human buyer uses to complete a purchase: the product page and a pre-filled WhatsApp message with canonical part details and fitment limitations. JOY confirms pricing and purchase eligibility. Creates nothing and charges nothing."},{"name":"quote_order","title":"Quote an order","description":"Get JOY's authoritative BDT total for a basket of parts, priced for the buyer's own account. Nothing is ordered or reserved. Show this total to the buyer before calling place_order.","requiresAgentToken":true},{"name":"place_order","title":"Place an order","description":"Place an order for the buyer, paid by cash on delivery or approved trade credit, within the spending limits the buyer set for this agent. accepted_total_bdt must equal the total from quote_order; if JOY's price has changed the order is refused so the buyer can re-confirm. For online card payment, send the buyer the product link instead.","requiresAgentToken":true},{"name":"create_rfq","title":"Request a part (RFQ)","description":"Send a parts request to JOY's sourcing team for a part that is not in stock or not in the catalogue (rare, imported, body kits, VELLOX work). A person replies with a quote.","requiresAgentToken":true},{"name":"get_order_status","title":"Order status","description":"Status, items, total and payment state of one order placed by this buyer's account.","requiresAgentToken":true},{"name":"list_my_orders","title":"Recent orders","description":"The buyer's ten most recent JOY orders with status and total.","requiresAgentToken":true}]}