Trade Agent MCP Server

公式

Trade Agentを介して株式と暗号通貨の取引を実行する

GitHub
54

ドキュメント

Trade It MCP Server

👉 完全なドキュメントはこちら 👈

公式MCPレジストリからも利用可能になりました

目次

概要

Trade It MCP Serverは、エージェントに株式、暗号資産、オプション取引のサポートを提供します。MCPプロトコルを通じて平易な英語のリクエストを送信することで、株式および暗号資産の証券会社との自然言語によるやり取り（取引の実行、ポートフォリオのパフォーマンス照会、市場インサイトの取得）を可能にします。

エンドポイント:

  • ストリーミングHTTP: https://mcp.tradeit.app/mcp
  • SSE: https://mcp.tradeit.app/sse

証券会社サポート:

暗号資産取引所サポート:

近日中にさらに追加予定！

このサーバーはリモートであるため、接続するためにローカルで何かを実行する必要はありません。MCP互換のエージェントプラットフォームを上記のURLに向けるだけです。

はじめに

  1. まず、https://tradeit.app. でアカウントを作成します。
  2. Proプランの無料トライアルにサインアップします。
  3. 利用する証券会社を連携します。

接続

  1. MCPクライアントを https://mcp.tradeit.app/mcp または https://mcp.tradeit.app/sse に接続します。
  2. ブラウザベースのOAuthフローで認証します。
  3. これで取引を開始する準備が整いました！

ツール

MCPツールはエージェントを連携済みの証券会社に接続します：シンボルの検索、口座の一覧表示、ドラフト注文の作成、そして確認後の実行のみを行います。

MCPツール機能
search_assetsティッカーまたは名前で株式または暗号資産を検索し、価格とメタデータを返します。
get_accounts連携済み口座と残高を一覧表示します。新しい証券会社を連携する際にも使用します。
create_tradeレビュー用に株式/暗号資産の買いまたは売りのドラフトを作成します。
create_options_tradeレビュー用に単脚または複数脚のオプション注文のドラフトを作成します。
execute_tradeユーザーによる明示的な確認後に、以前に作成したドラフトを証券会社に送信します。

安全モデル（ドラフト優先）

取引は draft 注文として開始され、ユーザーが明確に確認するまで証券会社に送信されません。

想定フロー:

  1. create_trade または create_options_trade を呼び出す → trade_id 付きのドラフトを取得します。
  2. ユーザーに注文の全詳細と進め方を表示します。
  3. ユーザーが明示的に実行、確認、または注文の発注を要求した場合にのみ execute_trade を呼び出します。
  4. ドラフト作成後、自動的にまたは即座に execute_trade を呼び出さないでください。

ドラフト作成後、ユーザーが準備できたらいつでも注文を発注できることを確認してください（例：クライアントの実行コントロールが利用可能な場合、それを介して）。

ドラフト作成前のオプション手順:

  • search_assets — ティッカーとコンテキストを確認します。
  • get_accounts — ユーザーがどの口座を使用するかを気にする場合、適切な account_id を選択します。

実行フロー:

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → draft with trade_id, status: "draft"
       ↓
Show draft details; user confirms
       ↓
execute_trade(trade_id)
       ↓
Status: "placed" or "failed" (with details)

口座/注文のデフォルト: ユーザーが数量、口座、または注文タイプを省略した場合、Trade Itはデフォルトの数量、デフォルトの口座、および該当する場合は成行注文を適用します。Trade Itの設定で自動実行が有効になっている場合、一部のセットアップでは手動の実行ステップがスキップされる可能性があります。不明な場合は、実行をユーザー確認済みとして扱ってください。

search_assets

ティッカーまたは名前で株式または暗号資産を検索します。

  • パラメータ: query (文字列) — 例: "TSLA"、"Tesla"、"bitcoin"。
  • 戻り値: 価格、ティッカー、取引所、資産タイプ、および関連メタデータ。

例:

{ "query": "TSLA" }

自然言語の例: "Appleの調子はどう？" · "TSLAの価格は？"

get_accounts

連携済みのすべての証券口座を一覧表示します（ユーザーが新しい証券会社を連携したい場合もこのフローを使用します）。

  • パラメータ: なし。
  • 戻り値: id、name、brokerage、balance、available_cash を含む口座。特定の口座が必要な場合、取引呼び出しで account.id を account_id として使用します。

自然言語の例: "口座を表示して。"

create_trade

株式または暗号資産のドラフト注文を作成します。

パラメータ:

フィールド型必須説明
symbolstringはいティッカー、例: "TSLA"。
amountnumberはい取引サイズ。
unit"dollars" または "shares"はいamount の単位。
buy_or_sell"buy" または "sell"はい方向。
order_type"market"、"limit"、"stop"、"stop_limit"いいえデフォルトは "market"。
limit_pricenumber指値/逆指値の場合該当する場合、1株あたりの最高または最低価格。
stop_pricenumber逆指値/逆指値指値の場合逆指値トリガー価格。
time_in_force"day"、"gtc"、"ioc"、"fok"いいえ証券会社のデフォルトを使用する場合は省略。
account_idnumberいいえデフォルト口座を使用する場合は省略。

注文タイプ:

タイプ使用場面価格フィールド
market現在の市場価格で約定なし
limitlimit_price 以上でのみlimit_price
stopstop_price でトリガーされる成行注文stop_price
stop_limitstop_price でトリガーされる指値注文stop_price および limit_price

JSONの例:

Appleを500ドル分成行で購入:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

NVDAが800ドル以下に下落した場合のみ10株購入:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

Metaの価格が450ドルに下落した場合に5株売却（逆指値）:

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

AAPLが200ドルを突破した場合、最大202ドル/株で10株購入:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

ビットコインを1,000ドル分購入:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

テスラを100株、キャンセルまで有効で売却:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

自然言語の例: "テスラを1000ドル分買って" · "テスラの価格が150ドル以下に下がったら1000ドル分買って" · "Appleの価格が140ドルに下がったら10株売って" · "Appleが200ドルに達したら1株買って" · "Appleが140ドルに上昇したら10株買って、でも142ドル以上は払わないで"

create_options_trade

単脚または複数脚のオプション注文（スプレッド、ストラドルなど）のドラフトを作成します。

パラメータ:

フィールド型必須説明
symbolstringはい原資産ティッカー、例: "SPY"。
legsarrayはい1つ以上のレッグ（下記参照）。
direction"debit" または "credit"複数脚"debit" = 支払い; "credit" = 受取り。
order_type"market"、"limit" などいいえデフォルトは "market"。
limit_pricenumber指値の場合パッケージの正味借方/貸方制限。
time_in_force"day" または "gtc"いいえデフォルトを使用する場合は省略。
account_idnumberいいえデフォルト口座を使用する場合は省略。

各レッグ:

フィールド型必須説明
type"option" または "equity"はいレッグタイプ。
action"buy" または "sell"はいレッグのサイド。
position_effect"open" または "close"オプション新規ポジションを建てるか、既存ポジションを決済するか。
occstring または nullオプションOCC文字列（下記）; 株式レッグの場合は null。
quantitynumberはい契約数（オプション）または株数（株式）。

OCCオプションシンボル形式

OCC文字列は次の形式に従います: YYMMDD + C または P + 8桁の権利行使価格（権利行使価格 × 1000、ゼロ埋め）。

説明OCC
2025年6月20日 権利行使価格250ドル コール250620C00250000
2025年6月20日 権利行使価格260ドル コール250620C00260000
2025年3月21日 権利行使価格500ドル プット250321P00500000
2025年12月19日 権利行使価格1,500ドル コール251219C01500000
2026年1月16日 権利行使価格50ドル プット260116P00050000

権利行使価格のエンコード: ドルに1,000を掛け、8桁になるようにゼロ埋めします（例: $250 → 00250000; $50.50 → 00050500）。

オプションJSONの例

単独コール — SPY 権利行使価格520ドル コール 2025年6月20日期限 1枚購入:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

ブルコールスプレッド（デビット） — 権利行使価格250ドル コール購入、権利行使価格260ドル コール売却、同じ期日:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

ベアプットスプレッド（デビット）:

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

ブルプットスプレッド（クレジット）:

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

指値付きスプレッド — 正味デビット $3.50 以下:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

ロングコールの決済 — AAPL 権利行使価格200ドル コール 2025年3月21日期限 2枚 売却決済:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

ストラドル — 権利行使価格250ドル コールと権利行使価格250ドル プットのロング、同じ期日:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

自然言語の例: "AAPL 300ドル コール 来月期限 1枚買って" · "MSFT 500ドル ストライクのカバードコール" · "TSLA コールスプレッド: 475ドル買い / 485ドル売り、来週" · "SPY 今週金曜のATMストラドル" · "AMZN プット 2枚、指値 3.50ドル" · "AMZN260130P00200000 売って"

execute_trade

ユーザーがレビューした後、ドラフトを証券会社に送信します。

  • パラメータ: trade_id (数値) — create_trade または create_options_trade からのドラフトの id。
  • 戻り値: 更新された取引; ステータス "placed" または "failed" (エラー詳細付き)。

呼び出すのは、ユーザーが明確に確認した場合のみです（例: 実行して、確認して、発注して、どうぞ）。ユーザーがレビューしたものと一致する取引を確認してください。

ドラフト作成直後に自動的に呼び出したり、注文詳細を表示せずに呼び出したり、ステータスが "draft" でない場合に呼び出したりしないでください。

取引ステータスリファレンス

ステータス意味
draft作成済み; まだ証券会社に送信されていません
pending送信済み; 証券会社の確認待ち
placed受付済み; 約定待ち
partially_filled一部約定
complete全約定
canceled取消済み
failed拒否 — エラーを確認してください
disconnected証券会社接続の問題

証券会社ID（APIヘルパー）

証券会社IDオプション
Robinhood1可
E*TRADE2可
Coinbase3暗号資産のみ
Kraken5暗号資産のみ
Charles Schwab7可
Webull8可
Public11可
Tastytrade12可

明確化: 注文タイプが曖昧な場合（例: 「TSLAを200ドルで買う」 — 指値 vs 逆指値）、オプションに期日/権利行使価格が欠けている場合、複数の口座が該当しどれも選択されていない場合、またはシンボルが複数の資産を意味する可能性がある場合に、必要な情報をすべて一度に尋ねてください。デフォルトが明確な場合（デフォルト数量、成行注文、メイン口座）は、冗長な質問をスキップしてください。

免責事項

  • 投資にはリスクが伴い、元本の損失の可能性も含まれます。
  • Trade Itはファイナンシャルアドバイザーではなく、投資アドバイスを提供しません。
  • オプションには substantial なリスクが伴い、すべての投資家に適しているわけではありません。
  • Trade Itは資金の引き出し、資産の移転、または資産の保管を行うことはできません。連携された証券会社を通じて取引を発注することのみが可能です。