Skip to main content
Glama
JOY Automart MCP Server

JOY Automart MCP Server

Official

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

https://www.joyautomart.com/mcp

Transport

Streamable HTTP (MCP protocol 2025-06-18 and later)

Auth

None for the public tools. Optional buyer token: Authorization: Bearer joyagt_...

Docs

https://www.joyautomart.com/developers

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_parts

Search public parts by text, vehicle identity, category, availability and BDT budget.

query, make, chassis, category, in_stock_only, include_rfq_catalogue, max_price_bdt, page, page_size

get_part

Read one catalogue part's public detail, price, stock and fitment evidence.

part_id*

search_vehicles

Search public vehicle listings by text, make, year, fuel, verification and BDT asking price.

query, make, fuel_type, verified_only, include_unpriced, min_year, max_year, min_price_bdt, max_price_bdt, sort, page, page_size

get_vehicle

Read a vehicle by listing ID or slug, including public photos, inspection evidence and any auction link.

vehicle_id*

get_auction

Read an existing auction's public bid/status snapshot when public access is enabled.

auction_id*

search_auctions

Discover already-public auction links while paging through vehicle listings; source counts are not auction counts.

query, make, page, page_size

compare_vehicles

Compare 2–4 listings with explicit missing listings and unknown-price coverage.

vehicle_ids*

get_buying_guide

Read Bangladesh buying terms, delivery/payment guidance, human contact and declared fallback status.

—

prepare_vehicle_handoff

Resolve a public vehicle and prepare its listing link and human-reviewed WhatsApp enquiry.

vehicle_id*, note

prepare_part_handoff

Resolve a selected part after search and detail lookup, then prepare its product link and human-reviewed WhatsApp enquiry.

part_id*, quantity, vehicle, note

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/mcp

Quick 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/mcp

JOY_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 tools
compare_vehiclesCompare shortlisted car listingsA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 termsA
Read-onlyIdempotent
Inspect

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 detailsA
Read-onlyIdempotent
Inspect

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 detailsA
Read-onlyIdempotent
Inspect

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 handoffA
Read-onlyIdempotent
Inspect

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 enquiryA
Read-onlyIdempotent
Inspect

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 linksA
Read-onlyIdempotent
Inspect

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 partsA
Read-onlyIdempotent
Inspect

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 saleA
Read-onlyIdempotent
Inspect

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

    A4.7/5.0

    Scored across 10 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      19
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      1
      MIT