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 的模型上下文協定 (MCP) 伺服器 - 讓 LLM 驅動存取您的 Capital.com 交易帳戶。

⚠️ 重要通知

您使用 Capital.com 公開 API 及任何您連接的第三方工具（包括基於 AI 或 LLM 的工具），均由您自行決定並承擔風險。Capital.com 僅以執行代理模式運作，不控制、不背書、也不對任何第三方軟體、其輸出或任何產生的結果承擔責任。本頁面任何內容均不構成投資建議或交易推薦。您對您帳戶上的所有交易決策、配置和自動化活動負全部責任，且必須確保您的使用符合 Capital.com 的條款與細則、電子交易條款以及您所在司法管轄區的所有適用法律。

加密衍生品不提供給在 Capital Com (UK) Ltd 註冊的零售客戶。

在考慮真實交易前，請務必先使用 模擬帳戶
交易預設為停用，需要明確配置才能啟用
所有交易操作都需要兩階段執行（預覽 → 確認 → 執行）
內建風險控制：允許清單、規模限制、每日訂單上限
風險自負 - 作者對交易損失不承擔任何責任

如有進一步問題/澄清，請參閱常見問題：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 伺服器"）
- 設定自訂密碼（這不是您的平台密碼）
- 儲存顯示的 API 金鑰（僅顯示一次！）
- 注意：API 金鑰具有交易能力；Capital.com 不提供唯讀金鑰

步驟 2：安裝與配置

您有兩種安裝選項：

選項 A：透過 MCPB 套件一鍵安裝（建議）

此儲存庫提供一個符合 MCPB (MCP Bundle) 規範的 manifest.json — 這是 Anthropic 為封裝本地 MCP 伺服器所制定的開放標準。這讓您無需手動編輯設定檔，即可在 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 工具？」來驗證。

請參閱 MCPB CLI 參考以獲取其他命令（validate、info、unpack、sign）。

選項 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 停止。

疑難排解：檢查日誌

如果您在使用 MCP 伺服器與 Claude Desktop 或其他客戶端時遇到問題，請檢查日誌檔案：

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 - 每日訂單限制（預設：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 - 串流即時投資組合損益 (WebSocket)

MCP 提示（工作流程範本）

MCP 提示是結構化的工作流程，引導 Claude 完成複雜的多步驟交易操作。它們為常見任務提供逐步說明和最佳實務。

可用的提示 (7)

1. `market_scan` - 市場分析工作流程

引導您掃描觀察清單以尋找交易條件。

參數：

watchlist_id - 要掃描的觀察清單（留空則先列出觀察清單）
timeframe - 價格解析度：MINUTE、MINUTE_5、HOUR、DAY（預設：HOUR）
lookback_periods - 要擷取的 K 線數量：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 建立交易提案"
"提出一個 GOLD 的多頭交易，風險 2%"

注意： 此提示不會執行交易 - 它僅建立預覽。

3. `execute_trade` - 交易執行工作流程

引導您執行已預覽的交易。

參數：

preview_id - 來自 trade_proposal 的預覽 ID（必要）

工作流程：

驗證 preview_id 已提供且有效
重新檢查所有風險控制
透過經紀商執行持倉
輪詢確認（接受/拒絕）
報告最終狀態

使用範例：

"執行我剛剛預覽的交易"
"使用預覽 ID abc-123 下單交易"

注意：

需要 CAP_ALLOW_TRADING=true
需要 epic 在允許清單中
預覽不得過期（2 分鐘 TTL）
⚠️ 這將會下達真實交易

4. `position_review` - 投資組合分析工作流程

引導您分析您的未平倉持倉和訂單。

參數： 無（分析所有當前持倉）

工作流程：

擷取所有未平倉持倉
擷取所有待處理訂單
計算損益、風險和曝險指標
識別集中度和相關性風險
建議潛在調整（不執行）

使用範例：

"檢視我目前的持倉"
"分析我的投資組合曝險"

注意： 這是一個唯讀工作流程 - 不會執行任何交易。

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 價格更新
持續監控警示觸發條件
條件滿足時發出即時警示
可選擇在首次警示後繼續監控或停止

使用範例：

「當黃金達到 2050 時提醒我」
「當白銀跌破 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 工具。

交易執行流程

強制性兩步驟執行

所有具有副作用的操作都使用嚴格的預覽 → 執行流程：

預覽：根據經紀商規則 + 本地風險政策驗證交易
- 回傳 preview_id，包含正規化請求 + 風險檢查
- 無副作用，唯讀驗證
執行：使用 preview_id 提交交易
- 重新執行關鍵檢查
- 如果 CAP_REQUIRE_EXPLICIT_CONFIRM=true，則需要 confirm=true
- 輪詢經紀商確認
- 增加每日訂單計數器

風險控制

允許清單：只有在 CAP_ALLOWED_EPICS 中的 EPIC 才能交易
規模限制：強制執行最大持倉/訂單規模
持倉限制：任何時候的最大持倉數量
每日限制：每日最大訂單數
規模正規化：四捨五入至經紀商的最小/最大/增量
試運行模式：啟用時阻止所有執行

文件

使用指南：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} - 市場詳情（動態）

如何使用資源

交易執行流程

強制性兩步驟執行

風險控制

文件

授權

免責聲明 – 將 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}` - 市場詳情（動態）