FxSocket

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

MetaTrader MCP sunucusu

Bir yapay zekâ ajanına MetaTrader 4 ve MetaTrader 5 hesaplarınıza okuma erişimi verin. FxSocket MCP sunucusu, Claude, Cursor, VS Code ve diğer tüm Model Context Protocol istemcilerinin trading'inizle ilgili soruları yanıtlamasını sağlar: hesaplar arası bakiye ve öz sermaye, şu anda açık olanlar, geçen ayın nasıl geçtiği, canlı fiyat teklifleri ve fiyat geçmişi. Salt okunurdur. Hiçbir araç emir veremez, değiştiremez veya kapatamaz.

Sunucu URL'si https://mcp.fxsocket.com/mcp

1. Salt okunur bir API anahtarı oluşturun

API Key sayfasında salt okunur bir anahtar oluşturun. fxs_ro_ ile başlar, buradaki her aracı çağırabilir ve başka hiçbir uç nokta üzerinden işlem yapamaz. Adlandırın ve ajanın görmesi gereken hesaplarla sınırlayın; böylece ajan diğerlerinin varlığını asla öğrenmez. Tam yetkili fxs_live_ anahtarınız da çalışır, ancak bir ajanın buna ihtiyacı yoktur.

2. İstemcinizi bağlayın

Uzak bir sunucu URL'si ve bir başlık kabul eden istemciler doğrudan bağlanır. Yalnızca yerel sunucuları başlatan istemciler, örneğin Claude Desktop, Docker imajını kullanır.

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

Diğer tüm istemciler aynı şekilde çalışır: istemciyi https://mcp.fxsocket.com/mcp adresine yönlendirin ve anahtarı bir X-API-Key başlığına koyun (Authorization: Bearer de kabul edilir) veya Docker imajını yerel bir sunucu olarak çalıştırın.

Araçlar

Sekiz araç, hepsi salt okunur. Her biri bir uç nokta yerine bir soru etrafında şekillendirilmiştir; böylece "hesaplarımda açık olan ne var" tek bir çağrıdır ve tüm terminalleri aynı anda okur.

• list_accounts: Anahtarın görebildiği her hesap; kimliği, takma adı, platformu, sunucusu, giriş bilgisi ve bağlantı durumuyla, isteğe bağlı olarak bakiye, öz sermaye ve para birimi başına toplamlarla. Ajanlar önce bunu çağırır.
• get_account: Tek bir hesap tüm ayrıntılarıyla: bakiye, öz sermaye, marj, marj seviyesi ve kaldıraç, stop-out seviyesi gibi hesap ayarları ve terminal sağlığı.
• get_open_positions: Hesaplar arası açık pozisyonlar ve bekleyen emirler; sembol ve türe göre filtrelenebilir, yüzen kâr, swap ve para birimi başına toplamlarla.
• get_trade_history: Bir dönem için kapatılmış işlemler (varsayılan olarak son 7 gün, en fazla 366), kazançlar, kayıplar, kazanma oranı, net kâr, en iyi ve en kötü işlem ve sembole göre bir dökümle.
• search_symbols: Broker'ın tam sembol adı. Bazı broker'larda EURUSD, EURUSD.sd veya EURUSDm'dir; bu yüzden ajanlar fiyat istemeden önce bunu arar.
• get_quotes: En fazla 20 sembol için canlı alış, satış ve spread.
• get_symbol_info: Sözleşme spesifikasyonu: basamaklar, sözleşme boyutu, tick değeri, hacim limitleri, swap oranları, komisyonlar ve işlem seansları.
• get_price_history: Bir sembol ve zaman dilimi için OHLC mumları, çağrı başına en fazla 500 bar.

Neler sorabilirsiniz

• "Tüm hesaplarımda toplam öz sermayem para birimi başına ne kadar?"
• "Şu anda hangi açık pozisyonlar zararda ve ne kadar?"
• "Geçen ay XAUUSD'de kazanma oranım neydi ve en kötü işlemim hangisiydi?"
• "Her broker'ımdaki EURUSD spread'ini karşılaştır."
• "GBPUSD'nin son 200 H1 mumunu çek ve trendi tanımla."

Tasarım gereği salt okunur

Sunucu işlem yapamaz çünkü kodunun erişebildiği şeyler buna izin vermez, bir ayar yüzünden değil: her araç terminalden okur ve hiçbiri emir gönderemez. Bu yüzden kafası karışmış veya manipüle edilmiş bir ajan bile bir pozisyon açamaz, değiştiremez veya kapatamaz.

Para, her hesabın mevduat para biriminde raporlanır ve para birimleri arasında asla toplanmaz; araçlar para birimi başına toplamları döndürür, böylece modelin bu aritmetiği yapması gerekmez. Zamanlar, API'nin her yerinde olduğu gibi broker sunucu zamanıdır.

Limitler: kullanıcı başına dakikada 60 istek, tek bir yanıtta en fazla 50 hesap ve 300 emir veya işlem satırı. Sayımlar ve toplamlar her zaman her şeyi kapsar; yalnızca satır listeleri kesilir.

Docker ile yerel olarak çalıştırın

fxsocket/mcp imajı, sunucularını kendileri başlatan istemciler için sunucuyu yerel bir stdio süreci olarak çalıştırır. Bağımlılığı olmayan tek bir Python dosyasından oluşan küçük bir aktarıcıdır ve her mesajı anahtarınızla mcp.fxsocket.com adresine iletir. Araçlar ve verileriniz hâlâ FxSocket'ten gelir, bu yüzden araçlar değiştiğinde imajın güncellenmesi gerekmez. amd64 ve arm64 için yayınlanmıştır.

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

Docker Hub · GitHub'da kaynak (MIT)

Protokol ayrıntıları

• Taşıma: Streamable HTTP, yalnızca POST, JSON yanıtları. Durumsuz, canlı tutulacak oturum yok.
• Protokol sürümleri: 2026-07-28 (istek başına meta veri, el sıkışma yok) ve 2025-03-26 ile 2025-11-25 arası (initialize el sıkışması).
• Kimlik doğrulama: platform API ile aynı API anahtarları, X-API-Key veya Authorization: Bearer içinde.
• Henüz desteklenmiyor: claude.ai ve ChatGPT'deki web bağlayıcıları; bunlar bir başlık yerine OAuth ile oturum açar. Claude Desktop bugün Docker imajı aracılığıyla çalışır.