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로 "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 Public API 및 여기에 연결하는 AI 또는 LLM 기반 도구를 포함한 모든 타사 도구의 사용은 전적으로 귀하의 재량과 위험 부담 하에 이루어집니다. Capital.com은 실행 전용 기준으로 운영되며, 어떠한 타사 소프트웨어, 그 결과물 또는 그로 인한 결과에 대해 통제하거나, 보증하거나, 책임을 지지 않습니다. 이 페이지의 어떤 내용도 투자 조언이나 거래 권유를 구성하지 않습니다. 귀하는 모든 거래 결정, 구성 및 계정의 자동화된 활동에 대해 전적으로 책임을 지며, 귀하의 사용이 Capital.com의 이용 약관, 전자 거래 약관 및 해당 관할권의 모든 관련 법률을 준수하도록 해야 합니다.

암호화폐 파생상품은 Capital Com (UK) Ltd에 등록된 소매 고객에게 제공되지 않습니다.

실제 거래를 고려하기 전에 항상 데모 계정으로 시작하십시오.
거래는 기본적으로 비활성화되어 있으며 명시적인 구성이 필요합니다.
모든 거래 작업에는 2단계 실행(미리보기 → 확인 → 실행)이 필요합니다.
내장된 위험 관리: 허용 목록, 규모 제한, 일일 주문 한도
사용에 따른 위험은 본인이 부담합니다 - 작성자는 거래 손실에 대해 어떠한 책임도 지지 않습니다.

추가 질문/설명이 필요하면 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으로 이동
- 테스트를 위해 데모 계정 선택(권장)
- 이메일 인증
2단계 인증 활성화: 설정 > 보안 > 2단계 인증
- API 키 생성 전에 필요합니다.
API 키 생성: 설정 > API 통합 > 새 키 생성
- 레이블 설정(예: "MCP 서버")
- 사용자 지정 비밀번호 설정(플랫폼 비밀번호가 아닙니다)
- 표시된 API 키 저장(한 번만 표시됩니다!)
- 참고: API 키는 거래가 가능합니다. Capital.com은 읽기 전용 키를 제공하지 않습니다.

2단계: 설치 및 구성

두 가지 설치 옵션이 있습니다:

옵션 A: MCPB 번들을 통한 원클릭 설치(권장)

리포지토리에는 로컬 MCP 서버 패키징을 위한 Anthropic의 개방형 표준인 MCPB (MCP 번들) 사양을 준수하는 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 (설치 중 "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 - 일일 주문 한도 (기본값: 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 - 가져올 캔들 수: 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 도구를 사용하십시오.

거래 실행 프로세스

필수 2단계 실행

모든 부수 효과 작업은 엄격한 미리보기 → 실행 흐름을 사용합니다:

미리보기: 브로커 규칙 + 로컬 위험 정책에 대해 거래를 검증합니다.
- 정규화된 요청 + 위험 검사와 함께 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 액세스 및/또는 계정을 제한, 일시 중지 또는 해지할 권리를 보유합니다. 클라이언트는 제3자가 자신의 계정에 대해 재량적 통제권을 행사하도록 허용해서는 안 됩니다.

사용자의 책임

사용자는 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}` - 시장 세부 정보 (동적)