Capital.com Public API MCP Server

官方

Capital.com MCP服务器让您的AI助手直接与交易账户对话。市场数据、持仓检查、交易预览——全部使用自然语言，无需离开您的AI工具。

GitHub

你可以用 Capital Com Public API MCP 做什么？

检查会话状态并登录 — 要求助手验证您的连接并使用 cap_session_status 和 cap_session_login 进行身份验证。
搜索并查看市场 — 使用 cap_market_search 查找如“比特币”或“黄金”等工具，然后获取详细信息、历史价格或客户情绪。
预览并执行带风险控制的交易 — 通过 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 服务器

模型上下文协议 (MCP) 服务器，用于 Capital.com 开放 API——支持通过 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
- 选择模拟账户进行测试（推荐）
- 验证您的电子邮件
启用双重认证：设置 > 安全 > 双重认证
- 生成 API 密钥前必须启用
生成 API 密钥：设置 > API 集成 > 生成新密钥
- 设置标签（例如，“MCP 服务器”）
- 设置自定义密码（这不是您的平台密码）
- 保存显示的 API 密钥（仅显示一次！）
- 注意：API 密钥具有交易能力；Capital.com 不提供只读密钥

第 2 步：安装和配置

您有两种安装选项：

选项 A：通过 MCPB 捆绑包一键安装（推荐）

该仓库提供了一个 manifest.json，它符合 MCPB (MCP 捆绑包) 规范——这是 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 工具可用？”进行验证。

有关其他命令（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（安装时勾选“添加到 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）
thesis - 您的交易理由（可选）
risk_percent - 风险占余额的百分比（默认：1.0%）

工作流程：

获取市场详情和交易规则
根据风险百分比计算持仓规模
定义止损和止盈水平
预览交易（仅验证 - 不执行）
返回 preview_id 以供潜在执行

使用示例：

“为 SILVER 创建交易提案”
“提议以 2% 风险做多 GOLD”

注意： 此提示不执行交易——它仅创建预览。

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 价格更新
持续监控提醒触发条件
条件满足时发出即时提醒
可选择继续监控或在首次提醒后停止

使用示例：

"当 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 工具。

交易执行流程

强制两步执行

所有副作用操作都使用严格的预览 → 执行流程：

预览：根据经纪商规则 + 本地风险政策验证交易
- 返回 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}` - 市场详情（动态）