Capital.com Public API MCP Server

Capital.com MCP Sunucusu

Capital.com Open API için Model Context Protocol (MCP) sunucusu - Capital.com işlem hesabınıza LLM odaklı erişim sağlar.

⚠️ Önemli Uyarı

Capital.com Public API'sini ve buna bağladığınız yapay zeka veya LLM tabanlı araçlar da dahil olmak üzere her türlü üçüncü taraf aracı kullanımınız, kendi takdirinize ve riskinize bağlıdır. Capital.com yalnızca emir iletimine aracılık esasına göre çalışır ve hiçbir üçüncü taraf yazılımı, çıktılarını veya bunlardan doğan sonuçları kontrol etmez, onaylamaz veya bunlardan sorumluluk kabul etmez. Bu sayfadaki hiçbir şey yatırım tavsiyesi veya işlem önerisi niteliği taşımaz. Tüm işlem kararlarından, yapılandırmalardan ve hesabınızdaki otomatik faaliyetlerden yalnızca siz sorumlusunuz ve kullanımınızın Capital.com Kullanım Koşulları, Elektronik İşlem Koşulları ve yargı bölgenizdeki geçerli tüm yasalara uygun olduğundan emin olmalısınız.

Kripto Türevleri, Capital Com (UK) Ltd.'ye kayıtlı Perakende müşteriler için mevcut değildir.

• Canlı işlemlere geçmeden önce mutlaka bir Demo hesapla başlayın
• İşlemler varsayılan olarak devre dışıdır ve açık yapılandırma gerektirir
• Tüm işlem operasyonları iki aşamalı yürütme gerektirir (önizleme → onayla → yürüt)
• Dahili risk kontrolleri: izin listeleri, büyüklük limitleri, günlük emir üst sınırları
• Kullanım riski size aittir - yazarlar işlem kayıplarından sorumluluk kabul etmez

Daha fazla soru/açıklama için lütfen SSS bölümüne bakın: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Hızlı Başlangıç Kılavuzu

Adım 1: Capital.com API Kimlik Bilgilerini Edinin

1. Hesap Oluşturun: capital.com/trading/signup adresine gidin

   • Test için Demo hesap seçin (önerilir)
   • E-postanızı doğrulayın

2. 2FA'yı Etkinleştirin: Ayarlar > Güvenlik > İki Faktörlü Kimlik Doğrulama

   • API anahtarları oluşturmadan önce gereklidir

3. API Anahtarı Oluşturun: Ayarlar > API entegrasyonları > Yeni anahtar oluştur

   • Bir etiket belirleyin (örn., "MCP Sunucusu")
   • Özel bir şifre belirleyin (bu platform şifreniz DEĞİLDİR)
   • Gösterilen API anahtarını kaydedin (yalnızca bir kez görüntülenir!)
   • Not: API anahtarları işlem yapma yetkisine sahiptir; Capital.com salt okunur anahtarlar sunmaz

Adım 2: Kurulum ve Yapılandırma

İki kurulum seçeneğiniz var:

Seçenek A: MCPB Paketi ile Tek Tıkla Kurulum (Önerilir)

Repo, yerel MCP sunucularını paketlemek için Anthropic'in açık standardı olan MCPB (MCP Bundle) spesifikasyonuna uygun bir manifest.json dosyasıyla birlikte gelir. Bu, sunucuyu yapılandırma dosyalarını manuel olarak düzenlemeden Claude Desktop'a (ve diğer MCPB uyumlu istemcilere) kurmanızı sağlar.

Ön Koşullar: uv (sunucu çalışma zamanı olarak uv kullanır — brew install uv ile kurun veya uv belgelerine bakın).

Adımlar:

1. Repoyu klonlayın ve .mcpb paketini oluşturun (npx için Node.js gerektirir):

   git clone https://github.com/capital-com-sv/capital-mcp.git
   cd capital-mcp
   npx @anthropic-ai/mcpb pack . capital-mcp.mcpb
   

2. Claude Desktop'ta capital-mcp.mcpb dosyasını açın (çift tıklayın veya uygulamaya sürükleyin).
3. Claude Desktop sizden kullanıcı yapılandırma değerlerini (API anahtarı, tanımlayıcı, şifre, işlem kontrolleri) isteyecektir. Bunları doldurun ve Kur'a tıklayın.
4. Claude Desktop'ı yeniden başlatın ve şunu sorarak doğrulayın: "Hangi Capital.com araçları mevcut?"

Ek komutlar için MCPB CLI referansına bakın (validate, info, unpack, sign).

Seçenek B: Betik ile Manuel Kurulum

Ön Koşullar: Python 3.10+ ve Git kurulu olmalıdır.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (kurulum sırasında "PATH'e ekle"yi işaretleyin) + git-scm.com

Mac/Linux:

cd /path/to/capital-mcp
./install.sh

Windows (PowerShell):

cd C:\path\to\capital-mcp
pwsh install.ps1

Kurulum betiği sanal bir ortam oluşturacak, bağımlılıkları yükleyecek ve sizin için MCP istemci yapılandırmasını yazdıracaktır.

Kimlik bilgilerinizle .env dosyasını düzenleyin:

# 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

Adım 3: Sunucuyu Yerel Olarak Test Edin

Mac/Linux:

source venv/bin/activate
python -m capital_mcp.server

Windows (PowerShell):

.\venv\Scripts\Activate.ps1
python -m capital_mcp.server

Şunu görmelisiniz:

INFO - Starting Capital.com MCP Server (env: demo)
INFO - Trading enabled: False

Durdurmak için Ctrl+C tuşlarına basın.

Sorun Giderme: Günlükleri Kontrol Edin

MCP sunucusunu Claude Desktop veya diğer istemcilerle kullanırken sorunlarla karşılaşırsanız, günlük dosyalarını kontrol edin:

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

---

Entegrasyon

Not: /path/to/capital-mcp/venv/bin/python kısmını gerçek venv Python yolunuzla değiştirin. Kurulum betiği bunu sizin için yazdırır. Windows'ta C:\path\to\capital-mcp\venv\Scripts\python.exe kullanın.

Claude Desktop

💡 İpucu: MCPB paketi ile kurduysanız (yukarıdaki Seçenek A), bu bölümü atlayın — Claude Desktop, manifest.json dosyasına dayanarak yapılandırmayı sizin için yazar. Bu bölümü yalnızca manuel betik kurulumları için kullanın.

macOS/Linux

Yapılandırma konumu: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya ~/.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'ı yeniden başlatın. Şunu yazarak doğrulayın: "Hangi Capital.com araçları mevcut?"

Windows

Yapılandırma konumu: %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'ı yeniden başlatın.

Claude Code

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Cursor IDE

Ayarları açın (Cmd+, / Ctrl+,) > Eklentiler > MCP > Yapılandır. Şunu ekleyin:

{
  "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'ı yeniden başlatın.

Codex

Ayarlar > MCP Sunucuları > Sunucu ekle. Yukarıdakiyle aynı komut, argümanlar ve ortam değişkenlerini kullanın.

Windsurf

~/.windsurf/mcp/servers.json dosyasını oluşturun/düzenleyin:

{
  "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'u yeniden başlatın.

Özel MCP İstemcileri

STDIO özellikli herhangi bir MCP istemcisi çalışır. Node.js ile örnek:

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

Kullanım Örnekleri

Claude Desktop ile Örnek Konuşma

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

İşlem Yürütme İş Akışı (İşlemler Etkinken)

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"

Ortam Değişkenleri Referansı

Zorunlu

• CAP_ENV - Ortam: demo veya live (varsayılan: demo)
• CAP_API_KEY - Capital.com'dan API anahtarı
• CAP_IDENTIFIER - Giriş e-postası
• CAP_API_PASSWORD - API anahtarı özel şifresi

Risk Kontrolleri (Önerilir)

• CAP_ALLOW_TRADING - İşlemleri etkinleştir (varsayılan: false)
• CAP_ALLOWED_EPICS - Virgülle ayrılmış izin listesi (örn., "SILVER,GOLD,BTCUSD") veya sınırsız için "ALL"
• CAP_MAX_POSITION_SIZE - Maksimum pozisyon büyüklüğü (varsayılan: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Maksimum emir büyüklüğü (varsayılan: 1.0)
• CAP_MAX_OPEN_POSITIONS - Maksimum eşzamanlı pozisyon (varsayılan: 3)
• CAP_MAX_ORDERS_PER_DAY - Günlük emir limiti (varsayılan: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - confirm=true gerektir (varsayılan: true)
• CAP_DRY_RUN - Tüm işlem yürütmelerini engelle (varsayılan: false)

İsteğe Bağlı

• CAP_DEFAULT_ACCOUNT_ID - Giriş sonrası varsayılan hesap
• CAP_HTTP_TIMEOUT_S - HTTP zaman aşımı (varsayılan: 15)
• CAP_LOG_LEVEL - Günlük seviyesi: DEBUG, INFO, WARNING, ERROR (varsayılan: INFO)

MCP Araçları (36 uygulandı)

Oturum (4)

• cap_session_status - Oturum bilgisini al
• cap_session_login - Oturum oluştur
• cap_session_ping - Oturumu canlı tut
• cap_session_logout - Oturumu sonlandır

Piyasa Verisi (6)

• cap_market_search - Piyasaları ara
• cap_market_get - Piyasa detaylarını al
• cap_market_prices - Geçmiş fiyatlar
• cap_market_sentiment - Müşteri duyarlılığı
• cap_market_navigation_root - Piyasa kategorileri kökü
• cap_market_navigation_node - Piyasa kategorileri düğümü

Hesap (6)

• cap_account_list - Hesapları listele
• cap_account_preferences_get - Tercihleri al
• cap_account_preferences_set - Tercihleri ayarla
• cap_account_history_activity - Aktivite geçmişi
• cap_account_history_transactions - İşlem geçmişi
• cap_account_demo_topup - Demo hesaba bakiye yükle

İşlem (11)

• Salt okunur:

  • cap_trade_positions_list - Pozisyonları listele
  • cap_trade_positions_get - Pozisyon detaylarını al
  • cap_trade_orders_list - Çalışan emirleri listele
  • cap_trade_confirm_get - Onay durumunu al
  • cap_trade_confirm_wait - Onay bekle

• Önizleme:

  • cap_trade_preview_position - Pozisyon önizle
  • cap_trade_preview_working_order - Emir önizle

• Yürütme:

  • cap_trade_execute_position - Pozisyon yürüt
  • cap_trade_execute_working_order - Emir yürüt
  • cap_trade_positions_close - Pozisyon kapat
  • cap_trade_orders_cancel - Emri iptal et

İzleme Listeleri (6)

• cap_watchlists_list - İzleme listelerini listele
• cap_watchlists_create - İzleme listesi oluştur
• cap_watchlists_get - İzleme listesini al
• cap_watchlists_add_market - Piyasa ekle
• cap_watchlists_delete - İzleme listesini sil
• cap_watchlists_remove_market - Piyasayı kaldır

Akış (3)

• cap_stream_prices - Gerçek zamanlı fiyat akışı (WebSocket)
• cap_stream_alerts - Fiyat seviyesi uyarı akışı (WebSocket)
• cap_stream_portfolio - Canlı portföy K/Z akışı (WebSocket)

MCP İstemleri (İş Akışı Şablonları)

MCP istemleri, Claude'u karmaşık çok adımlı işlem operasyonlarında yönlendiren yapılandırılmış iş akışlarıdır. Yaygın görevler için adım adım talimatlar ve en iyi uygulamaları sağlarlar.

Mevcut İstemler (7)

1. market_scan - Piyasa Analizi İş Akışı

İşlem koşulları için bir izleme listesini taramanızda size rehberlik eder.

Parametreler:

• watchlist_id - Taranacak izleme listesi (önce izleme listelerini listelemek için boş bırakın)
• timeframe - Fiyat çözünürlüğü: MINUTE, MINUTE_5, HOUR, DAY (varsayılan: HOUR)
• lookback_periods - Alınacak mum sayısı: 1-1000 (varsayılan: 24)

İş Akışı:

1. İzleme listesi piyasalarını al
2. Her piyasa için fiyat verisini getir
3. Teknik analiz (trendler, destek/direnç, formasyonlar)
4. İsteğe bağlı duyarlılık kontrolü
5. Fırsat özeti oluştur

Örnek Kullanım:

• "İzleme listemi analiz etmek için market_scan istemini kullan"
• "İşlem kurulumları için piyasalarımı tara"

Gerçek işlem: Yapılandırmalarınızı şunlarla değiştirin: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - İşlem Planlama İş Akışı

Risk yönetimi araçlarıyla bir işlem önerisi oluşturmanızda size rehberlik eder.

Parametreler:

• epic - İşlem yapılacak piyasa (zorunlu, örn., SILVER, GOLD)
• direction - BUY veya SELL (varsayılan: BUY)
• thesis - İşlem gerekçeniz (isteğe bağlı)
• risk_percent - Bakiye yüzdesi olarak risk (varsayılan: %1.0)

İş Akışı:

1. Piyasa detaylarını ve işlem kurallarını getir
2. Risk yüzdesine göre pozisyon büyüklüğünü hesapla
3. Zarar durdur ve kar al seviyelerini tanımla
4. İşlemi önizle (yalnızca doğrulama - yürütme yok)
5. Potansiyel yürütme için preview_id döndür

Örnek Kullanım:

• "SILVER için bir işlem önerisi oluştur"
• "%2 riskle GOLD'da uzun bir işlem öner"

Not: Bu istem işlemleri YÜRÜTMEZ - yalnızca önizlemeler oluşturur.

3. execute_trade - İşlem Yürütme İş Akışı

Önizlenmiş bir işlemi yürütmenizde size rehberlik eder.

Parametreler:

• preview_id - trade_proposal'dan Önizleme Kimliği (zorunlu)

İş Akışı:

1. preview_id'nin sağlandığını ve geçerli olduğunu doğrula
2. Tüm risk kontrollerini yeniden kontrol et
3. Pozisyonu aracı kurumda yürüt
4. Onay için yokla (KABUL EDİLDİ/REDDEDİLDİ)
5. Nihai durumu raporla

Örnek Kullanım:

• "Az önce önizlediğim işlemi yürüt"
• "abc-123 önizleme kimlikli işlemi gerçekleştir"

Not:

• CAP_ALLOW_TRADING=true gerektirir
• epic'in izin listesinde olmasını gerektirir
• Önizlemenin süresi dolmamış olmalıdır (2 dakikalık TTL)
• ⚠️ Bu GERÇEK bir işlem gerçekleştirecektir

4. position_review - Portföy Analizi İş Akışı

Açık pozisyonlarınızı ve emirlerinizi analiz etmenizde size rehberlik eder.

Parametreler: Yok (tüm mevcut pozisyonları analiz eder)

İş Akışı:

1. Tüm açık pozisyonları getir
2. Tüm çalışan emirleri getir
3. K/Z, risk ve risk maruziyeti metriklerini hesapla
4. Yoğunlaşma ve korelasyon risklerini belirle
5. Potansiyel düzeltmeler öner (yürütmeden)

Örnek Kullanım:

• "Mevcut pozisyonlarımı gözden geçir"
• "Portföy risk maruziyetimi analiz et"

Not: Bu salt okunur bir iş akışıdır - hiçbir işlem yürütülmez.

5. live_price_monitor - Gerçek Zamanlı Fiyat Takibi (WebSocket)

Fiyatlar bir eşiğin ötesine geçtiğinde anlık uyarılarla canlı piyasa fiyatlarını izleyin.

Parametreler:

• epics - İzlenecek piyasa EPIC'lerinin listesi (aramak/seçmek için boş bırakın, maks 40)
• duration_minutes - Ne kadar süreyle izleneceği (varsayılan: 5 dakika, maks: 10 dakika)
• threshold_percent - Fiyat bu %'den fazla hareket ettiğinde uyar (varsayılan: %1.0)

İş Akışı:

1. İzlenecek piyasaları seçin (veya doğrudan EPIC'leri sağlayın)
2. Referans noktası oluşturmak için başlangıç fiyatlarını alın
3. Gerçek zamanlı WebSocket fiyat güncellemelerine abone olun
4. Sürekli güncellemelerle canlı fiyat panosunu görüntüleyin
5. Herhangi bir piyasa threshold_percent değerinden fazla hareket ettiğinde uyarı verin
6. duration_minutes sonra otomatik olarak durdurun

Örnek Kullanım:

• "GOLD ve SILVER fiyatlarını 2 dakika boyunca izle"
• "BTC'yi sonraki 5 dakika izle, %2'lik hareketlerde uyar"

Not: CAP_WS_ENABLED=true gerektirir. Capital.com WebSocket oturumları maksimum 10 dakika sürer.

6. real_time_alerts - Koşullu Fiyat Uyarıları (WebSocket)

Fiyat seviyesi uyarıları ayarlayın ve piyasalar hedeflerinize ulaştığında anında bildirim alın.

Parametreler:

• alert_config - EPIC başına uyarı seviyeleri (örn., {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Maksimum izleme süresi (varsayılan: 5 dakika)
• auto_stop - İlk uyarıdan sonra izlemeyi durdur? (varsayılan: true)

İş Akışı:

1. Uyarı koşullarını yapılandırın (her piyasa için fiyat seviyeleri)
2. WebSocket fiyat güncellemelerine abone olun
3. Uyarı tetikleyicileri için sürekli izleyin
4. Koşul karşılandığında anında uyarı gönderin
5. İsteğe bağlı olarak izlemeye devam edin veya ilk uyarıdan sonra durdurun

Örnek Kullanım:

• "GOLD 2050'ye ulaştığında beni uyar"
• "SILVER 28'in altına düştüğünde bildir"

Not: CAP_WS_ENABLED=true gerektirir.

7. live_portfolio_monitor - Gerçek Zamanlı K/Z Takibi (WebSocket)

Piyasa fiyatları hareket ettikçe portföy K/Z'nizin gerçek zamanlı olarak güncellenmesini izleyin.

Parametreler:

• duration_minutes - İzleme süresi (varsayılan: 5 dakika, maks: 10 dakika)
• alert_pnl_threshold - Toplam K/Z bu tutarı aştığında uyar (varsayılan: $100)

İş Akışı:

1. Mevcut açık pozisyonları getir
2. Pozisyon piyasaları için fiyat güncellemelerine abone ol
3. Fiyatlar değiştikçe canlı K/Z hesapla
4. Gerçek zamanlı portföy panelini göster
5. K/Z eşiği aştığında uyar

Örnek Kullanım:

• "Portföy K/Z'imi 5 dakika boyunca izle"
• "Pozisyonları gerçek zamanlı izle, 500$ K/Z'de uyar"

Not: CAP_WS_ENABLED=true ve aktif pozisyonlar gerektirir.

Prompt'lar Nasıl Kullanılır

Claude Desktop veya diğer MCP istemcilerinde, prompt'lar kullanılabilir etkileşim desenleri olarak görünür. Bunları konuşma içinde doğal olarak çağırabilirsiniz:

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]

Prompt'lar, iş akışı boyunca işlem kontrollerini korurken yapılandırılmış rehberlik sağlar.

MCP Kaynakları (Salt Okunur Veri)

MCP kaynakları, URI tabanlı kaynaklar aracılığıyla sunucu durumuna ve yapılandırmasına salt okunur erişim sağlar. Araçların (eylem gerçekleştiren) aksine, kaynaklar istemcilerin okuyabileceği ve izleyebileceği verileri sunar.

Mevcut Kaynaklar

1. cap://status - Sunucu Durumu

Gerçek zamanlı sunucu ve oturum bilgisi.

Döndürür: Sunucu sağlığı, oturum durumu, kimlik doğrulama durumu, hız limitlerini içeren JSON

Örnek:

{
  "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"
  }
}

Kullanım Alanları: Sunucu sağlığını izleme, oturum durumunu kontrol etme, kimlik doğrulama sorunlarını ayıklama

---

2. cap://risk-policy - Risk Politikası

Kapsamlı risk yönetimi yapılandırması ve işlem kontrolleri.

Döndürür: Tüm doğrulama katmanlarını, işlem kontrol özelliklerini ve işlem kısıtlamalarını içeren JSON

Örnek:

{
  "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
  }
}

Kullanım Alanları: Aktif işlem kontrollerini anlama, risk yapılandırmasını denetleme, uyumluluk dokümantasyonu

---

3. cap://allowed-epics - İşlem İzin Listesi

İzin verilen piyasaları gösteren mevcut işlem izin listesi yapılandırması.

Döndürür: İzin listesi modu, izin verilen epic'ler ve yapılandırma talimatlarını içeren JSON

Örnek:

{
  "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)"
  }
}

Kullanım Alanları: Hangi piyasaların işlem yapılabilir olduğunu kontrol etme, izin listesi yapılandırmasını doğrulama

---

4. cap://market-cache/{epic} - Piyasa Detayları (Dinamik)

Belirli bir epic için önbelleğe alınmış piyasa detayları (broker'dan canlı çekme).

Parametreler:

• epic - Piyasa tanımlayıcı (örn., "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

Döndürür: Kapsamlı piyasa bilgilerini içeren JSON

Kimlik Doğrulama: Gerekli

Örnek: 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"
}

Kullanım Alanları: Piyasa detaylarını alma, işlem kurallarını kontrol etme, marjin gereksinimlerini analiz etme

---

Kaynaklar Nasıl Kullanılır

Claude Desktop veya diğer MCP istemcilerinde, kaynaklara URI ile erişilebilir:

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]

Kaynaklar, araçları çalıştırmadan sunucu durumunu ve yapılandırmasını incelemek için uygun bir yol sağlar. İzleme listesi verileri için cap_watchlists_list ve cap_watchlists_get araçlarını kullanın.

İşlem Gerçekleştirme Süreci

Zorunlu İki Adımlı Gerçekleştirme

Tüm yan etkili işlemler katı bir önizleme → gerçekleştirme akışı kullanır:

1. Önizleme: İşlemi broker kuralları + yerel risk politikasına göre doğrula

   • Normalleştirilmiş istek + risk kontrolleri ile preview_id döndürür
   • Yan etki yok, salt okunur doğrulama

2. Gerçekleştir: preview_id kullanarak işlemi gönder

   • Kritik kontrolleri yeniden çalıştırır
   • CAP_REQUIRE_EXPLICIT_CONFIRM=true ise confirm=true gerektirir
   • Broker onayını yoklar
   • Günlük emir sayacını artırır

Risk Kontrolleri

• İzin Listesi: Yalnızca CAP_ALLOWED_EPICS içindeki EPIC'ler işlem yapılabilir
• Büyüklük Limitleri: Maksimum pozisyon/emir büyüklüğü uygulanır
• Pozisyon Limitleri: Herhangi bir anda maksimum açık pozisyon
• Günlük Limitler: Günlük maksimum emir sayısı
• Büyüklük Normalleştirme: Broker min/maks/artış değerlerine yuvarlar
• Kuru Çalışma Modu: Etkinleştirildiğinde tüm gerçekleştirmeleri engeller

Dokümantasyon

• Kullanım Kılavuzu: USAGE.md - Örneklerle kapsamlı kullanım kılavuzu
• Capital.com API Referansı: https://open-api.capital.com/
• Capital.com API Postman Koleksiyonu: https://github.com/capital-com-sv/capital-api-postman

Lisans

MIT

Sorumluluk Reddi – Capital.com Public API'nin Üçüncü Taraf Araçlarla Kullanımı

Üçüncü Taraf Entegrasyonu

Bu sayfa, müşterilerin Capital.com Public API'yi, yapay zeka veya büyük dil modelleri ('LLM'ler') tarafından desteklenenler de dahil olmak üzere üçüncü taraf yazılım, araç veya entegrasyonlara nasıl bağlayabileceğini açıklar. Bu tür herhangi bir üçüncü taraf yazılım, araç veya entegrasyon Capital.com'dan bağımsızdır ve Capital.com'un hizmetlerinin bir parçasını oluşturmaz. Capital.com, herhangi bir üçüncü taraf yazılımı, işlevselliğini, çıktılarını veya kullanımından doğan sonuçları kontrol etmez, geliştirmez, onaylamaz veya bunlar için herhangi bir sorumluluk kabul etmez. Capital.com Public API ile bağlantılı olarak üçüncü taraf araçların veya entegrasyonların herhangi bir şekilde kullanımı tamamen sizin riskiniz altındadır. Kullanmayı seçtiğiniz herhangi bir üçüncü taraf aracın şartlarını, gizlilik politikalarını ve veri işleme uygulamalarını incelemekten siz sorumlusunuz.

Public API Kullanımı

Capital.com Public API'yi kullanımınız tamamen kendi takdirinize ve riskinize bağlıdır. Capital.com, Public API'yi bilgilendirme ve işlem amaçları için kullanıma sunar, ancak herhangi bir özel kullanımı, entegrasyonu veya işlem stratejisini tavsiye etmez, onaylamaz veya teşvik etmez. API'ye nasıl eriştiğiniz ve kullandığınızdan, gönderilen emirlerin parametreleri, bağlı araç veya sistemlerin yapılandırması ve alınan verilerin yorumlanması da dahil olmak üzere yalnızca siz sorumlusunuz. Capital.com, doğrudan veya üçüncü taraf araçlar aracılığıyla erişilip erişilmediğine bakılmaksızın, API'yi kullanımınızdan kaynaklanan kayıplar veya istenmeyen sonuçlar için hiçbir sorumluluk kabul etmez. API kullanılabilirliği, işlevselliği ve özellikleri önceden haber verilmeksizin herhangi bir zamanda değiştirilebilir, hız sınırlamasına tabi tutulabilir, askıya alınabilir veya durdurulabilir. Public API'yi kullanımınız, API'yi kullanmadan önce dikkatlice okumanız gereken Capital.com Şartlar ve Koşulları ile Elektronik İşlem Şartları'na tabidir.

Yalnızca Gerçekleştirme Hizmeti ve Yatırım Tavsiyesi Yok Capital.com, hizmetlerini yalnızca gerçekleştirme bazında sunar. Finansal araçların ticareti önemli kayıp riski içerir. Bu sayfada, Public API'de veya herhangi bir üçüncü taraf yazılım veya entegrasyonda yer alan hiçbir şey yatırım tavsiyesi, kişisel bir öneri veya herhangi bir finansal aracı almak veya satmak için bir teşvik teşkil etmez. Bu, AI, LLM tabanlı veya diğer otomatik araçlar tarafından üretilen herhangi bir çıktı, sinyal, öneri veya analizi içerir. Otomatik veya algoritmik faaliyetler de dahil olmak üzere tüm işlem kararları, kendi riskiniz altında alınır ve yalnızca sizin sorumluluğunuzdadır. Otomatik ve Algoritmik İşlem Riskleri Public API'nin otomatik veya algoritmik işlem araçlarıyla bağlantılı olarak kullanılması, aşağıdakilerle sınırlı olmamak üzere ek riskler taşır: insan incelemesi veya müdahalesi olmadan emirlerin hızlı gerçekleştirilmesi; sistem hataları, yazılım arızaları veya bağlantı sorunları; beklenenden önemli ölçüde farklı fiyatlardan gerçekleştirme; ve yanlış yapılandırılmış araçlar veya parametrelerden kaynaklanan istenmeyen veya hatalı emirler. Capital.com, bu tür risklerden veya sistemleri ile herhangi bir üçüncü taraf araç arasındaki etkileşimden kaynaklanan kayıplardan sorumlu değildir. Geçmiş performans ve otomatik araçlar tarafından üretilen herhangi bir çıktı, gelecekteki sonuçların göstergesi değildir.

Yasaklı Kullanım

Public API ve bağlı araçların kullanımı, Capital.com platformunu manipüle etmek, fiyatlandırma veya gecikmeden yararlanmak, piyasa suistimalinde bulunmak veya herhangi bir haksız avantaj elde etmek için kullanılmamalıdır. Capital.com, bu tür bir kötüye kullanımın gerçekleştiğini veya gerçekleşmesinin muhtemel olduğunu makul bir şekilde değerlendirdiği durumlarda API erişimini ve/veya hesabınızı kısıtlama, askıya alma veya sonlandırma hakkını saklı tutar. Müşteriler, herhangi bir üçüncü tarafın hesapları üzerinde isteğe bağlı kontrol uygulamasına izin vermemelidir.

Sorumluluklarınız

Capital.com platformunu, Public API'yi ve herhangi bir üçüncü taraf aracı veya entegrasyonu kullanımınızın Capital.com'un Şartlar ve Koşulları, Elektronik İşlem Şartları ve yargı bölgenizdeki geçerli tüm yasa ve düzenlemelere uygun olmasını sağlamaktan siz sorumlusunuz. Otomatik işlem araçlarının koşullarınıza, deneyiminize ve risk toleransınıza uygun olup olmadığını kullanmadan önce dikkatlice değerlendirmelisiniz. Capital.com, herhangi bir otomatik aracı veya entegrasyonu canlı bir işlem ortamına bağlamadan önce bir Demo hesap kullanarak kapsamlı bir şekilde test etmenizi şiddetle tavsiye eder.