Capital.com Public API MCP Server

공식

Capital.com MCP 서버를 사용하면 AI 어시스턴트가 거래 계정과 직접 대화할 수 있습니다. 시장 데이터, 포지션 확인, 거래 미리보기 등 모든 것을 AI 도구를 떠나지 않고 일반 언어로 처리할 수 있습니다.

GitHub

Capital Com Public API MCP(으)로 무엇을 할 수 있나요?

세션 상태 확인 — 어시스턴트에게 capital-mcp.mcpb를 통해 Capital.com 데모 또는 실계좌에 로그인되어 있는지 확인하도록 요청하세요.
시장 검색 — 어시스턴트가 비트코인 페어와 같은 거래 가능한 상품을 찾아 세부 정보와 현재 가격을 반환하도록 하세요.
거래 미리보기 — 리스크 검증이 완료된 거래 미리보기를 요청하세요(예: "1.0 SILVER 매수 미리보기"). 주문을 실행하지 않고 수량과 한도를 검증합니다.
확정 거래 실행 — 어시스턴트에게 명시적 확인과 함께 preview_id를 사용하여 이전에 미리 본 포지션을 제출하도록 지시하세요.
미결제 포지션 목록 — 어시스턴트에게 Capital.com 계정의 현재 미결제 포지션과 세부 정보를 표시하도록 요청하세요.
실시간 가격 모니터링 — WebSocket 스트리밍을 통해 특정 시장에 대한 실시간 가격 추적 및 알림을 설정하세요.

문서

Capital.com MCP 서버

Capital.com 공개 API용 Model Context Protocol(MCP) 서버 - LLM 기반으로 Capital.com 거래 계정에 접근할 수 있게 해줍니다.

⚠️ 중요 공지

Capital.com 공개 API 및 AI/LLM 기반 도구를 포함한 모든 타사 도구의 사용은 전적으로 본인의 책임입니다. Capital.com은 실행 전용(execution-only) 서비스이며, 타사 소프트웨어나 그 결과에 대해 보증하거나 책임을 지지 않습니다. 여기의 어떤 내용도 투자 조언이 아닙니다. 거래 결정, 타사 도구로 인한 지연으로 발생하는 가격 차이를 포함한 모든 책임은 본인에게 있으며, 적용 가능한 약관과 법률을 준수해야 합니다.

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

2단계: 설치 및 구성

AI 안내 설치: AI 기반 편집기(Claude Code, Cursor, Windsurf)에서 이 프로젝트 폴더를 열고 Capital.com MCP 서버 설치를 요청하세요. INSTALL.md에 따라 환경에 가장 적합한 방법으로 설정을 안내받을 수 있습니다.

다음과 같은 수동 설치 옵션도 있습니다:

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

리포지토리에는 사전 빌드된 capital-mcp.mcpb 번들이 포함되어 있습니다. Claude Desktop에서 열면 끝입니다. 수동 구성 편집이 필요 없습니다.

단계:

리포지토리 클론:

git clone https://github.com/capital-com-sv/capital-mcp.git
cd capital-mcp

Claude Desktop에서 capital-mcp.mcpb 열기(더블클릭 또는 앱으로 드래그).
Claude Desktop이 자격 증명(API 키, 식별자, 비밀번호) 및 거래 통제 설정을 요청합니다. 입력하고 설치를 클릭하세요.
Claude Desktop을 다시 시작하고 "Capital.com 도구는 무엇이 있나요?"라고 물어 확인하세요.

옵션 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
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=ALL

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# Narrow the allowlist to the instruments you actually trade
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

옵션 C: Docker

사전 요구 사항: Docker가 설치되어 있어야 합니다.

자격 증명으로 .env 파일 생성(.env.example 참조):

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

서버 실행:

docker run -i --rm --env-file .env ghcr.io/capital-com-sv/capital-mcp:latest

문제 해결: 로그 확인

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

클라이언트 통합

클라이언트별 구성(Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, 사용자 지정 클라이언트)은 USAGE.md — 클라이언트 통합을 참조하세요.

사용 예시

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 - 거래 활성화(기본값: true)
CAP_ALLOWED_EPICS - 거래가 허용된 상품(기본값: ALL, 모든 상품). 쉼표로 구분된 목록으로 제한(예: "SILVER,GOLD,BTCUSD"). 비어 있으면 모든 거래 차단
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 기능

6개 카테고리의 38개 도구, 7개 워크플로 프롬프트, 4개 읽기 전용 리소스.

카테고리	도구 수	설명
세션	4	로그인, 로그아웃, 상태, 유지
시장 데이터	6	검색, 세부 정보, 가격, 심리, 탐색
계정	6	계정 목록, 환경 설정, 활동/거래 내역, 데모 충전
거래	13	미리보기, 실행, 포지션 종료, 대기 주문 목록/취소/수정, 확인
관심 목록	6	관심 목록 생성, 목록, 조회, 삭제, 시장 추가/제거
스트리밍	3	WebSocket을 통한 실시간 가격, 알림, 포트폴리오 손익

프롬프트	설명
`market_scan`	거래 조건에 대한 관심 목록 스캔
`trade_proposal`	위험 기반 크기 조정으로 거래 계획(미리보기 전용)
`execute_trade`	이전에 미리 본 거래 실행
`position_review`	열린 포지션 및 노출 분석(읽기 전용)
`live_price_monitor`	이동 알림이 포함된 실시간 가격 추적(WebSocket)
`real_time_alerts`	조건부 가격 수준 알림(WebSocket)
`live_portfolio_monitor`	실시간 포트폴리오 손익 대시보드(WebSocket)

리소스	설명
`cap://status`	서버 상태, 세션 상태, 속도 제한
`cap://risk-policy`	위험 관리 구성 및 검증 계층
`cap://allowed-epics`	거래 허용 목록 구성
`cap://market-cache/{epic}`	캐시된 시장 세부 정보(실시간 가져오기)

전체 세부 정보, 매개변수 및 예시는 USAGE.md를 참조하세요.

거래 실행 프로세스

필수 2단계 실행

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

미리보기: 브로커 규칙 + 로컬 위험 정책에 대해 거래 검증
- 정규화된 요청 + 위험 검사가 포함된 preview_id 반환
- 부작용 없음, 읽기 전용 검증
실행: preview_id을 사용하여 거래 제출
- 중요 검사 재실행
- CAP_REQUIRE_EXPLICIT_CONFIRM=true인 경우 confirm=true 필요
- 브로커 확인 폴링
- 일일 주문 카운터 증가

위험 통제

허용 목록: CAP_ALLOWED_EPICS의 EPIC만 거래 가능, 기본 ALL은 모든 상품 허용
크기 제한: 최대 포지션/주문 크기 적용
포지션 제한: 언제든지 최대 열린 포지션 수
일일 제한: 일일 최대 주문 수
크기 정규화: 브로커 최소/최대/증분으로 반올림
드라이런 모드: 활성화 시 모든 실행 차단

문서

사용 가이드: 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 MCP 서버는 사용자 컴퓨터에서 로컬로 실행되며, 사용자가 제공한 자격 증명을 사용하여 Capital.com 공개 API와 직접 통신합니다. 호스팅 서비스로 운영되지 않으며 자체 서버가 없습니다.

데이터 수집

MCP 서버는 데이터를 수집하거나 저장하지 않습니다. AI 클라이언트와 Capital.com 공개 API 사이의 로컬 브리지 역할만 합니다.

데이터 사용 및 저장

세션 중 교환되는 모든 데이터는 로컬 컴퓨터의 메모리에서 처리되며 세션이 종료되면 폐기됩니다. MCP 서버는 디스크에 데이터를 쓰지 않습니다. 참고: AI 클라이언트는 자체 개인정보 보호정책에 따라 이를 통과하는 데이터를 처리, 기록 또는 저장할 수 있으므로 별도로 검토해야 합니다.

제3자 공유

MCP 서버는 제3자와 데이터를 공유하지 않습니다. 데이터는 로컬 환경과 Capital.com 공개 API 사이에서만 흐르며, Capital.com의 자체 개인정보 보호정책이 적용됩니다.

데이터 보존

MCP 서버는 데이터를 보존하지 않습니다. 세션 데이터는 세션 기간 동안에만 메모리에 존재합니다.

API 자격 증명

제공한 API 자격 증명은 로컬 환경에 저장 및 관리됩니다. 적절히 보호할 책임은 사용자에게 있습니다.

문의

Capital.com 계정 또는 Capital.com의 데이터 처리에 관한 개인정보 관련 문의는 Capital.com 개인정보 보호정책을 참조하거나 support@capital.com으로 연락하세요.

면책 조항 – 타사 도구와 함께 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은 실행 전용 기준으로 서비스를 제공합니다. 금융 상품 거래는 상당한 손실 위험을 수반합니다. 이 페이지, Public API 또는 제3자 소프트웨어나 통합에 포함된 어떤 내용도 투자 조언, 개인 추천 또는 금융 상품 매수·매도 권유를 구성하지 않습니다. 여기에는 AI, LLM 기반 또는 기타 자동화 도구가 생성한 출력, 신호, 제안 또는 분석이 포함됩니다. 자동화 또는 알고리즘 활동을 포함한 모든 거래 결정은 전적으로 귀하의 책임 하에 이루어지며 귀하의 단독 책임으로 남습니다. Capital.com은 Public API에 연결된 제3자 AI 또는 LLM 기반 도구의 출력을 통제하지 않으며, 이러한 도구가 투자 조언이나 개인 추천으로 해석될 수 있는 콘텐츠를 생성하지 않을 것이라고 보장할 수 없습니다. 그러한 출력은 Capital.com이 제공하거나 Capital.com을 대신하여 제공되는 것이 아니며 조언으로 신뢰해서는 안 됩니다.

자동화 및 알고리즘 거래의 위험

자동화 또는 알고리즘 거래 도구와 관련하여 Public API를 사용하면 추가적인 위험이 수반되며, 여기에는 다음이 포함되지만 이에 국한되지는 않습니다: 인간의 검토나 개입 없이 신속하게 실행되는 주문; 시스템 오류, 소프트웨어 결함 또는 연결 문제; 예상과 실질적으로 다른 가격으로의 실행; 잘못 구성된 도구나 매개변수로 인한 의도하지 않거나 잘못된 주문. Capital.com은 이러한 위험 또는 자사 시스템과 제3자 도구 간의 상호 작용으로 인해 발생하는 손실에 대해 책임을 지지 않습니다. 과거 실적 및 자동화 도구가 생성한 출력은 미래 결과를 나타내지 않습니다.

AI 또는 LLM 기반 도구를 사용하여 시장 데이터나 가격 정보를 검색하는 경우, 도구가 전달한 가격과 결과 주문이 실행되는 가격 사이에 지연이 있을 수 있습니다. Public API를 통해 체결된 모든 주문은 시장가 주문으로 실행됩니다. 따라서 실행 가격은 요청 시점에 표시된 가격과 다를 수 있습니다. Capital.com은 의무에 따라 최선의 실행을 추구합니다. 당사는 통제 범위 밖에 있는 제3자 도구나 시스템으로 인한 지연에서 발생하는 가격 차이에 대해 책임을 지지 않습니다.

금지된 사용

Public API 및 연결된 도구의 사용은 Capital.com 플랫폼을 조작하거나, 가격이나 지연 시간을 악용하거나, 시장 남용에 관여하거나, 부당한 이점을 얻는 데 사용되어서는 안 됩니다. Capital.com은 그러한 오용이 발생했거나 발생할 가능성이 있다고 합리적으로 판단하는 경우 API 액세스 및/또는 귀하의 계정을 제한, 정지 또는 종료할 권리를 보유합니다. 고객은 제3자가 자신의 계정에 대해 재량적 통제권을 행사하도록 허용해서는 안 됩니다.

귀하의 책임

귀하는 Capital.com 플랫폼, Public API 및 제3자 도구나 통합의 사용이 Capital.com의 이용약관, 전자 거래 약관 및 귀하의 관할권에서 적용되는 모든 법률과 규정을 준수하도록 보장할 책임이 있습니다. 자동화 거래 도구를 사용하기 전에 해당 도구가 귀하의 상황, 경험 및 위험 감수 성향에 적합한지 신중히 고려해야 합니다. Capital.com은 자동화 도구나 통합을 실거래 환경에 연결하기 전에 데모 계정을 사용하여 철저히 테스트할 것을 강력히 권장합니다.