Mcp MCP Server

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.

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.

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.

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