FxSocket
公式ホストされたMetaTrader 4およびMT5アカウントへの読み取り専用アクセス: 残高と有効証拠金、未決済ポジションと指値注文、取引履歴、シンボル検索、リアルタイム相場とローソク足。
FxSocket MCPで何ができますか？
- アカウント概要 — キーで参照できるすべてのアカウントを一覧表示し、プラットフォーム、サーバー、接続状態、通貨ごとの残高または有効証拠金の合計を表示します。
- オープンエクスポージャー — アカウント全体のオープンポジションと未約定注文を、シンボルまたは種類で絞り込んで表示し、含み損益、スワップ、合計を表示します。
- 取引履歴レビュー — 最大366日間の期間における決済済み取引を要約し、勝率、純利益、最高・最低取引、シンボル別の内訳を含めます。
- シンボル検索 — EURUSDのような名前はブローカーによって異なるため、価格を要求する前にブローカーの正確なシンボル名を検索します。
- リアルタイム相場と仕様 — 最大20シンボルの買値、売値、スプレッドに加え、ティックバリュー、取引量制限、スワップレート、セッションなどの契約詳細を取得します。
- 価格履歴 — シンボルと時間足のOHLCローソク足を1回の呼び出しで最大500本取得し、トレンドを説明します。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.fxsocket.com/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
MetaTrader MCP サーバー
AI エージェントに MetaTrader 4 および MetaTrader 5 アカウントへの読み取りアクセスを付与します。FxSocket MCP サーバーを使うと、Claude、Cursor、VS Code、その他あらゆる Model Context Protocol クライアントが、あなたの取引に関する質問に回答できます。アカウント全体の残高と有効証拠金、現在の建玉、先月の成績、リアルタイムの気配値と価格履歴などです。これは読み取り専用です。 注文の発注、変更、決済を行えるツールはありません。
サーバー URL https://mcp.fxsocket.com/mcp
1. 読み取り専用の API キーを作成する
API Key ページで、読み取り専用のキーを作成します。このキーは fxs_ro_ で始まり、ここにあるすべてのツールを呼び出せますが、他のどのエンドポイントからも取引はできません。名前を付け、エージェントに見せるべきアカウントに限定すれば、エージェントが他のアカウントの存在を知ることはありません。完全な権限を持つ fxs_live_ キーも使用できますが、エージェントには不要です。
2. クライアントを接続する
リモートサーバー URL とヘッダーを受け付けるクライアントは直接接続できます。Claude Desktop のようにローカルサーバーしか起動できないクライアントは、Docker イメージを使用します。
claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
--header "X-API-Key: fxs_ro_xxx"
{
"mcpServers": {
"fxsocket": {
"url": "https://mcp.fxsocket.com/mcp",
"headers": { "X-API-Key": "fxs_ro_xxx" }
}
}
}
{
"servers": {
"fxsocket": {
"type": "http",
"url": "https://mcp.fxsocket.com/mcp",
"headers": { "X-API-Key": "fxs_ro_xxx" }
}
}
}
{
"mcpServers": {
"fxsocket": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
"env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
}
}
}
その他のクライアントも同様です。https://mcp.fxsocket.com/mcp を指定し、キーを X-API-Key ヘッダーに入れる（Authorization: Bearer も使用可能）か、Docker イメージをローカルサーバーとして実行してください。
ツール
8 つのツールはすべて読み取り専用です。各ツールはエンドポイントではなく問いに対応する形で設計されているため、「自分のアカウント全体で何が建っているか」は、すべてのターミナルを一度に読み取る 1 回の呼び出しで済みます。
list_accounts: キーが参照できるすべてのアカウントについて、id、ニックネーム、プラットフォーム、サーバー、ログイン、接続状態を返します。オプションで残高、有効証拠金、通貨ごとの合計も含みます。エージェントは最初にこれを呼び出します。get_account: 1 つのアカウントの詳細全体：残高、有効証拠金、証拠金、証拠金維持率、レバレッジ、ストップアウトレベルなどのアカウント設定、ターミナルの状態。get_open_positions: アカウント全体の建玉と未約定注文。シンボルと種類でフィルタリングでき、含み損益、スワップ、通貨ごとの合計を含みます。get_trade_history: 指定期間（デフォルトは直近 7 日間、最大 366 日）の決済済み取引。勝ち数、負け数、勝率、純利益、最高・最悪の取引、シンボル別の内訳を含みます。search_symbols: ブローカーの正確なシンボル名。EURUSD はブローカーによって EURUSD.sd や EURUSDm になるため、エージェントは価格を問い合わせる前にこれを確認します。get_quotes: 最大 20 シンボルのリアルタイムの Bid、Ask、スプレッド。get_symbol_info: 契約仕様：桁数、契約サイズ、ティックバリュー、数量制限、スワップレート、手数料、取引セッション。get_price_history: シンボルと時間足ごとの OHLC ローソク足。1 回の呼び出しで最大 500 本。
質問の例
- 「全アカウントの合計有効証拠金を通貨ごとに教えて」
- 「現在含み損になっている建玉はどれで、いくら損失が出ている？」
- 「先月の XAUUSD の勝率と、最悪の取引は？」
- 「各ブローカーの EURUSD スプレッドを比較して」
- 「GBPUSD の直近 200 本の H1 ローソク足を取得してトレンドを説明して」
設計上読み取り専用
このサーバーが取引できないのは、設定によるものではなく、コードが到達できる範囲によるものです。すべてのツールはターミナルから読み取るだけで、注文を送信できるものはありません。そのため、混乱したり操作されたりしたエージェントでも、ポジションの開設、変更、決済はできません。
金額は各アカウントの預金通貨で報告され、通貨をまたいで合算されることはありません。ツールは通貨ごとの合計を返すため、モデルがその計算を行う必要はありません。時刻は API の他の部分と同様、ブローカーのサーバー時刻です。
制限：ユーザーあたり 1 分間に 60 リクエスト、最大 50 アカウント、1 回の応答で最大 300 件の注文または取引行。件数と合計は常に全体を対象とし、切り詰められるのは行リストのみです。
Docker でローカル実行する
fxsocket/mcp イメージは、サーバーを自分で起動するクライアント向けに、ローカルの stdio プロセスとしてサーバーを実行します。依存関係のない 1 つの Python ファイルによる小さなリレーで、各メッセージをあなたのキーとともに mcp.fxsocket.com に転送します。ツールとデータは引き続き FxSocket から提供されるため、ツールが変更されてもイメージの更新は不要です。amd64 と arm64 向けに公開されています。
FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp
Docker Hub · GitHub のソース (MIT)
プロトコルの詳細
- トランスポート: Streamable HTTP、POST のみ、JSON レスポンス。ステートレスで、維持すべきセッションはありません。
- プロトコルバージョン: 2026-07-28（リクエストごとのメタデータ、ハンドシェイクなし）および 2025-03-26 から 2025-11-25（
initializeハンドシェイク）。 - 認証: プラットフォーム APIと同じ API キーを、
X-API-KeyまたはAuthorization: Bearerで使用します。 - 未対応: claude.ai と ChatGPT の Web コネクター。これらはヘッダーではなく OAuth でサインインします。Claude Desktop は現在、Docker イメージ経由で動作します。