Capital.com Public API MCP Server

Server MCP Capital.com

Server Model Context Protocol (MCP) untuk Capital.com Open API — memungkinkan akses berbasis LLM ke akun trading Capital.com Anda.

⚠️ Pemberitahuan Penting

Penggunaan Anda atas Capital.com Public API dan alat pihak ketiga apa pun, termasuk alat berbasis AI/LLM, sepenuhnya merupakan risiko Anda sendiri. Capital.com bersifat execution-only dan tidak mendukung atau bertanggung jawab atas perangkat lunak pihak ketiga atau hasilnya. Tidak ada apa pun di sini yang merupakan nasihat investasi. Anda sepenuhnya bertanggung jawab atas keputusan trading Anda, termasuk perbedaan harga yang timbul dari latensi yang disebabkan oleh alat pihak ketiga, dan harus mematuhi ketentuan serta hukum yang berlaku.

Derivatif Kripto tidak tersedia untuk klien Retail yang terdaftar di Capital Com (UK) Ltd.

• Selalu mulai dengan akun Demo sebelum mempertimbangkan trading langsung
• Trading dinonaktifkan secara default dan memerlukan konfigurasi eksplisit
• Semua operasi trading memerlukan eksekusi dua fase (pratinjau → konfirmasi → eksekusi)
• Kontrol risiko bawaan: daftar izin, batas ukuran, batas pesanan harian
• Gunakan dengan risiko Anda sendiri — penulis tidak bertanggung jawab atas kerugian trading

Untuk pertanyaan/klarifikasi lebih lanjut, silakan merujuk ke FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Panduan Memulai Cepat

Langkah 1: Dapatkan Kredensial API Capital.com

1. Buat Akun: Kunjungi capital.com/trading/signup

   • Pilih akun Demo untuk pengujian (disarankan)
   • Verifikasi email Anda

2. Aktifkan 2FA: Pengaturan > Keamanan > Autentikasi Dua Faktor

   • Diperlukan sebelum membuat kunci API

3. Buat Kunci API: Pengaturan > Integrasi API > Buat kunci baru

   • Tetapkan label (misalnya, "MCP Server")
   • Tetapkan kata sandi khusus (ini BUKAN kata sandi platform Anda)
   • Simpan kunci API yang ditampilkan (hanya ditampilkan sekali!)
   • Catatan: Kunci API memiliki kemampuan trading; Capital.com tidak menawarkan kunci khusus-baca

Langkah 2: Instal & Konfigurasi

Instalasi dengan Panduan AI: Buka folder proyek ini di editor bertenaga AI (Claude Code, Cursor, Windsurf) dan minta untuk menginstal server MCP Capital.com — editor akan mengikuti INSTALL.md untuk memandu Anda melalui pengaturan, memilih metode terbaik untuk lingkungan Anda.

Anda juga memiliki opsi instalasi manual berikut:

Opsi A: Instalasi Satu-Klik melalui Bundel MCPB (Disarankan)

Repositori ini menyertakan bundel capital-mcp.mcpb yang sudah dibuat sebelumnya — buka di Claude Desktop dan selesai, tanpa perlu mengedit konfigurasi manual.

Langkah-langkah:

1. Klon repositori:

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

2. Buka capital-mcp.mcpb di Claude Desktop (klik dua kali, atau seret ke dalam aplikasi).
3. Claude Desktop akan meminta Anda memasukkan kredensial (kunci API, pengenal, kata sandi) dan kontrol trading. Isi dan klik Instal.
4. Mulai ulang Claude Desktop dan verifikasi dengan bertanya: "Alat Capital.com apa saja yang tersedia?"

Opsi B: Instalasi Manual melalui Skrip

Prasyarat: Python 3.10+ dan Git harus terinstal.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (centang "Add to PATH" saat instalasi) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

Skrip instalasi akan membuat lingkungan virtual, menginstal dependensi, dan mencetak konfigurasi klien MCP untuk Anda.

Edit .env dengan kredensial Anda:

# 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

Opsi C: Docker

Prasyarat: Docker harus terinstal.

1. Buat file .env dengan kredensial Anda (lihat .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
   

2. Jalankan server:

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

Pemecahan Masalah: Periksa Log

Jika Anda mengalami masalah saat menggunakan server MCP dengan Claude Desktop atau klien lain, periksa file log:

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

---

Integrasi Klien

Untuk konfigurasi khusus klien (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, klien kustom), lihat USAGE.md — Integrasi Klien.

Contoh Penggunaan

Contoh Percakapan dengan 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

Alur Kerja Eksekusi Trading (Saat Trading Diaktifkan)

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"

Referensi Variabel Lingkungan

Wajib

• CAP_ENV - Lingkungan: demo atau live (default: demo)
• CAP_API_KEY - Kunci API dari Capital.com
• CAP_IDENTIFIER - Email login
• CAP_API_PASSWORD - Kata sandi khusus kunci API

Kontrol Risiko (Disarankan)

• CAP_ALLOW_TRADING - Aktifkan trading (default: false)
• CAP_ALLOWED_EPICS - Daftar izin yang dipisahkan koma (misalnya, "SILVER,GOLD,BTCUSD") atau "ALL" untuk tanpa batasan
• CAP_MAX_POSITION_SIZE - Ukuran posisi maksimum (default: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Ukuran pesanan maksimum (default: 1.0)
• CAP_MAX_OPEN_POSITIONS - Posisi bersamaan maksimum (default: 3)
• CAP_MAX_ORDERS_PER_DAY - Batas pesanan harian (default: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Wajibkan confirm=true (default: true)
• CAP_DRY_RUN - Blokir semua eksekusi trading (default: false)

Opsional

• CAP_DEFAULT_ACCOUNT_ID - Akun default setelah login
• CAP_HTTP_TIMEOUT_S - Batas waktu HTTP (default: 15)
• CAP_LOG_LEVEL - Tingkat log: DEBUG, INFO, WARNING, ERROR (default: INFO)

Kemampuan MCP

38 alat di 6 kategori, 7 prompt alur kerja, dan 4 sumber daya hanya-baca.

Kategori	Alat	Deskripsi
Sesi	4	Login, logout, status, keep-alive
Data Pasar	6	Cari, detail, harga, sentimen, navigasi
Akun	6	Daftar akun, preferensi, riwayat aktivitas/transaksi, isi ulang demo
Trading	13	Pratinjau, eksekusi, tutup posisi; daftar/batalkan/ubah pesanan berjalan; konfirmasi
Daftar Pantauan	6	Buat, daftar, dapatkan, hapus daftar pantauan; tambah/hapus pasar
Streaming	3	Harga real-time, peringatan, P&L portofolio melalui WebSocket

Prompt	Deskripsi
market_scan	Pindai daftar pantauan untuk kondisi trading
trade_proposal	Rencanakan trading dengan penentuan ukuran berbasis risiko (hanya pratinjau)
execute_trade	Eksekusi trading yang telah dipratinjau sebelumnya
position_review	Analisis posisi terbuka dan eksposur (hanya-baca)
live_price_monitor	Pelacakan harga real-time dengan peringatan pergerakan (WebSocket)
real_time_alerts	Peringatan level harga bersyarat (WebSocket)
live_portfolio_monitor	Dasbor P&L portofolio langsung (WebSocket)

Sumber Daya	Deskripsi
cap://status	Kesehatan server, status sesi, batas kecepatan
cap://risk-policy	Konfigurasi manajemen risiko dan lapisan validasi
cap://allowed-epics	Konfigurasi daftar izin trading
cap://market-cache/{epic}	Detail pasar yang di-cache (pengambilan langsung)

Untuk detail lengkap, parameter, dan contoh lihat USAGE.md.

Proses Eksekusi Trading

Alur Dua Langkah yang Wajib

Semua operasi dengan efek samping menggunakan alur pratinjau → eksekusi yang ketat:

1. Pratinjau: Validasi trading terhadap aturan broker + kebijakan risiko lokal

   • Mengembalikan preview_id dengan permintaan yang dinormalisasi + pemeriksaan risiko
   • Tanpa efek samping, validasi hanya-baca

2. Eksekusi: Kirim trading menggunakan preview_id

   • Menjalankan ulang pemeriksaan penting
   • Memerlukan confirm=true jika CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Memeriksa konfirmasi broker
   • Menambah penghitung pesanan harian

Kontrol Risiko

• Daftar Izin: Hanya EPIC di CAP_ALLOWED_EPICS yang dapat diperdagangkan
• Batas Ukuran: Ukuran posisi/pesanan maksimum diberlakukan
• Batas Posisi: Posisi terbuka maksimum setiap saat
• Batas Harian: Pesanan maksimum per hari
• Normalisasi Ukuran: Membulatkan ke min/maks/kenaikan broker
• Mode Dry-Run: Memblokir semua eksekusi saat diaktifkan

Dokumentasi

• Panduan Penggunaan: USAGE.md - Panduan penggunaan komprehensif dengan contoh
• Referensi API Capital.com: https://open-api.capital.com/
• Koleksi Postman API Capital.com: https://github.com/capital-com-sv/capital-api-postman

Lisensi

MIT

Kebijakan Privasi

Server MCP Capital.com berjalan secara lokal di mesin Anda dan berkomunikasi langsung dengan Capital.com Public API menggunakan kredensial yang Anda berikan. Server ini tidak beroperasi sebagai layanan yang di-hosting dan tidak memiliki server sendiri.

Pengumpulan data

Server MCP tidak mengumpulkan atau menyimpan data apa pun. Server ini bertindak sebagai jembatan lokal antara klien AI Anda dan Capital.com Public API.

Penggunaan dan penyimpanan data

Semua data yang dipertukarkan selama sesi diproses dalam memori di mesin lokal Anda dan dibuang saat sesi berakhir. Tidak ada data yang ditulis ke disk oleh server MCP. Catatan: Klien AI Anda dapat memproses, mencatat, atau menyimpan data yang diteruskannya sesuai dengan kebijakan privasinya sendiri, yang harus Anda tinjau secara terpisah.

Berbagi dengan pihak ketiga

Server MCP tidak membagikan data kepada pihak ketiga mana pun. Data hanya mengalir antara lingkungan lokal Anda dan Capital.com Public API, sesuai dengan Kebijakan Privasi Capital.com sendiri.

Retensi data

Server MCP tidak menyimpan data apa pun. Data sesi hanya ada di memori selama sesi berlangsung.

Kredensial API

Kredensial API yang Anda berikan disimpan dan dikelola di lingkungan lokal Anda. Anda bertanggung jawab untuk mengamankannya dengan tepat.

Kontak

Untuk pertanyaan terkait privasi mengenai akun Capital.com Anda atau bagaimana Capital.com menangani data Anda, rujuk ke Kebijakan Privasi Capital.com atau hubungi support@capital.com.

Penyangkalan – Penggunaan Capital.com Public API dengan Alat Pihak Ketiga

Integrasi Pihak Ketiga

Halaman ini menjelaskan bagaimana klien dapat menghubungkan Capital.com Public API ke perangkat lunak, alat, atau integrasi pihak ketiga, termasuk yang didukung oleh kecerdasan buatan atau model bahasa besar ('LLM'). Perangkat lunak, alat, atau integrasi pihak ketiga mana pun bersifat independen dari Capital.com dan bukan merupakan bagian dari layanan Capital.com. Capital.com tidak mengendalikan, mengembangkan, mendukung, atau menerima tanggung jawab apa pun atas perangkat lunak pihak ketiga mana pun, fungsinya, keluarannya, atau hasil apa pun yang timbul dari penggunaannya. Penggunaan alat atau integrasi pihak ketiga apa pun sehubungan dengan Capital.com Public API sepenuhnya merupakan risiko Anda sendiri. Anda bertanggung jawab untuk meninjau ketentuan, kebijakan privasi, dan praktik penanganan data dari alat pihak ketiga mana pun yang Anda pilih untuk digunakan.

Penggunaan Public API

Penggunaan Anda atas Capital.com Public API sepenuhnya merupakan kebijaksanaan dan risiko Anda sendiri. Capital.com menyediakan Public API untuk tujuan informasi dan trading tetapi tidak merekomendasikan, mendukung, atau mendorong penggunaan, integrasi, atau strategi trading tertentu. Anda sepenuhnya bertanggung jawab atas cara Anda mengakses dan menggunakan API, termasuk parameter dari pesanan apa pun yang diajukan, konfigurasi alat atau sistem yang terhubung, dan interpretasi data apa pun yang diterima. Capital.com tidak menerima tanggung jawab atas kerugian atau hasil yang tidak diinginkan yang timbul dari penggunaan API, baik diakses langsung maupun melalui alat pihak ketiga. Ketersediaan API, fungsionalitas, dan spesifikasi dapat dimodifikasi, dibatasi kecepatannya, ditangguhkan, atau dihentikan kapan saja tanpa pemberitahuan sebelumnya. Penggunaan Anda atas Public API tunduk pada Syarat dan Ketentuan serta Ketentuan Trading Elektronik Capital.com, yang harus Anda baca dengan cermat sebelum menggunakan API.

Layanan Execution-Only dan Tanpa Nasihat Investasi

Capital.com menyediakan layanannya atas dasar execution-only. Trading instrumen keuangan melibatkan risiko kerugian yang signifikan. Tidak ada apa pun di halaman ini, di Public API, atau di perangkat lunak atau integrasi pihak ketiga mana pun yang merupakan nasihat investasi, rekomendasi pribadi, atau ajakan untuk membeli atau menjual instrumen keuangan apa pun. Ini termasuk keluaran, sinyal, saran, atau analisis apa pun yang dihasilkan oleh AI, alat berbasis LLM, atau alat otomatis lainnya. Semua keputusan trading, termasuk aktivitas otomatis atau algoritmik apa pun, dibuat dengan risiko Anda sendiri dan tetap menjadi tanggung jawab Anda sepenuhnya. Capital.com tidak mengendalikan keluaran alat AI atau berbasis LLM pihak ketiga yang terhubung ke Public API dan tidak dapat menjamin bahwa alat tersebut tidak akan menghasilkan konten yang dapat ditafsirkan sebagai nasihat investasi atau rekomendasi pribadi. Keluaran semacam itu tidak disediakan oleh atau atas nama Capital.com dan tidak boleh diandalkan sebagai nasihat.

Risiko Perdagangan Otomatis dan Algoritmik

Penggunaan Public API sehubungan dengan alat perdagangan otomatis atau algoritmik membawa risiko tambahan, termasuk namun tidak terbatas pada: eksekusi pesanan secara cepat tanpa tinjauan atau intervensi manusia; kesalahan sistem, kegagalan perangkat lunak, atau masalah konektivitas; eksekusi pada harga yang berbeda secara material dari yang diharapkan; dan pesanan yang tidak disengaja atau keliru akibat alat atau parameter yang salah konfigurasi. Capital.com tidak bertanggung jawab atas kerugian apa pun yang timbul dari risiko tersebut atau dari interaksi antara sistemnya dengan alat pihak ketiga mana pun. Kinerja masa lalu dan keluaran apa pun yang dihasilkan oleh alat otomatis tidak menunjukkan hasil di masa depan.

Jika alat berbasis AI atau LLM digunakan untuk mengambil data pasar atau informasi harga, mungkin ada penundaan antara harga yang dikomunikasikan oleh alat tersebut dan harga saat pesanan yang dihasilkan dieksekusi. Semua pesanan yang ditempatkan melalui Public API dieksekusi sebagai market order. Harga eksekusi karena itu dapat berbeda dari harga apa pun yang ditampilkan pada saat permintaan. Capital.com berupaya mencapai eksekusi terbaik sesuai dengan kewajibannya; kami tidak menerima tanggung jawab atas perbedaan harga yang timbul dari latensi yang disebabkan oleh alat atau sistem pihak ketiga di luar kendali kami.

Penggunaan yang Dilarang

Penggunaan Public API dan alat terhubung apa pun tidak boleh digunakan untuk memanipulasi platform Capital.com, mengeksploitasi harga atau latensi, melakukan penyalahgunaan pasar, atau memperoleh keuntungan yang tidak adil. Capital.com berhak untuk membatasi, menangguhkan, atau menghentikan akses API dan/atau akun Anda jika dianggap wajar bahwa penyalahgunaan tersebut telah terjadi atau kemungkinan akan terjadi. Klien tidak boleh mengizinkan pihak ketiga mana pun untuk menjalankan kendali diskresioner atas akun mereka.

Tanggung Jawab Anda

Anda bertanggung jawab untuk memastikan bahwa penggunaan Anda atas platform Capital.com, Public API, dan alat atau integrasi pihak ketiga mana pun mematuhi Syarat dan Ketentuan Capital.com, Ketentuan Perdagangan Elektronik, serta semua hukum dan peraturan yang berlaku di yurisdiksi Anda. Anda harus mempertimbangkan dengan cermat apakah alat perdagangan otomatis sesuai untuk keadaan, pengalaman, dan toleransi risiko Anda sebelum menggunakannya. Capital.com sangat menyarankan Anda untuk menguji alat atau integrasi otomatis secara menyeluruh menggunakan akun Demo sebelum menghubungkannya ke lingkungan perdagangan langsung.