JOY Automart MCP Server
OfficialJOY Automart MCP lets AI assistants search Bangladesh car parts and vehicle listings, inspect public details/auctions, compare cars, read buying terms, and prepare human WhatsApp enquiries; with an optional buyer token it can also quote/place orders and manage RFQs/orders.
Search and browse car parts by text, vehicle make/chassis, category, stock availability, RFQ catalogue inclusion, and BDT budget.
Read a part's public price, availability, stock, OEM reference, fitment evidence/constraints, and sellability.
Search vehicle listings by text, make, fuel type, year, verification, and BDT asking price.
Read vehicle details, photos, inspection evidence, and any public auction link/status.
Discover public auction links and read public bid/status snapshots.
Compare 2–4 vehicle listings, including missing listings and unknown-price coverage.
Read Bangladesh buying terms, payment/delivery guidance, and human sales contact.
Prepare vehicle or part enquiry links with pre-filled WhatsApp messages; these do not send messages, reserve stock/vehicles, bid, order, or pay.
With a buyer-issued agent token, use buyer tools for quotes, cash-on-delivery/trade-credit orders, RFQs, order status, and order history.
Generates a pre-filled WhatsApp message link for a human buyer to complete a purchase, including canonical part details and fitment limitations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@JOY Automart MCP Server find brake pads for a Toyota Corolla under 5000 BDT"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JOY Automart MCP Server
Official Model Context Protocol server for JOY Automart, Bangladesh's automotive parts and vehicle marketplace. It lets AI assistants (Claude, ChatGPT, Cursor and other MCP clients) search JOY's car-parts catalogue and JOY Auto Exchange vehicle listings, compare cars, discover public auction links, look up a part, and prepare part or vehicle enquiries for a human buyer. Prices are in BDT.
Remote endpoint |
|
Transport | Streamable HTTP (MCP protocol 2025-06-18 and later) |
Auth | None for the public tools. Optional buyer token: |
Docs | |
Server card | https://www.joyautomart.com/.well-known/mcp/server-card.json |
The server is hosted by JOY Automart; you do not need to run anything to use it. This repository contains the public metadata (registry server.json, Smithery config, tool snapshot) and a small stdio proxy for clients that only support local servers.
Tools
Ten public, read-only tools (no account needed), verified against hosted version 1.3.0 on October 31, 2026. The live tools/list snapshot in tools.json includes all 35 documented arguments and typed success/error output schemas. * marks a required argument.
Tool | What it does | Arguments |
| Search public parts by text, vehicle identity, category, availability and BDT budget. |
|
| Read one catalogue part's public detail, price, stock and fitment evidence. |
|
| Search public vehicle listings by text, make, year, fuel, verification and BDT asking price. |
|
| Read a vehicle by listing ID or slug, including public photos, inspection evidence and any auction link. |
|
| Read an existing auction's public bid/status snapshot when public access is enabled. |
|
| Discover already-public auction links while paging through vehicle listings; source counts are not auction counts. |
|
| Compare 2–4 listings with explicit missing listings and unknown-price coverage. |
|
| Read Bangladesh buying terms, delivery/payment guidance, human contact and declared fallback status. | — |
| Resolve a public vehicle and prepare its listing link and human-reviewed WhatsApp enquiry. |
|
| Resolve a selected part after search and detail lookup, then prepare its product link and human-reviewed WhatsApp enquiry. |
|
Auction discovery scans public vehicle pages and reports source pagination, not a guaranteed count of active auctions. Public snapshot access retains its existing feature gate. Both handoff tools prepare links only; they send no message, reserve no stock or vehicle, and place no order.
Existing clients can still call get_auction_status and prepare_buyer_handoff as compatibility aliases for get_auction and prepare_part_handoff. Discovery advertises only the canonical names above.
All public tools are annotated readOnlyHint: true. Fitment is guidance only: the server never claims a part fits a vehicle without VIN/chassis evidence; confirm with JOY's sales team before buying.
With a buyer-issued agent token (create one at https://www.joyautomart.com/cars/account?section=ai-agents&portal=retail) an agent can also use quote_order, place_order (cash on delivery or approved trade credit, within the buyer's spending limits), create_rfq, get_order_status and list_my_orders.
Related MCP server: MarketCheck MCP Apps
Connect
Claude (claude.ai / Claude Desktop)
Settings → Connectors → Add custom connector → URL https://www.joyautomart.com/mcp.
ChatGPT
Settings → Connectors (developer mode) → Create → MCP server URL https://www.joyautomart.com/mcp, authentication: none.
Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"joy-automart": { "url": "https://www.joyautomart.com/mcp" }
}
}VS Code / any client with remote HTTP support
{
"servers": {
"joy-automart": { "type": "http", "url": "https://www.joyautomart.com/mcp" }
}
}Claude Code
claude mcp add --transport http joy-automart https://www.joyautomart.com/mcpQuick test with curl
curl -s https://www.joyautomart.com/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Local stdio proxy (npx) — coming soon
The npm package @joyautomart/mcp-server is not published yet. Once it is, stdio-only clients can use:
{
"mcpServers": {
"joy-automart": {
"command": "npx",
"args": ["-y", "@joyautomart/mcp-server"],
"env": { "JOY_AGENT_TOKEN": "joyagt_your_token_here" }
}
}
}Until then you can run the proxy from this repo (Node 18+):
git clone https://github.com/www-joyautomart-com/mcp-server && cd mcp-server
npm ci
node bin/joyautomart-mcp.js # or: --url https://www.joyautomart.com/mcpJOY_AGENT_TOKEN is optional; public tools work without it.
Listings
Official MCP Registry name:
com.joyautomart/mcp(server.json; listing pending domain verification)Smithery config: smithery.yaml
Support
Questions about parts, orders or fitment: https://www.joyautomart.com. Issues with this repository: GitHub issues.
License
MIT © 2026 JOY Automart / Ahmed Joyadh
Available Tools
10 toolscompare_vehiclesCompare shortlisted car listingsARead-onlyIdempotentInspect
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.
Inputs: vehicle_ids (required). Returns: object
get_auctionRead public car auction statusARead-onlyIdempotentInspect
Observe one car auction's public bid state; search_auctions discovers IDs and get_vehicle supplies the linked car's facts.
Select auction_id from the same discovery/detail record as the car being discussed. It identifies a sale event, not the vehicle advertisement: never substitute listing_id or carry a bid between auction IDs.
A saved event ID does not imply an open auction. Read status/end_at and refresh the snapshot before answering a bid question. minimum_next_bid is optional; an asking price cannot fill a missing bid value.
Anonymous observation only. Feature gating, rate limits or an unknown event can return errors; report them without bypass. Reserves and bidder identities stay private. Bidding requires a verified dealer and human decision outside this tool.
Inputs: auction_id (required). Returns: object
get_buying_guideBangladesh buying termsARead-onlyIdempotentInspect
Read published Bangladesh retail-parts payment, delivery and human-contact terms before explaining a purchase.
Call {}. These terms come from the public retail-marketplace configuration, not a product, address or buyer account. Product choice cannot personalize this call: get_part supplies item eligibility and prepare_part_handoff prepares the enquiry.
Apply the returned zones after learning the buyer's area; confirm quantity/fitment separately from get_part. Retail checkout terms do not establish vehicle, auction or trade-credit terms; route car questions through prepare_vehicle_handoff.
Anonymous live read. Money objects separate major BDT from minor paisa; vat_bps uses basis points. If live_terms_unavailable=true, ask the human team rather than invent fees. The result is guidance, not an accepted quote; no payment or message starts.
Inputs: no named parameters. Returns: object
get_partGet part detailsARead-onlyIdempotentInspect
Read one spare part's public price, availability and fitment restrictions; search_parts supplies its ID.
Copy the selected part_id unchanged. An OEM match can identify several catalogue entries: keep each entry's price, stock and fitment evidence together instead of borrowing facts from another matching entry.
A found item can remain unsellable. Use its minimum quantity and required fitment information when discussing an enquiry through prepare_part_handoff; unknown price or stock is not zero.
Anonymous fresh lookup; no supply is reserved or fitment certified. On a missing-ID error, search again rather than declaring the OEM part unavailable everywhere.
Inputs: part_id (required). Returns: object
get_vehicleGet car detailsARead-onlyIdempotentInspect
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.
Inputs: vehicle_id (required). Returns: object
prepare_part_handoffPrepare purchase handoffARead-onlyIdempotentInspect
Prepare product and pre-filled WhatsApp links for a human parts enquiry; use prepare_vehicle_handoff for whole cars.
First search_parts, then get_part, then copy the selected part_id here. Use get_buying_guide for general terms. Ask the buyer for missing fitment fields identified by get_part; never invent vehicle identity to complete an enquiry.
Keep quantity as the buyer's requested count, even below the published minimum: explain the gap rather than silently raising it. vehicle supplies fitment context; note can request confirmation but cannot override returned restrictions. Unit price times quantity is not an accepted quote.
Anonymous fresh lookup. Text is embedded in the link, so omit unnecessary personal details. Nothing opens, sends, reserves, orders or charges; the human decides whether to send and JOY confirms eligibility, fitment, stock and price.
Inputs: part_id (required), note, vehicle, quantity. Returns: object
prepare_vehicle_handoffPrepare a human car enquiryARead-onlyIdempotentInspect
Prepare a listing link and pre-filled WhatsApp enquiry for a human considering one car; use prepare_part_handoff for spare parts and compare_vehicles before choosing between cars. Choose vehicle_id from a shortlisted listing, not an auction ID. A slug is resolved to the canonical listing_id before the message is composed. note records the buyer's request; it cannot change the asking price, certify condition or authorize a bid. The link embeds the note, so omit unnecessary personal details. Anonymous fresh lookup. This is the endpoint of the public research workflow: the human decides whether to open and send the enquiry, then JOY confirms availability, inspection and terms. No seller contact, booking, reservation, bid, order or payment is performed.
Inputs: vehicle_id (required), note. Returns: object
search_auctionsDiscover car auction linksARead-onlyIdempotentInspect
Discover existing public car-auction IDs for get_auction; use get_vehicle for a known listing's details.
Express the desired car, not an auction title or bid: make='Toyota' scans that manufacturer's listings; add query='Premio' only for a model-specific request. Unpriced cars remain eligible because an auction need not have an asking price.
Pagination scans vehicles before extracting their links. Follow next_page even after an empty items page; claim the scan exhausted only when no next page remains and the source limit was not reached. At the limit, narrow the vehicle filters. Source counts are not auction counts.
Anonymous live read. Check each selected auction's current availability with get_auction; a link may be ended or feature-gated. No private lot is exposed or bid placed.
Inputs: make, page, query, page_size. Returns: object
search_partsSearch car partsARead-onlyIdempotentInspect
Find spare-part candidates in JOY's Bangladesh catalogue; use search_vehicles for whole cars.
Build filters from the buyer's intent: query names the item or OEM reference; make/chassis identify its vehicle. For example, combine Toyota, NZE141 and 'brake pads'. If nothing matches, clarify item text/category before changing a known vehicle identity.
Ask whether the buyer needs stocked supply or human sourcing before choosing the stock/RFQ flags. A catalogue-only match is an enquiry candidate, not a confirmed offer. Keep the chosen filters fixed while paging.
Anonymous live read. Empty results are valid; an uninterpretable Bangla query returns an error. Read get_part for the selected part_id, then prepare_part_handoff after fitment review. Search does not reserve stock.
Inputs: make, page, query, chassis, +5 more. Returns: object
search_vehiclesSearch cars for saleARead-onlyIdempotentInspect
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.
Inputs: make, page, sort, query, +8 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource+action: search/get pairs for parts, vehicles and auctions, plus compare_vehicles, get_buying_guide and the two prepare_*_handoff tools. The only mild overlap is search_vehicles vs search_auctions (auctions scan vehicle listings), but the descriptions explicitly redirect between them so an agent can distinguish them.
All ten tools follow a consistent snake_case verb_noun pattern (search_*, get_*, compare_vehicles, prepare_*_handoff). The singular/plural distinction (search_parts vs get_part, search_vehicles vs get_vehicle) is a sensible and consistent convention rather than an inconsistency.
Ten tools is well-scoped for a marketplace covering three resource families (parts, vehicles, auctions) plus comparison, terms, and handoffs. Every tool earns its place with no redundancy or filler.
The surface covers the full public research workflow for each domain: discovery, detail, comparison, auction status, terms, and human handoff endpoints for both parts and vehicles. Read-only/anonymous scope is intentional and explicitly noted, with no dead ends within that stated purpose.
Related MCP Connectors
Automotive data for AI agents: VIN decode, listings, specs, build data, recalls, payments, taxes.
Automotive inventory search for AI assistants: vehicles, dealers, deals, and market data.
AI shopping assistant for the SuperCheap marketplace. Find and compare products and variants, manage your shopping cart, and request current delivery and checkout quotes. Connect with OAuth; availability depends on your market, and payment is completed on a hosted page.
Car-listing search and used-car market analysis as agent tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with New Zealand's largest online marketplace through the Trade Me API. Supports searching listings, managing watchlists, placing bids, making purchases, and accessing marketplace data across all Trade Me categories.6-
- FlicenseNot gradedqualityDmaintenanceProvides 25 interactive automotive intelligence tools for real-time market data, including VIN decoding, price predictions, and inventory analytics. It enables AI assistants to perform car searches, trade-in estimations, and market trend analysis using the Model Context Protocol.2-
- AlicenseAqualityBmaintenanceEnables AI assistants to search and retrieve used and new car listings from carsales.com.au, with support for various filters and detailed listing information including images. It uses a real browser to bypass bot protection and integrates with MCP-compatible clients like Claude Desktop and Claude Code.192MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search and aggregate used-vehicle listings across Cars.com, Autotrader, and KBB, with filters for price, mileage, dealer information, and CARFAX-style history conditions.1MIT