Capital.com Public API MCP Server

公式

Capital.com MCP Serverを使用すると、AIアシスタントが取引アカウントと直接対話できます。マーケットデータ、ポジション確認、トレードプレビューなど、すべてを平易な言葉で、AIツールから離れることなく実行できます。

GitHub

Capital Com Public API MCPで何ができますか？

セッション状態の確認とログイン — アシスタントに接続確認と認証を依頼し、cap_session_status と cap_session_login を使用します。
市場の検索と調査 — cap_market_search で「Bitcoin」や「GOLD」などの銘柄を検索し、詳細、過去の価格、またはクライアントのセンチメントを取得します。
リスク管理を伴う取引のプレビューと実行 — cap_trade_preview_position でポジションをプレビューし、正規化されたサイズとチェック内容を確認した後、cap_trade_execute_position で実行します（confirm=true が必要）。
ポジションと注文状況の監視 — cap_trade_positions_list でオープンポジションを一覧表示し、注文状況を確認し、必要に応じてクローズまたはキャンセルします。
ウォッチリストの管理 — cap_watchlists_create、cap_watchlists_add_market、および関連ツールを使用してウォッチリストを作成、表示、更新します。
リアルタイム価格とポートフォリオ損益のストリーミング — cap_stream_prices でリアルタイム価格更新に購読するか、cap_stream_portfolio（WebSocket）でポートフォリオ損益を追跡します。

ドキュメント

Capital.com MCP サーバー

Capital.com Open API 用の Model Context Protocol (MCP) サーバー - LLM による Capital.com 取引アカウントへのアクセスを可能にします。

⚠️ 重要なお知らせ

Capital.com パブリック API および AI や LLM ベースのツールを含む、お客様が接続するサードパーティ製ツールのご利用は、お客様自身の判断とリスクにおいて行っていただくものです。Capital.com は執行専用で運営されており、いかなるサードパーティ製ソフトウェア、その出力、または結果についても、管理、推奨、または責任を負うものではありません。このページのいかなる内容も、投資アドバイスや取引の推奨を構成するものではありません。お客様は、すべての取引決定、設定、およびアカウント上の自動化された活動について単独で責任を負い、その利用が Capital.com の利用規約、電子取引条件、およびお客様の管轄区域で適用されるすべての法律に準拠していることを確認する必要があります。

暗号資産デリバティブは、Capital Com (UK) Ltd に登録されたリテールクライアントはご利用いただけません。

ライブ取引を検討する前に、必ずデモ口座から始めてください
取引はデフォルトで無効になっており、明示的な設定が必要です
すべての取引操作には2 段階の実行 (プレビュー → 確認 → 実行) が必要です
組み込みのリスク管理: 許可リスト、サイズ制限、1 日あたりの注文上限
自己責任でご利用ください - 作者は取引損失について一切の責任を負いません

さらなる質問/説明については、FAQ を参照してください: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

クイックスタートガイド

ステップ 1: Capital.com API 認証情報を取得する

アカウントを作成: capital.com/trading/signup にアクセス
- テストにはデモ口座を選択 (推奨)
- メールアドレスを確認
2FA を有効化: 設定 > セキュリティ > 二要素認証
- API キーを生成する前に必要です
API キーを生成: 設定 > API 統合 > 新しいキーを生成
- ラベルを設定 (例: "MCP Server")
- カスタムパスワードを設定 (これはプラットフォームのパスワードではありません)
- 表示された API キーを保存 (一度しか表示されません!)
- 注意: API キーは取引可能です。Capital.com は読み取り専用キーを提供していません

ステップ 2: インストールと設定

2 つのインストールオプションがあります:

オプション A: MCPB バンドル経由のワンクリックインストール (推奨)

リポジトリには、ローカル MCP サーバーをパッケージ化するための Anthropic のオープンスタンダードである MCPB (MCP Bundle) 仕様に準拠した manifest.json が同梱されています。これにより、設定ファイルを手動で編集することなく、Claude Desktop (およびその他の MCPB 互換クライアント) にサーバーをインストールできます。

前提条件: uv (サーバーはランタイムとして uv を使用します — brew install uv でインストールするか、uv ドキュメントを参照してください)。

手順:

リポジトリをクローンし、.mcpb バンドルをビルドします (Node.js が npx に必要です):

git clone https://github.com/capital-com-sv/capital-mcp.git
cd capital-mcp
npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

Claude Desktop で capital-mcp.mcpb を開きます (ダブルクリックするか、アプリにドラッグします)。
Claude Desktop はユーザー設定値 (API キー、識別子、パスワード、取引管理) の入力を求めます。それらを入力し、[インストール] をクリックします。
Claude Desktop を再起動し、「利用可能な Capital.com ツールは何ですか?」と尋ねて確認します。

追加のコマンド (validate、info、unpack、sign) については、MCPB CLI リファレンスを参照してください。

オプション B: スクリプトによる手動インストール

前提条件: Python 3.10 以降および Git がインストールされている必要があります。

macOS: brew install python3 git
Ubuntu/Debian: sudo apt install python3 python3-venv git
Windows: python.org (インストール時に "Add to PATH" をチェック) + git-scm.com

Mac/Linux:

cd /path/to/capital-mcp
./install.sh

Windows (PowerShell):

cd C:\path\to\capital-mcp
pwsh install.ps1

インストールスクリプトは仮想環境を作成し、依存関係をインストールし、MCP クライアント設定を表示します。

認証情報を使用して .env を編集します:

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Trading controls (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

ステップ 3: サーバーをローカルでテストする

Mac/Linux:

source venv/bin/activate
python -m capital_mcp.server

Windows (PowerShell):

.\venv\Scripts\Activate.ps1
python -m capital_mcp.server

次のように表示されるはずです:

INFO - Starting Capital.com MCP Server (env: demo)
INFO - Trading enabled: False

Ctrl+C を押して停止します。

トラブルシューティング: ログを確認する

Claude Desktop または他のクライアントで MCP サーバーを使用する際に問題が発生した場合は、ログファイルを確認してください:

macOS:

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux:

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

Windows:

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

統合

注意: /path/to/capital-mcp/venv/bin/python を実際の venv Python パスに置き換えてください。インストールスクリプトがこれを表示します。Windows では、C:\path\to\capital-mcp\venv\Scripts\python.exe を使用してください。

Claude Desktop

💡 ヒント: MCPB バンドル (上記のオプション A) 経由でインストールした場合は、このセクションをスキップしてください — Claude Desktop は manifest.json に基づいて設定を自動的に書き込みます。このセクションは手動スクリプトインストールの場合にのみ使用してください。

macOS/Linux

設定場所: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または ~/.config/Claude/claude_desktop_config.json (Linux)

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password",
        "CAP_ALLOW_TRADING": "false",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Claude Desktop を再起動します。「利用可能な Capital.com ツールは何ですか?」と入力して確認します。

Windows

設定場所: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "capital-com": {
      "command": "C:\\path\\to\\capital-mcp\\venv\\Scripts\\python.exe",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password",
        "CAP_ALLOW_TRADING": "false",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Cursor IDE

設定 (Cmd+, / Ctrl+,) > 拡張機能 > MCP > 設定を開きます。追加:

{
  "capital-com": {
    "command": "/path/to/capital-mcp/venv/bin/python",
    "args": ["-m", "capital_mcp.server"],
    "env": {
      "CAP_ENV": "demo",
      "CAP_API_KEY": "your_api_key_here",
      "CAP_IDENTIFIER": "your_email@example.com",
      "CAP_API_PASSWORD": "your_custom_password",
      "CAP_ALLOW_TRADING": "false"
    }
  }
}

Cursor を再起動します。

Codex

設定 > MCP サーバー > サーバーを追加。上記と同じコマンド、引数、環境変数を使用します。

Windsurf

~/.windsurf/mcp/servers.json を作成/編集します:

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password"
      }
    }
  }
}

Windsurf を再起動します。

カスタム MCP クライアント

STDIO 対応の MCP クライアントであれば動作します。Node.js での例:

import { spawn } from 'child_process';

const server = spawn('/path/to/venv/bin/python', ['-m', 'capital_mcp.server'], {
  env: {
    ...process.env,
    CAP_ENV: 'demo',
    CAP_API_KEY: 'your_key',
    CAP_IDENTIFIER: 'your_email',
    CAP_API_PASSWORD: 'your_password',
    CAP_ALLOW_TRADING: 'false'
  }
});

// Communicate via STDIO (JSON-RPC)
// Read from server.stdout, write to server.stdin

使用例

Claude Desktop との会話例

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

取引実行ワークフロー (取引が有効な場合)

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

環境変数リファレンス

必須

CAP_ENV - 環境: demo または live (デフォルト: demo)
CAP_API_KEY - Capital.com からの API キー
CAP_IDENTIFIER - ログインメールアドレス
CAP_API_PASSWORD - API キーのカスタムパスワード

リスク管理 (推奨)

CAP_ALLOW_TRADING - 取引を有効にする (デフォルト: false)
CAP_ALLOWED_EPICS - カンマ区切りの許可リスト (例: "SILVER,GOLD,BTCUSD") または制限なしの場合は "ALL"
CAP_MAX_POSITION_SIZE - 最大ポジションサイズ (デフォルト: 1.0)
CAP_MAX_WORKING_ORDER_SIZE - 最大注文サイズ (デフォルト: 1.0)
CAP_MAX_OPEN_POSITIONS - 最大同時ポジション数 (デフォルト: 3)
CAP_MAX_ORDERS_PER_DAY - 1 日あたりの注文制限 (デフォルト: 20)
CAP_REQUIRE_EXPLICIT_CONFIRM - confirm=true を要求 (デフォルト: true)
CAP_DRY_RUN - すべての取引実行をブロック (デフォルト: false)

オプション

CAP_DEFAULT_ACCOUNT_ID - ログイン後のデフォルトアカウント
CAP_HTTP_TIMEOUT_S - HTTP タイムアウト (デフォルト: 15)
CAP_LOG_LEVEL - ログレベル: DEBUG, INFO, WARNING, ERROR (デフォルト: INFO)

MCP ツール (36 実装済み)

セッション (4)

cap_session_status - セッション情報を取得
cap_session_login - セッションを作成
cap_session_ping - キープアライブ
cap_session_logout - セッションを終了

マーケットデータ (6)

cap_market_search - マーケットを検索
cap_market_get - マーケット詳細を取得
cap_market_prices - 過去の価格
cap_market_sentiment - クライアントセンチメント
cap_market_navigation_root - マーケットカテゴリルート
cap_market_navigation_node - マーケットカテゴリノード

アカウント (6)

cap_account_list - アカウント一覧
cap_account_preferences_get - 設定を取得
cap_account_preferences_set - 設定を更新
cap_account_history_activity - アクティビティ履歴
cap_account_history_transactions - 取引履歴
cap_account_demo_topup - デモ口座に資金を追加

取引 (11)

読み取り専用:
- cap_trade_positions_list - ポジション一覧
- cap_trade_positions_get - ポジション詳細を取得
- cap_trade_orders_list - 未約定注文一覧
- cap_trade_confirm_get - 確認ステータスを取得
- cap_trade_confirm_wait - 確認を待機
プレビュー:
- cap_trade_preview_position - ポジションをプレビュー
- cap_trade_preview_working_order - 注文をプレビュー
実行:
- cap_trade_execute_position - ポジションを実行
- cap_trade_execute_working_order - 注文を実行
- cap_trade_positions_close - ポジションを決済
- cap_trade_orders_cancel - 注文をキャンセル

ウォッチリスト (6)

cap_watchlists_list - ウォッチリスト一覧
cap_watchlists_create - ウォッチリストを作成
cap_watchlists_get - ウォッチリストを取得
cap_watchlists_add_market - マーケットを追加
cap_watchlists_delete - ウォッチリストを削除
cap_watchlists_remove_market - マーケットを削除

ストリーミング (3)

cap_stream_prices - リアルタイム価格をストリーミング (WebSocket)
cap_stream_alerts - 価格レベルアラートをストリーミング (WebSocket)
cap_stream_portfolio - ライブポートフォリオ P&L をストリーミング (WebSocket)

MCP プロンプト (ワークフローテンプレート)

MCP プロンプトは、複雑な複数ステップの取引操作を通じて Claude をガイドする構造化されたワークフローです。一般的なタスクのステップバイステップの指示とベストプラクティスを提供します。

利用可能なプロンプト (7)

1. `market_scan` - マーケット分析ワークフロー

ウォッチリストをスキャンして取引条件を確認する方法をガイドします。

パラメーター:

watchlist_id - スキャンするウォッチリスト (最初にウォッチリストを一覧表示する場合は空のままにします)
timeframe - 価格の解像度: MINUTE, MINUTE_5, HOUR, DAY (デフォルト: HOUR)
lookback_periods - 取得するローソク足の数: 1-1000 (デフォルト: 24)

ワークフロー:

ウォッチリストのマーケットを取得
各マーケットの価格データを取得
テクニカル分析 (トレンド、サポート/レジスタンス、パターン)
オプションのセンチメントチェック
機会サマリーを生成

使用例:

"market_scan プロンプトを使用してウォッチリストを分析してください"
"取引セットアップのためにマーケットをスキャンしてください"

実際の取引: 設定を次のように変更します: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. `trade_proposal` - 取引計画ワークフロー

リスク管理ツールを使用して取引提案を作成する方法をガイドします。

パラメーター:

epic - 取引するマーケット (必須、例: SILVER, GOLD)
direction - BUY または SELL (デフォルト: BUY)
thesis - 取引の理由 (オプション)
risk_percent - 残高に対するリスクの割合 (デフォルト: 1.0%)

ワークフロー:

マーケット詳細と取引ルールを取得
リスク% に基づいてポジションサイズを計算
ストップロスとテイクプロフィットのレベルを定義
取引をプレビュー (検証のみ - 実行はしません)
潜在的な実行のための preview_id を返します

使用例:

"SILVER の取引提案を作成してください"
"2% のリスクで GOLD のロング取引を提案してください"

注意: このプロンプトは取引を実行しません - プレビューのみを作成します。

3. `execute_trade` - 取引実行ワークフロー

プレビューされた取引を実行する方法をガイドします。

パラメーター:

preview_id - trade_proposal からのプレビュー ID (必須)

ワークフロー:

preview_id が提供され、有効であることを確認
すべてのリスク管理を再チェック
ブローカーでポジションを実行
確認をポーリング (ACCEPTED/REJECTED)
最終ステータスを報告

使用例:

"プレビューした取引を実行してください"
"プレビュー ID abc-123 の取引を発注してください"

注意:

CAP_ALLOW_TRADING=true が必要です
epic が許可リストに含まれている必要があります
プレビューは期限切れであってはなりません (2 分間の TTL)
⚠️ これは実際の取引を発注します

4. `position_review` - ポートフォリオ分析ワークフロー

オープンポジションと注文を分析する方法をガイドします。

パラメーター: なし (現在のすべてのポジションを分析します)

ワークフロー:

すべてのオープンポジションを取得
すべての未約定注文を取得
P&L、リスク、エクスポージャー指標を計算
集中リスクと相関リスクを特定
潜在的な調整を提案 (実行はしません)

使用例:

"現在のポジションを確認してください"
"ポートフォリオのエクスポージャーを分析してください"

注意: これは読み取り専用のワークフローです - 取引は実行されません。

5. `live_price_monitor` - リアルタイム価格追跡 (WebSocket)

価格がしきい値を超えて動いた場合に即座にアラートを発するライブマーケット価格を監視します。

パラメーター:

epics - 監視するマーケット EPIC のリスト (検索/選択する場合は空のまま、最大 40)
duration_minutes - 監視する期間 (デフォルト: 5 分、最大: 10 分)
threshold_percent - 価格がこの % を超えて動いた場合にアラート (デフォルト: 1.0%)

ワークフロー:

監視するマーケットを選択 (または EPIC を直接提供)
ベースラインを確立するために初期価格を取得
リアルタイム WebSocket 価格更新をサブスクライブ
継続的な更新を含むライブ価格ボードを表示
いずれかのマーケットが threshold_percent を超えて動いた場合にアラート
duration_minutes 後に自動停止

使用例:

"GOLD と SILVER の価格を 2 分間監視してください"
"BTC を次の 5 分間監視し、2% の動きでアラートを出してください" 注意: CAP_WS_ENABLED=true が必要です。Capital.com WebSocket セッションの最大持続時間は 10 分です。

6. `real_time_alerts` - 条件付き価格アラート (WebSocket)

価格レベルアラートを設定し、市場が目標に達したときに即座に通知を受け取ります。

パラメータ:

alert_config - EPIC ごとのアラートレベル (例: {"GOLD": 2050.0, "SILVER": 28.5})
duration_minutes - 最大監視時間 (デフォルト: 5 分)
auto_stop - 最初のアラート後に監視を停止するか? (デフォルト: true)

ワークフロー:

アラート条件 (各市場の価格レベル) を設定する
WebSocket 価格更新をサブスクライブする
アラートトリガーを継続的に監視する
条件が満たされたときに即座にアラートを発行する
オプションで監視を継続するか、最初のアラート後に停止する

使用例:

「GOLD が 2050 に達したらアラート」
「SILVER が 28 を下回ったら通知」

注意: CAP_WS_ENABLED=true が必要です。

7. `live_portfolio_monitor` - リアルタイム損益トラッキング (WebSocket)

市場価格の変動に伴い、ポートフォリオの損益がリアルタイムで更新されるのを監視します。

パラメータ:

duration_minutes - 監視時間 (デフォルト: 5 分、最大: 10 分)
alert_pnl_threshold - 合計損益がこの金額を超えた場合にアラート (デフォルト: $100)

ワークフロー:

現在のオープンポジションを取得する
ポジション市場の価格更新をサブスクライブする
価格変動に応じてリアルタイム損益を計算する
リアルタイムのポートフォリオダッシュボードを表示する
損益がしきい値を超えた場合にアラートを出す

使用例:

「ポートフォリオの損益を 5 分間監視して」
「ポジションをリアルタイムで監視し、損益が $500 になったらアラート」

注意: CAP_WS_ENABLED=true とアクティブなポジションが必要です。

プロンプトの使用方法

Claude Desktop やその他の MCP クライアントでは、プロンプトは利用可能なインタラクションパターンとして表示されます。会話の中で自然に呼び出すことができます:

User: "I want to scan my watchlist for opportunities"
Claude: [Invokes market_scan prompt, guides through the workflow]

User: "Create a trade plan for SILVER"
Claude: [Invokes trade_proposal prompt, designs trade with risk management]

User: "Execute that trade"
Claude: [Invokes execute_trade prompt, submits to broker]

User: "Show me my open positions"
Claude: [Invokes position_review prompt, analyzes portfolio]

プロンプトは、ワークフロー全体を通じて取引コントロールを維持しながら、構造化されたガイダンスを提供します。

MCP リソース (読み取り専用データ)

MCP リソースは、URI ベースのリソースを通じてサーバーの状態と設定への読み取り専用アクセスを提供します。ツール (アクションを実行する) とは異なり、リソースはクライアントが読み取りおよび監視できるデータを公開します。

利用可能なリソース

1. `cap://status` - サーバーステータス

リアルタイムのサーバーおよびセッション情報。

戻り値: サーバーの正常性、セッション状態、認証ステータス、レート制限を含む JSON

例:

{
  "server": {
    "name": "Capital.com MCP Server",
    "version": "0.1.0",
    "trading_enabled": true
  },
  "session": {
    "logged_in": true,
    "account_id": "ABC123",
    "last_used_at": "2026-01-16T10:30:00Z",
    "expires_in_s_estimate": 522
  },
  "risk": {
    "trading_enabled": true,
    "allowed_epics": ["GOLD", "SILVER"],
    "allowlist_mode": "SPECIFIC"
  },
  "rate_limits": {
    "requests_per_second": "10",
    "note": "Capital.com enforces 10 req/s limit"
  }
}

ユースケース: サーバーの正常性の監視、セッションステータスの確認、認証問題のデバッグ

2. `cap://risk-policy` - リスクポリシー

包括的なリスク管理設定と取引コントロール。

戻り値: すべての検証レイヤー、取引コントロール機能、取引制限を含む JSON

例:

{
  "trading_enabled": true,
  "two_phase_execution": true,
  "description": "All trades require preview → explicit execution",
  "allowlist": {
    "mode": "SPECIFIC",
    "epics": ["GOLD", "SILVER"],
    "note": "Only markets on this list can be traded (ALL = wildcard)"
  },
  "validation_layers": [
    "1. Trading enabled check (TRADING_ENABLED env var)",
    "2. Epic allowlist check (must be in ALLOWED_EPICS)",
    "... 10 total layers ..."
  ],
  "execution_controls": {
    "preview_required": true,
    "deal_reference_matching": true,
    "authentication_required": true,
    "rate_limiting": true,
    "input_validation": true
  }
}

ユースケース: アクティブな取引コントロールの理解、リスク設定の監査、コンプライアンス文書

3. `cap://allowed-epics` - 取引許可リスト

許可された市場を示す現在の取引許可リスト設定。

戻り値: 許可リストモード、許可された EPIC、設定手順を含む JSON

例:

{
  "mode": "SPECIFIC",
  "allowed_epics": ["GOLD", "SILVER", "BTCUSD"],
  "count": 3,
  "trading_enabled": true,
  "description": "Restricted mode: 3 specific markets allowed",
  "configuration": {
    "env_var": "ALLOWED_EPICS",
    "example": "ALLOWED_EPICS=GOLD,SILVER,BTCUSD",
    "wildcard": "ALLOWED_EPICS=ALL (allows all markets)"
  }
}

ユースケース: 取引可能な市場の確認、許可リスト設定の検証

4. `cap://market-cache/{epic}` - 市場詳細 (動的)

特定の EPIC のキャッシュされた市場詳細 (ブローカーからのライブ取得)。

パラメータ:

epic - 市場識別子 (例: "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

戻り値: 包括的な市場情報を含む JSON

認証: 必須

例: cap://market-cache/GOLD

{
  "epic": "GOLD",
  "instrument_name": "Spot Gold",
  "instrument_type": "COMMODITIES",
  "currency": "USD",
  "snapshot": {
    "market_status": "TRADEABLE",
    "bid": 2050.50,
    "offer": 2050.75,
    "update_time": "2026-01-16T10:30:00"
  },
  "dealing": {
    "min_size": 0.1,
    "max_size": 100.0,
    "min_step": 0.1,
    "min_stop_distance": 5.0
  },
  "margin": {
    "factor": 5.0,
    "unit": "PERCENTAGE"
  },
  "opening_hours": {...},
  "cached_at": "2026-01-16T10:30:00"
}

ユースケース: 市場詳細の取得、取引ルールの確認、証拠金要件の分析

リソースの使用方法

Claude Desktop やその他の MCP クライアントでは、URI によってリソースにアクセスできます:

User: "Show me the server status"
Claude: [Reads cap://status resource, displays server health]

User: "What's the risk policy?"
Claude: [Reads cap://risk-policy resource, explains trading controls]

User: "Which markets can I trade?"
Claude: [Reads cap://allowed-epics resource, lists permitted epics]

User: "Show all my watchlists"
Claude: [Calls cap_watchlists_list tool, displays watchlist data]

User: "Get details for GOLD market"
Claude: [Reads cap://market-cache/GOLD resource, shows market info]

リソースは、ツールを実行せずにサーバーの状態と設定を検査する便利な方法を提供します。ウォッチリストデータについては、cap_watchlists_list および cap_watchlists_get ツールを使用してください。

取引実行プロセス

必須の 2 ステップ実行

すべての副作用操作は、厳密なプレビュー → 実行フローを使用します:

プレビュー: ブローカールール + ローカルリスクポリシーに対して取引を検証します
- 正規化されたリクエスト + リスクチェックを含む preview_id を返します
- 副作用なし、読み取り専用の検証
実行: preview_id を使用して取引を送信します
- 重要なチェックを再実行します
- CAP_REQUIRE_EXPLICIT_CONFIRM=true の場合、confirm=true が必要です
- ブローカーの確認をポーリングします
- 日次注文カウンターを増分します

リスクコントロール

許可リスト: CAP_ALLOWED_EPICS 内の EPIC のみ取引可能
サイズ制限: 最大ポジション/注文サイズが適用されます
ポジション制限: 常時最大オープンポジション数
日次制限: 1 日あたりの最大注文数
サイズ正規化: ブローカーの最小/最大/増分に丸めます
ドライランモード: 有効な場合、すべての実行をブロックします

ドキュメント

使用ガイド: USAGE.md - 例を含む包括的な使用ガイド
Capital.com API リファレンス: https://open-api.capital.com/
Capital.com API Postman コレクション: https://github.com/capital-com-sv/capital-api-postman

ライセンス

MIT

免責事項 – Capital.com パブリック API のサードパーティツールでの使用

サードパーティ統合

このページでは、クライアントが Capital.com パブリック API を、人工知能や大規模言語モデル (「LLM」) を利用したものを含むサードパーティのソフトウェア、ツール、または統合に接続する方法について説明します。かかるサードパーティのソフトウェア、ツール、または統合は Capital.com から独立しており、Capital.com のサービスの一部を構成するものではありません。Capital.com は、サードパーティのソフトウェア、その機能、出力、またはその使用から生じる結果について、管理、開発、推奨、または一切の責任を負いません。Capital.com パブリック API に関連するサードパーティツールまたは統合の使用は、完全に自己責任で行ってください。使用を選択するサードパーティツールの利用規約、プライバシーポリシー、およびデータ処理慣行を確認する責任はお客様にあります。

パブリック API の使用

Capital.com パブリック API の使用は、完全にお客様の裁量とリスクにおいて行われます。Capital.com は、情報提供および取引目的でパブリック API を利用可能にしていますが、特定の使用、統合、または取引戦略を推奨、是認、または推奨するものではありません。API へのアクセス方法と使用方法 (送信される注文のパラメータ、接続されたツールまたはシステムの設定、受信したデータの解釈を含む) については、お客様が単独で責任を負います。Capital.com は、API を直接またはサードパーティツールを通じて使用することから生じる損失または意図しない結果について、一切の責任を負いません。API の可用性、機能、および仕様は、予告なくいつでも変更、レート制限、一時停止、または中止される場合があります。パブリック API の使用には、Capital.com の利用規約および電子取引条件が適用されます。API を使用する前に、これらを注意深くお読みください。

執行専用サービスおよび投資助言の非提供 Capital.com は、執行専用ベースでサービスを提供します。金融商品の取引には、重大な損失リスクが伴います。このページ、パブリック API、またはサードパーティのソフトウェアや統合におけるいかなる内容も、投資助言、個人的な推奨、または金融商品の売買の勧誘を構成するものではありません。これには、AI、LLM ベース、またはその他の自動化ツールによって生成された出力、シグナル、提案、または分析が含まれます。自動化またはアルゴリズム活動を含むすべての取引決定は、自己責任で行われ、お客様の単独の責任となります。自動化およびアルゴリズム取引のリスクパブリック API を自動化またはアルゴリズム取引ツールに関連して使用すると、以下のリスクを含むがこれらに限定されない追加のリスクが伴います: 人間による確認や介入なしの注文の迅速な実行、システムエラー、ソフトウェア障害、または接続の問題、予想とは大幅に異なる価格での約定、およびツールやパラメータの設定ミスに起因する意図しないまたは誤った注文。Capital.com は、かかるリスクから、またはそのシステムとサードパーティツールとの相互作用から生じる損失について責任を負いません。過去のパフォーマンスおよび自動化ツールによって生成された出力は、将来の結果を示すものではありません。

禁止事項

パブリック API および接続されたツールの使用は、Capital.com プラットフォームの操作、価格やレイテンシの悪用、市場乱用への関与、または不当な利益の取得に使用してはなりません。Capital.com は、かかる誤用が発生した、または発生する可能性が高いと合理的に判断した場合、API アクセスおよび/またはお客様のアカウントを制限、一時停止、または終了する権利を留保します。お客様は、第三者がお客様のアカウントに対して裁量権を行使することを許可してはなりません。

お客様の責任

お客様は、Capital.com プラットフォーム、パブリック API、およびサードパーティツールまたは統合の使用が、Capital.com の利用規約、電子取引条件、およびお客様の管轄区域で適用されるすべての法律および規制に準拠することを保証する責任を負います。自動取引ツールを使用する前に、それがお客様の状況、経験、およびリスク許容度に適切かどうかを慎重に検討する必要があります。Capital.com は、自動化ツールまたは統合をライブ取引環境に接続する前に、デモ口座を使用して徹底的にテストすることを強くお勧めします。

Capital.com Public API MCP Server

Capital Com Public API MCPで何ができますか？

ドキュメント

Capital.com MCP サーバー

⚠️ 重要なお知らせ

クイックスタートガイド

ステップ 1: Capital.com API 認証情報を取得する

ステップ 2: インストールと設定

オプション A: MCPB バンドル経由のワンクリックインストール (推奨)

オプション B: スクリプトによる手動インストール

ステップ 3: サーバーをローカルでテストする

トラブルシューティング: ログを確認する

統合

Claude Desktop

macOS/Linux

Windows

Claude Code

Cursor IDE

Codex

Windsurf

カスタム MCP クライアント

使用例

Claude Desktop との会話例

取引実行ワークフロー (取引が有効な場合)

環境変数リファレンス

必須

リスク管理 (推奨)

オプション

MCP ツール (36 実装済み)

セッション (4)

マーケットデータ (6)

アカウント (6)

取引 (11)

ウォッチリスト (6)

ストリーミング (3)

MCP プロンプト (ワークフローテンプレート)

利用可能なプロンプト (7)

1. market_scan - マーケット分析ワークフロー

2. trade_proposal - 取引計画ワークフロー

3. execute_trade - 取引実行ワークフロー

4. position_review - ポートフォリオ分析ワークフロー

5. live_price_monitor - リアルタイム価格追跡 (WebSocket)

6. real_time_alerts - 条件付き価格アラート (WebSocket)

7. live_portfolio_monitor - リアルタイム損益トラッキング (WebSocket)

プロンプトの使用方法

MCP リソース (読み取り専用データ)

利用可能なリソース

1. cap://status - サーバーステータス

2. cap://risk-policy - リスクポリシー

3. cap://allowed-epics - 取引許可リスト

4. cap://market-cache/{epic} - 市場詳細 (動的)

リソースの使用方法

取引実行プロセス

必須の 2 ステップ実行

リスクコントロール

ドキュメント

ライセンス

免責事項 – Capital.com パブリック API のサードパーティツールでの使用

サードパーティ統合

パブリック API の使用

禁止事項

お客様の責任

1. `market_scan` - マーケット分析ワークフロー

2. `trade_proposal` - 取引計画ワークフロー

3. `execute_trade` - 取引実行ワークフロー

4. `position_review` - ポートフォリオ分析ワークフロー

5. `live_price_monitor` - リアルタイム価格追跡 (WebSocket)

6. `real_time_alerts` - 条件付き価格アラート (WebSocket)

7. `live_portfolio_monitor` - リアルタイム損益トラッキング (WebSocket)

1. `cap://status` - サーバーステータス

2. `cap://risk-policy` - リスクポリシー

3. `cap://allowed-epics` - 取引許可リスト

4. `cap://market-cache/{epic}` - 市場詳細 (動的)