JOY Automart

JOY Automart MCP Server

JOY Automart（バングラデシュの自動車部品・車両マーケットプレイス）向けの公式Model Context Protocolサーバーです。AI アシスタント（Claude、ChatGPT、Cursor、その他の MCP クライアント）から、JOY の自動車部品カタログや JOY Auto Exchange の車両出品を検索したり、車を比較したり、部品を調べたり、人間の購入者に購入手続きを引き継ぐ準備をしたりできます。価格は BDT で表示されます。

リモートエンドポイント	https://www.joyautomart.com/mcp
トランスポート	Streamable HTTP（MCP protocol 2025-06-18 以降）
認証	公開ツールは不要です。任意で購入者トークンを使用できます：Authorization: Bearer joyagt_...
ドキュメント	https://www.joyautomart.com/developers
サーバーカード	https://www.joyautomart.com/.well-known/mcp/server-card.json

サーバーは JOY Automart がホストしているため、利用にあたって何かを実行する必要はありません。このリポジトリには、公開メタデータ（レジストリの server.json、Smithery の設定、ツールのスナップショット）と、ローカルサーバーのみをサポートするクライアント向けの小さな stdio プロキシが含まれています。

ツール

公開されている読み取り専用ツールです（アカウントは不要です）。ライブの tools/list 呼び出しによるスナップショット（tools.json を参照）です。* は必須の引数を示します。

ツール	機能	引数
search_parts	バングラデシュの JOY Automart 自動車部品カタログを検索します。	query、make、chassis、category、in_stock_only、include_rfq_catalogue、max_price_bdt、page、page_size
get_part	カタログに掲載された部品 1 点の公開詳細情報（BDT 価格、在庫、最小注文数、検証済みオファー、数量別価格）を取得します。	part_id*
search_vehicles	メーカー、モデル、年式、燃料、BDT 価格でバングラデシュの JOY Auto Exchange の車両出品を検索します。	query、make、fuel_type、verified_only、include_unpriced、min_year、max_year、min_price_bdt、max_price_bdt、sort、page、page_size
get_vehicle	JOY Auto Exchange の出品 1 件（出品 ID またはスラッグを指定）の公開詳細情報（BDT 価格、仕様、写真、および車が JOY の人手による QC に合格している場合は検査の概要）を取得します。	vehicle_id*
get_auction_status	開催中または最近終了した JOY オークション 1 件の公開ステータス（BDT での現在の入札額、入札数、終了時刻、スナイプ対策による延長）を取得します。	auction_id*
compare_vehicles	出品（search_vehicles の ID またはスラッグ）2〜4 件を並べて比較します（価格、年式、走行距離、燃料、検証状況、検査グレード）。	vehicle_ids*
get_buying_guide	JOY Automart での購入方法を案内します。通貨（BDT）、支払い方法（カード、bKash/Nagad/Rocket、代金引換）、ダッカおよび全国の配送区域と料金、人間の担当者への連絡方法、認証済みエージェントによる注文方法を確認できます。	—
prepare_buyer_handoff	人間の購入者が購入を完了するために使用するリンクを作成します。商品ページと、正規化された部品の詳細および適合上の制限を含む、事前入力済みの WhatsApp メッセージを用意します。	part_id*、quantity、vehicle、note

すべての公開ツールには readOnlyHint: true が注釈として付与されています。**適合情報はあくまで参考です。**サーバーは VIN／シャーシの証拠がない限り、部品が車両に適合すると断言しません。購入前に JOY の営業チームに確認してください。

購入者が発行したエージェントトークン（https://www.joyautomart.com/cars/account?section=ai-agents&portal=retail で作成）を使うと、エージェントは quote_order、place_order（代金引換または承認済みの取引信用で、購入者の支出上限内）、create_rfq、get_order_status、list_my_orders も使用できます。

接続

Claude（claude.ai / Claude Desktop）

設定 → コネクタ → カスタムコネクタを追加 → URL https://www.joyautomart.com/mcp。

ChatGPT

設定 → コネクタ（開発者モード）→ 作成 → MCP サーバー URL https://www.joyautomart.com/mcp、認証：なし。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "joy-automart": { "url": "https://www.joyautomart.com/mcp" }
  }
}

VS Code / リモート HTTP に対応するクライアント

{
  "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

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"}'

ローカル stdio プロキシ（npx）—近日公開

npm パッケージ @joyautomart/mcp-server はまだ公開されていません。公開後は、stdio のみを使用するクライアントから次のように利用できます。

{
  "mcpServers": {
    "joy-automart": {
      "command": "npx",
      "args": ["-y", "@joyautomart/mcp-server"],
      "env": { "JOY_AGENT_TOKEN": "joyagt_your_token_here" }
    }
  }
}

それまでは、このリポジトリからプロキシを実行できます（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 は任意です。公開ツールはトークンなしで利用できます。

掲載情報

• 公式 MCP レジストリ名：com.joyautomart/mcp（server.json。ドメインの検証待ち）
• Smithery の設定：smithery.yaml

サポート

部品、注文、適合性に関するご質問：https://www.joyautomart.com。このリポジトリに関する問題：[GitHub の課題](https://github.com/www-joyautomart-com/mcp-server/issues)。

ライセンス

MIT © 2026 JOY Automart / Ahmed Joyadh