Capital.com MCP Server

io.github.SimonTarara62由 GitHub 帳號 SimonTarara62 發布v0.3.4更新於 Oct 27, 2026

Unofficial community MCP for the Capital.com Open API. Guarded two-phase trades; demo-first.

發布方自己的服務:capital.new mandate draft tools

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

非官方的本機 MCP 伺服器,連接 Capital.com 交易 API,讓助理取得行情、管理自選清單並執行具防護的兩階段交易。

可以做什麼
  • 檢視工作階段與帳戶狀態、列出與切換帳戶、讀取偏好與活動及交易紀錄、為模擬帳戶加值
  • 搜尋市場、讀取市場詳情與快照、瀏覽導覽節點、取得歷史 K 線及客戶多空部位
  • 列出持倉與掛單,預覽持倉或掛單,再經確認後執行、修改、平倉或取消
  • 建立、讀取、修改與刪除自選清單及其中的市場
  • 啟用後透過 WebSocket 推送即時價格、K 線、價格警示與投資組合損益
  • 提供行情掃描、交易提案、持倉檢視與即時監控等引導式提示,以及唯讀的 search 與 fetch 轉接器
適用情境
適合讓助理研究 Capital.com 的交易商品、檢視持倉與掛單,或在明確防護下準備並執行交易,建議先在模擬帳戶試用。不適合需要官方廠商支援整合的情境。
執行需求
以 Python 套件形式在本機執行(uvx 或 pipx,stdio,也可用 HTTP 遠端架設)。需要 Capital.com 的 API key、API 密碼與帳戶識別碼,可直接提供、透過 .env 檔案路徑提供,或以指令方式讀取密鑰。交易需開啟 CAP_ALLOW_TRADING 並設定 EPIC 允許清單;串流資料需開啟 CAP_WS_ENABLED。需能連線至 Capital.com API。
安裝前請注意
非官方、僅供學習,與 Capital.com 無關聯,也不構成投資建議。CAP_API_KEY、CAP_API_PASSWORD 與 CAP_IDENTIFIER 屬於密鑰,盡量別寫進用戶端設定檔。交易預設關閉,但一旦開啟,工具可下單、改單、平倉、取消並刪除自選清單;請先用模擬密鑰,保留 CAP_DRY_RUN 與允許清單,遇到語意不明的 TIMEOUT 確認應先核對而非直接重試。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Capital.com MCP Server,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Capital.com MCP Server

Self-hosted Model Context Protocol (MCP) server for the Capital.com Open API, written in Python on FastMCP. It exposes 42 safe, guarded trading and market-data tools — two-phase execution, allowlists, demo-first — to any MCP client, over stdio or HTTP. Built on the tested capitalcom-cli broker engine (SDK).

Works with Claude Desktop · Claude Code · Cursor · VS Code (Copilot) · Windsurf · ChatGPT — any MCP client.

[PyPI version] [Python versions] [CI] [License: Apache-2.0] [MCP Registry] [Glama quality score] [PyPI downloads]

⚠️ Unofficial & educational. Not affiliated with Capital.com. Trading is risky and this is not financial advice. Trading is disabled by default; all trades are two-phase (preview → confirm → execute) with allowlists and size/rate limits. Start on a demo account. Apache-2.0 licensed.

Install

No clone required — uvx runs it in an isolated, throwaway environment and always fetches the latest tested release:

bash
uvx capitalcom-mcp --help        # smoke test

Or install a persistent command with pipx:

bash
pipx install capitalcom-mcp

Pinning for production / real-money use

uvx capitalcom-mcp always runs the latest published release. That is fine for trying it out, but for production or real-money use, pin the exact version so an unexpected update can't change tool behavior under you:

json
{  "mcpServers": {    "capitalcom": {      "command": "uvx",      "args": ["capitalcom-mcp==0.3.4"],      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }    }  }}

The CLI form is uvx capitalcom-mcp==0.3.4 run …. Pin to a version you have reviewed, and bump deliberately after reading the CHANGELOG.

1. Add your credentials (once)

Get an API key in the Capital.com app: Settings → API integrations (make a demo key first). Then run the wizard — it writes a 0600 file and prints the exact client snippet:

bash
uvx capitalcom-mcp init

This writes ~/.config/capital-mcp/.env. Verify any time (no secrets printed):

bash
uvx capitalcom-mcp doctor

Inspect the full effective configuration (redacted, offline) or confirm your credentials actually authenticate:

bash
uvx capitalcom-mcp config          # effective settings + credential sourceuvx capitalcom-mcp doctor --login  # verify authentication against the API

Prefer a secret manager? Set CAP_API_KEY_CMD / CAP_IDENTIFIER_CMD / CAP_API_PASSWORD_CMD to a command that prints the secret (e.g. op read op://vault/..., pass ...). The secret is fetched at launch and never written to disk or to your client config.

2. Add the server to your client

Every client uses the same command/args/env shape. Pasting "CAP_ENV_FILE": "<path from init>" keeps secrets out of the client file; or put CAP_API_KEY/CAP_IDENTIFIER/CAP_API_PASSWORD directly in env.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "capitalcom": {      "command": "uvx",      "args": ["capitalcom-mcp"],      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }    }  }}

Claude Code

bash
claude mcp add --transport stdio \  --env CAP_ENV_FILE=/Users/you/.config/capital-mcp/.env \  capitalcom -- uvx capitalcom-mcp

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

json
{  "mcpServers": {    "capitalcom": {      "command": "uvx",      "args": ["capitalcom-mcp"],      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }    }  }}

VS Code (Copilot)

.vscode/mcp.json — note the root key is servers and type: "stdio":

json
{  "servers": {    "capitalcom": {      "type": "stdio",      "command": "uvx",      "args": ["capitalcom-mcp"],      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }    }  }}

Windsurf

~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "capitalcom": {      "command": "uvx",      "args": ["capitalcom-mcp"],      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }    }  }}

ChatGPT

ChatGPT requires a remote server (stdio is not supported) — see Remote / VPS hosting. Once your server is reachable over HTTPS, enable Developer Mode (Settings → Connectors → Advanced) and add the server URL ending in /mcp. ChatGPT Deep Research connectors call two read-only tools, search and fetch, which this server implements; full custom tools require Developer Mode.

Remote / VPS hosting

Run with streamable-HTTP instead of stdio:

bash
CAP_ENV_FILE=/home/you/.config/capital-mcp/.env \  capitalcom-mcp run --transport http --host 0.0.0.0 --port 8000# endpoint: http://<host>:8000/mcp

Or via env (handy in systemd): CAP_MCP_TRANSPORT=http, CAP_MCP_HOST, CAP_MCP_PORT. Put it behind a TLS-terminating reverse proxy for any public use.

What's inside — tools, resources & prompts

This server exposes 42 tools, 4 resources, and 7 guided prompts. All tool names are prefixed cap_ except the two ChatGPT Deep Research adapters (search, fetch). Mutating tools require confirm=true; trades are two-phase. The full surface is a stable contract — see API stability.

Session & account

ToolWhat it does
cap_session_statusCurrent login/session state.
cap_session_loginAuthenticate (optionally force=true).
cap_session_pingKeep-alive / liveness check.
cap_session_logoutEnd the session.
cap_session_switch_accountSwitch the active trading account.
cap_account_listList accounts and the active account id.
cap_account_preferences_getRead account preferences (e.g. hedging mode).
cap_account_preferences_setUpdate preferences (confirm required).
cap_account_history_activityAccount activity history.
cap_account_history_transactionsTransaction history.
cap_account_demo_topupTop up a demo balance (confirm required).

Market data

ToolWhat it does
cap_market_searchSearch instruments by term.
cap_market_getFull market details + snapshot for an EPIC.
cap_market_navigation_rootTop-level market navigation nodes.
cap_market_navigation_nodeDrill into a navigation node.
cap_market_pricesHistorical OHLC candles.
cap_market_sentimentClient long/short positioning.

Trading (read → preview → execute → manage)

ToolWhat it does
cap_trade_positions_listOpen positions.
cap_trade_positions_getOne position by deal id.
cap_trade_orders_listWorking (pending) orders.
cap_trade_confirm_getFetch a deal confirmation by reference.
cap_trade_confirm_waitPoll until a deal confirms (or times out).
cap_trade_preview_positionPhase 1: validate a market position (no execution).
cap_trade_preview_working_orderPhase 1: validate a working order.
cap_trade_execute_positionPhase 2: execute a previewed position (confirm).
cap_trade_execute_working_orderPhase 2: place a previewed working order (confirm).
cap_trade_positions_closeClose a position (confirm).
cap_trade_orders_cancelCancel a working order (confirm).
cap_trade_positions_amendAmend stop/limit on a position (confirm).
cap_trade_orders_amendAmend a working order (confirm).

Watchlists

ToolWhat it does
cap_watchlists_listList watchlists.
cap_watchlists_getGet one watchlist's markets.
cap_watchlists_createCreate a watchlist (confirm).
cap_watchlists_add_marketAdd an EPIC (confirm).
cap_watchlists_remove_marketRemove an EPIC (confirm).
cap_watchlists_deleteDelete a watchlist (confirm).

Streaming (WebSocket; requires CAP_WS_ENABLED=true)

ToolWhat it does
cap_stream_pricesLive bid/ask updates for EPICs.
cap_stream_candlesLive OHLC candle updates.
cap_stream_alertsThreshold price alerts.
cap_stream_portfolioLive position/P&L updates.

ChatGPT Deep Research adapters

ToolWhat it does
searchRead-only instrument search (ChatGPT connector contract).
fetchRead-only instrument fetch by id (ChatGPT connector contract).

Resources

URIWhat it returns
cap://statusSession/connection status snapshot.
cap://risk-policyActive risk policy (trading flag, caps).
cap://allowed-epicsThe trading EPIC allowlist.
cap://market-cache/{epic}Cached market snapshot for an EPIC.

Guided prompts

Prompts are reusable workflows your client can launch by name. They emit step-by-step guidance that orchestrates the tools above — they never trade on their own.

PromptPurpose
market_scanScan a watchlist for opportunities (prices + sentiment).
trade_proposalDesign a risk-sized trade and validate it via preview.
execute_tradeSafely execute a previously previewed trade.
position_reviewReview open positions and working orders.
live_price_monitorStream prices and flag threshold moves.
real_time_alertsConfigure and watch live price alerts.
live_portfolio_monitorStream live portfolio P&L with a threshold.

Safety model

  • Trading off unless CAP_ALLOW_TRADING=true and the EPIC is in CAP_ALLOWED_EPICS (or ALL).
  • Two-phase execution; confirm=true required for mutations.
  • Size, open-position, and daily-order caps; CAP_DRY_RUN=true blocks all executions. A TIMEOUT confirmation is ambiguous — reconcile, don't blindly retry.

Development

bash
make install   # editable MCP + capitalcom-cli SDK from PyPImake check     # ruff + mypy + pytest (offline; no network/credentials)

End-to-end tests drive every tool through the MCP against the demo API (read, watchlists, account switch, preview/execute/amend/close/cancel, streaming). They place real demo orders and clean up after themselves, so use a demo .env with trading + streaming enabled:

bash
# demo .env: CAP_ALLOW_TRADING=true, CAP_ALLOWED_EPICS=GOLD, CAP_WS_ENABLED=trueCAP_MCP_E2E=1 pytest -m e2e -v

Contributing

Contributions are welcome — this is a community project. Start with CONTRIBUTING.md, browse good first issues, and see the roadmap for where it's heading. The architecture and a worked "add a tool" example are in docs/extending.md.

License

Apache-2.0. See LICENSE and NOTICE.

來源:README.md,提交 d16c071

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Capital 整合