Pulltrader

Pulltrader — トレーディングカード MCP サーバー

カードを特定し、直近の成約価格を調べ、市場価値を要約し、価格推移をグラフ化します。さらに、eBay、Pulltrader、その他のカードマーケットプレイスで販売した場合に、売り手の手元にいくら残るかを比較できます。これらすべてを AI アシスタント内で実行できます。

トレーディングカードの調査と販売向けの、公開読み取り専用のModel Context Protocol サーバーです。8 つのツールを備えています。Kapture の盗難カード登録情報の照会が 1 つ、Pulltrader のカードデータを利用するもの（特定、類似する成約済み販売の検索、市場価値、価格推移）が 4 つ、日付とバージョンが管理された手数料体系に基づいて Pulltrader の決定論的な売り手向け経済性エンジンを実行するものが 3 つです。

市場価格は、直近の販売実績から算出した推定値です。手数料の計算は決定論的です。サーバーが計算し、モデルに文章から手数料を推測させることはありません。eBay の数値には、推定値であることが明記されます。

• トランスポート： Streamable HTTP（POST /mcp）
• 認証： なし（公開、読み取り専用）
• エンドポイント： https://mcp.pulltrader.app/mcp
• レジストリ名： app.pulltrader/seller-economics
• プロトコル： 2025-06-18（クライアントからバージョンが指定されている場合は、そのバージョンを応答に反映します）

対象ユーザー

アシスタントを離れることなく、カードの種類や価値、販売後に実際に手元に残る金額を知りたいトレーディングカードの売り手、ディーラー、ショップ、コレクター向けです。

できること（および、できないこと）

できること	できないこと
カードの説明文から構造化フィールドを特定する	画像からカードを特定する（テキストのみ）
直近の類似する成約済み販売を返す（価格＋日付）	出品、アフィリエイト、または販売ごとの外部 URL を返す
市場価値を要約する：中央値、平均、p10～p90、変動性、信頼度	確定価値を保証したり、金融アドバイスを提供したりする
日／週／月ごとの価格推移を傾向とともにグラフ化する	書き込み、注文、アカウントの変更を行う
販売方法ごとの売り手手数料と純収入を推定する	いずれかのプラットフォームが常に最安だと断言する
目標の純収入に必要な価格を計算する	オークション形式（落札価格、購入者プレミアム、委託販売）をモデル化する
前提、データの鮮度、制限事項を明示する	カード以外のカテゴリや USD 以外の通貨を扱う

ツール

Kapture 証明書の確認（データに基づく）

check_kapture_cert は { "cert": "00123456" } を受け付け、先頭のゼロを保持します。 CLEAN は、確認済みの盗難報告と一致しなかったことのみを意味します。STOLEN の場合は、Kapture の 報告と任意で利用できる Pulltrader の回収フォームへのリンクが含まれます。このツールが 個人情報を収集したり、所持していると推測したり、回収報告を送信したりすることはありません。バックエンドが KAPTURE_API_KEY を保持するため、新たな Worker シークレットは不要です。Kapture が報告 API を提供するまでは、回収手続きへの引き継ぎは手動です。pulltrader-backend/docs/KAPTURE.md を参照してください。

カードの調査（データに基づく）

Pulltrader のバックエンドに接続します。カードデータは限定公開です。上限付きの販売サンプルであり、個別の出品 URL やアフィリエイト URL はなく、カタログの参照画像のみを提供します。

各ツールでは、query（自然言語による説明。例："2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10"）または item（構造化フィールド：player_athlete、year_manufactured、set_name、card_number、parallel_variety、grader、grade、sport）のいずれかを指定します。どちらか一方は必須です。

ツール	返される内容
identify_card	正規化されたフィールド（選手／アスリート、年、セット、番号、パラレル、鑑定会社、グレード、カテゴリ）と、信頼度および解決されたフィールドを返します。query のみを受け付けます。カードの価格は取得しません。
search_card_sales	最近の類似カードの成約販売データ（価格＋日付）の上限付きサンプルと、市場のスナップショットを返します。limit は省略可能です。
summarize_card_market	正規化された市場価値として、中央値、平均値、p10～p90、変動性、サンプル数、信頼度を返します。
get_card_price_history	トレンドを含む、グラフ表示用の時系列データを返します。interval は省略可能で、day | week | month を指定できます。

eBay に日付付きの類似成約データがない場合、search_card_sales と summarize_card_market は信頼できるベンダー価格にフォールバックし、market_value、value_source（TCG Market | CardSightAI | eBay Comps）、price_change_7d、price_change_30d、およびカタログ画像を 1 枚返します。

販売者の収益（決定論的、I/O なし）

ツール	返される内容
compare_selling_costs	販売方法ごとの内訳、eBay を基準にした差額、使用した前提条件とともに、1 回の販売にかかる推定手数料と手取り額を返します。sale_price が必須です。
calculate_required_sale_price	1 つの販売方法で目標手取り額（acquisition_cost を指定した場合は純利益）を達成するために必要な、1 点あたりの価格を返します。target_net が必須です。
explain_selling_method	各方法で誰が出品を管理し、発送を行い、手数料を請求するかを、平易な構造化形式で説明します。同じエンジンを使用するため、compare_selling_costs と内容に食い違いが生じることはありません。

共通入力（compare_selling_costs、calculate_required_sale_price）：

フィールド	型	デフォルト	備考
currency	enum USD	USD	USD のみ対応
quantity	integer	1	注文ごとの固定手数料は 1 回のみ適用
shipping_amount	number	0	eBay の手数料算定基準に影響します
item_category	enum trading_cards	trading_cards	トレーディングカードのみ
seller_plan	free|starter|pro|shop	free	マーケットプレイスの支払いティア
seller_level	enum	プランから導出	支払いレベルを明示的に上書きします
seller_covers_fees	boolean	false	false の場合、購入者がプラットフォーム手数料を負担します
ebay_store_subscription	boolean	false	eBay ストア料金（12.35%）と個人出品料金（13.25%）を切り替えます
acquisition_cost	number	—	出力を純利益に切り替えます
ebay_fee_percent_override	number	—	推定 eBay FVF 率（定額）を上書きします

対応する販売方法： ebay、pulltrader_marketplace、pulltrader_fbp、pulltrader_storefront、pulltrader_pos に加え、競合マーケットプレイスの推定値として tcgplayer、manapool、misprint、fanatics_collect、goldin に対応します（デフォルトでは無効です。methods で明示的に有効化してください）。競合他社の数値は固定価格／今すぐ購入の販売者手数料のみをモデル化します。

プロンプトの例

• 「このカードは何ですか：2023 Bowman Chrome Elly De La Cruz PSA 10？」
• 「このカードの最近の成約事例と市場価値を見せてください。」
• 「過去 1 年間の 2018 Prizm Luka Doncic Silver PSA 10 の価格履歴を教えてください。」
• 「グレード鑑定済みカードを 250 ドルで販売した場合の推定手取り額を比較してください。」
• 「80 ドルのカードを eBay と Pulltrader で販売した場合、それぞれいくら手元に残りますか？」
• 「手数料を差し引いて 200 ドルを得るには、いくらで売ればよいですか？」
• 「この支払い額の推定に使われた前提条件を説明してください。」

回答例（テキストの要約）

On a $250.00 trading-card sale, estimated seller proceeds by method:
- Sell it yourself on eBay: keep $216.47 (estimated) (fees $33.53, 13.41%)
- Pulltrader marketplace (you ship): keep $235.00 (fees $15.00, 6%)
- Your Pulltrader storefront (you ship): keep $250.00 (fees $0.00, 0%)
For these inputs, Your Pulltrader storefront (you ship) returns about $33.53 more than Sell it yourself on eBay.
Estimate based on fee schedules updated 2026-06-01 (Pulltrader) and 2026-06-27 (eBay, estimated). Estimates only, for trading cards in USD. ...

eBay＝個人向けFVF 13.25%＋注文ごとに$0.40（$10を超える注文）。Pulltraderにはストアフロント／POSで販売者手数料がないため、ストアフロントの売上は100%残ります。ここでは購入者がプラットフォーム手数料のみを負担します。Pulltraderのカード販売では、プラットフォーム手数料が常に請求されます（デフォルトでは購入者が負担します）。

接続

Claude（ウェブ／デスクトップ）

Settings → Connectors → Add custom connector → URL https://mcp.pulltrader.app/mcp.

ChatGPT

Settings → Apps & Connectors → Advanced → Developer mode を有効にする → Create → URL https://mcp.pulltrader.app/mcp.

Cursor／汎用

MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "scout-by-pulltrader": {
      "url": "https://mcp.pulltrader.app/mcp"
    }
  }
}

テスト済みのクライアント： Claude（ウェブ／デスクトップ）、ChatGPT の開発者モード、Cursor、MCP Inspector。すべてのアシスタントとの互換性を保証するものではありません。

パブリックアクセスとレート制限

/mcp エンドポイントはパブリックで、読み取り専用です。別個の販売者向けリソースは /seller/mcp に実装されています。OAuth は設定済みで、サインイン対応のパイロット版は保留中です。Seller MCP を参照してください。

制限	デフォルト	備考
すべての POST /mcp	60 / IP / 分	HTTP 429 + Retry-After。KV がダウンしている場合はフェイルオープンです。
データツール（identify / comps / market / history）	8 / IP / 分、40 / IP / 日	ツールの isError は RATE_LIMITED。KV がダウンしている場合はフェイルクローズです。
データツール全体	10,000 / 日	モデルと comps の費用に対するサーキットブレーカーです。
バッチサイズ	5 メッセージ	これより大きいバッチは拒否されます。

MCP_ABUSE KV 名前空間が必要です（wrangler.toml を参照）。PUBLIC_RATE_LIMIT_PER_MIN、DATA_RATE_LIMIT_PER_MIN、DATA_RATE_LIMIT_PER_DAY、DATA_GLOBAL_LIMIT_PER_DAY で調整できます。

エラー

入力の問題は、JSON-RPC エラーではなく、isError: true と安定したコードを含むツール結果として返されます：INVALID_INPUT、NOT_FOUND、RATE_LIMITED、UPSTREAM_ERROR、UPSTREAM_TIMEOUT、DATA_BACKEND_UNAVAILABLE、INTERNAL_ERROR。不明なメソッドや不正な形式のエンベロープには、標準の JSON-RPC エラーコードが使用されます。

4つのカードツールにはバックエンドブリッジ（PULLTRADER_API_BASE + SCOUT_MCP_SECRET）が必要です。これがない場合、DATA_BACKEND_UNAVAILABLE に縮退します。3つの販売者向け経済性ツールは純粋な処理で、常に利用できます。

データソースと手数料情報の鮮度

• カードデータは公開範囲が限定されており、推定値のみです。Pulltrader の共有ドメインエンジンで集計した、直近の販売事例の上限付きサンプルです。
• Pulltrader の手数料は、Pulltrader の正式な内部手数料設定を反映しています。
• eBay の手数料は、公表されているトレーディングカードの料金（階層別の個人／ストア向け成約手数料＋注文金額に応じた注文ごとの手数料）の推定値で、定期的に更新・確認されます。docs/FEE_SCHEDULES.md を参照してください。料金表の確認期限を過ぎている場合、レスポンスに警告が表示されます。

現在の料金表バージョンは /version でライブ配信されています。

制限事項

• eBay の推定には、プロモーション掲載、国際手数料、購入者が支払う売上税、販売者自身の配送ラベル費用は含まれません。
• 市場価格は直近の販売実績に基づく推定値で、手数料、税金、送料は含まれません。
• 金融上の助言ではありません。実際の手取り額と実際の価値は変動します。
• 今回のリリースでは、トレーディングカード／USD のみが対象です。

開発

npm install
npm run typecheck   # tsc --noEmit
npm test            # vitest
npm run dev         # wrangler dev (local)

デプロイとレジストリへの登録には明示的な承認が必要です。docs/DEPLOYMENT.md と docs/DISTRIBUTION.md を参照してください。開発セッションからデプロイまたは公開しないでください。

詳細

• プライバシー · セキュリティ · 利用規約 · 変更履歴
• 手数料表と更新プロセス

デプロイの前提条件

wrangler kv namespace create MCP_ABUSE
wrangler kv namespace create MCP_ABUSE --preview
# Paste ids into wrangler.toml [[kv_namespaces]] binding MCP_ABUSE
wrangler secret put SCOUT_MCP_SECRET

ロードマップ

• 画像によるカード識別。
• アスリート／選手のプロフィールツール。
• /seller/mcp のサインイン済みセラー向けパイロットを完了します。ユーザーごとのグローバルなクォータは今後の課題です。

---

Pulltrader が構築・保守しています。サポート：[email protected]

_{このリポジトリは、各リリース時に Pulltrader のモノレポからエクスポートされた Pulltrader MCP Worker の公開ミラーです。Issue や質問を歓迎します。プルリクエストは上流に適用されます。wrangler.toml の KV ID は伏せてあります。デプロイはモノレポから実行されます。}