FxSocket

npx add-mcp 'https://mcp.fxsocket.com/mcp'

Server MetaTrader MCP

Berikan agen AI akses baca ke akun MetaTrader 4 dan MetaTrader 5 Anda. Server FxSocket MCP memungkinkan Claude, Cursor, VS Code, dan klien Model Context Protocol lainnya menjawab pertanyaan tentang trading Anda: saldo dan ekuitas di seluruh akun, apa yang sedang terbuka saat ini, bagaimana bulan lalu berjalan, kuotasi langsung, dan riwayat harga. Ini hanya-baca. Tidak ada alat yang dapat memasang, mengubah, atau menutup order.

URL server https://mcp.fxsocket.com/mcp

1. Buat kunci API hanya-baca

Di halaman API Key, buat kunci hanya-baca. Kunci ini diawali dengan fxs_ro_, dapat memanggil setiap alat di sini, dan juga tidak dapat melakukan trading melalui endpoint lain mana pun. Beri nama dan batasi ke akun yang boleh dilihat agen, sehingga agen tidak pernah tahu akun lain itu ada. Kunci fxs_live_ lengkap Anda juga berfungsi, tetapi agen tidak memerlukannya.

2. Hubungkan klien Anda

Klien yang menerima URL server jarak jauh dan header terhubung langsung. Klien yang hanya menjalankan server lokal, seperti Claude Desktop, menggunakan image Docker.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"

{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

Klien lain mana pun bekerja dengan cara yang sama: arahkan ke https://mcp.fxsocket.com/mcp dengan kunci di header X-API-Key (Authorization: Bearer juga diterima), atau jalankan image Docker sebagai server lokal.

Alat

Delapan alat, semuanya hanya-baca. Masing-masing dibentuk berdasarkan pertanyaan, bukan endpoint, sehingga "apa yang terbuka di seluruh akun saya" adalah satu panggilan yang membaca setiap terminal sekaligus.

• list_accounts: Setiap akun yang dapat dilihat kunci, dengan id, nama panggilan, platform, server, login, dan status koneksi, secara opsional dengan saldo, ekuitas, dan total per mata uang. Agen memanggilnya terlebih dahulu.
• get_account: Satu akun secara lengkap: saldo, ekuitas, margin, level margin, dan leverage, pengaturan akun seperti level stop-out, serta kesehatan terminal.
• get_open_positions: Posisi terbuka dan order tertunda di seluruh akun, dapat difilter berdasarkan simbol dan tipe, dengan laba mengambang, swap, dan total per mata uang.
• get_trade_history: Trade tertutup untuk suatu periode (default 7 hari terakhir, hingga 366), dengan kemenangan, kerugian, tingkat kemenangan, laba bersih, trade terbaik dan terburuk, serta rincian per simbol.
• search_symbols: Nama simbol persis dari broker. EURUSD adalah EURUSD.sd atau EURUSDm di sebagian broker, jadi agen mencarinya sebelum meminta harga.
• get_quotes: Bid, ask, dan spread langsung untuk hingga 20 simbol.
• get_symbol_info: Spesifikasi kontrak: digit, ukuran kontrak, nilai tick, batas volume, tarif swap, komisi, dan sesi trading.
• get_price_history: Candlestick OHLC untuk suatu simbol dan timeframe, hingga 500 bar per panggilan.

Yang dapat Anda tanyakan

• "Berapa total ekuitas saya di seluruh akun, per mata uang?"
• "Posisi terbuka mana yang sedang merugi saat ini, dan berapa besar?"
• "Berapa tingkat kemenangan saya pada XAUUSD bulan lalu, dan apa trade terburuk saya?"
• "Bandingkan spread EURUSD di setiap broker saya."
• "Ambil 200 candlestick H1 terakhir GBPUSD dan jelaskan trennya."

Hanya-baca secara desain

Server tidak dapat melakukan trading karena apa yang dapat dijangkau kodenya, bukan karena suatu pengaturan: setiap alat membaca dari terminal dan tidak satu pun dapat mengirim order. Jadi agen yang bingung atau dimanipulasi tetap tidak dapat membuka, mengubah, atau menutup posisi.

Uang dilaporkan dalam mata uang deposit masing-masing akun dan tidak pernah dijumlahkan lintas mata uang; alat mengembalikan total per mata uang sehingga model tidak perlu melakukan aritmetika itu. Waktu adalah waktu server broker, seperti di seluruh bagian lain API.

Batas: 60 permintaan per menit per pengguna, hingga 50 akun dan 300 baris order atau trade dalam satu balasan. Jumlah dan total selalu mencakup semuanya; hanya daftar baris yang dipotong.

Jalankan secara lokal dengan Docker

Image fxsocket/mcp menjalankan server sebagai proses stdio lokal, untuk klien yang menjalankan servernya sendiri. Ini adalah relay kecil, satu file Python tanpa dependensi, yang meneruskan setiap pesan ke mcp.fxsocket.com dengan kunci Anda. Alat dan data Anda tetap berasal dari FxSocket, jadi image tidak pernah perlu diperbarui saat alat berubah. Diterbitkan untuk amd64 dan arm64.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · Sumber di GitHub (MIT)

Detail protokol

• Transport: Streamable HTTP, hanya POST, respons JSON. Stateless, tanpa sesi yang perlu dijaga tetap hidup.
• Versi protokol: 2026-07-28 (metadata per permintaan, tanpa handshake) dan 2025-03-26 hingga 2025-11-25 (handshake initialize).
• Autentikasi: kunci API yang sama dengan API platform, di X-API-Key atau Authorization: Bearer.
• Belum didukung: konektor web di claude.ai dan ChatGPT, yang masuk dengan OAuth alih-alih header. Claude Desktop berfungsi hari ini melalui image Docker.