FxSocket
आधिकारिकहोस्ट किए गए MetaTrader 4 और MT5 खातों तक केवल-पढ़ने की पहुँच: बैलेंस और इक्विटी, खुली पोज़िशन और पेंडिंग ऑर्डर, ट्रेड, सर्च, लाइव कोट्स और कैंडल्स।
FxSocket MCP के साथ आप क्या कर सकते हैं?
- खाता अवलोकन — वह हर खाता सूचीबद्ध करें जिसे कुंजी देख सकती है, जिसमें प्लेटफ़ॉर्म, सर्वर, कनेक्शन स्थिति, और प्रति मुद्रा बैलेंस या इक्विटी योग शामिल हैं।
- खुला एक्सपोज़र — खातों में खुली पोज़िशन और लंबित ऑर्डर दिखाएँ, प्रतीक या प्रकार से फ़िल्टर करें, साथ में फ़्लोटिंग लाभ, स्वैप, और योग।
- ट्रेड इतिहास समीक्षा — 366 दिनों तक की अवधि के बंद ट्रेडों का सारांश दें, जिसमें जीत दर, शुद्ध लाभ, सर्वश्रेष्ठ और सबसे खराब ट्रेड, और प्रति-प्रतीक विवरण शामिल हैं।
- प्रतीक लुकअप — कीमतों का अनुरोध करने से पहले ब्रोकर का सटीक प्रतीक नाम खोजें, क्योंकि EURUSD जैसे नाम ब्रोकर के अनुसार भिन्न होते हैं।
- लाइव कोट्स और स्पेक्स — 20 प्रतीकों तक के लिए बिड, आस्क, और स्प्रेड प्राप्त करें, साथ ही टिक मूल्य, वॉल्यूम सीमाएँ, स्वैप दरें, और सत्र जैसे अनुबंध विवरण।
- मूल्य इतिहास — किसी प्रवृत्ति का वर्णन करने के लिए किसी प्रतीक और टाइमफ़्रेम के लिए OHLC कैंडल प्राप्त करें, प्रति कॉल 500 बार तक।
होस्ट किया गया MCP सर्वर
npx add-mcp 'https://mcp.fxsocket.com/mcp'Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है
दस्तावेज़
MetaTrader MCP सर्वर
किसी AI एजेंट को अपने MetaTrader 4 और MetaTrader 5 खातों तक पढ़ने की पहुँच दें। FxSocket MCP सर्वर Claude, Cursor, VS Code और किसी भी अन्य Model Context Protocol क्लाइंट को आपकी ट्रेडिंग से जुड़े सवालों के जवाब देने की सुविधा देता है: सभी खातों में बैलेंस और इक्विटी, अभी क्या खुला है, पिछला महीना कैसा रहा, लाइव कोट्स और मूल्य इतिहास। यह केवल पढ़ने के लिए है। कोई भी टूल ऑर्डर नहीं लगा सकता, बदल सकता या बंद कर सकता है।
सर्वर URL https://mcp.fxsocket.com/mcp
1. केवल-पढ़ने वाली API कुंजी बनाएँ
API Key पेज पर, एक केवल-पढ़ने वाली कुंजी बनाएँ। यह fxs_ro_ से शुरू होती है, यहाँ के हर टूल को कॉल कर सकती है, और किसी अन्य एंडपॉइंट के ज़रिए ट्रेड भी नहीं कर सकती। इसे एक नाम दें और इसे केवल उन्हीं खातों तक सीमित करें जिन्हें एजेंट को देखना चाहिए, ताकि एजेंट को कभी पता ही न चले कि अन्य खाते मौजूद हैं। आपकी पूरी fxs_live_ कुंजी भी काम करती है, लेकिन एजेंट के लिए ऐसी कुंजी का कोई उपयोग नहीं है।
2. अपना क्लाइंट कनेक्ट करें
जो क्लाइंट रिमोट सर्वर URL और हेडर स्वीकार करते हैं, वे सीधे कनेक्ट हो जाते हैं। जो क्लाइंट केवल लोकल सर्वर शुरू करते हैं, जैसे Claude Desktop, वे 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" }
}
}
}
कोई भी अन्य क्लाइंट इसी तरह काम करता है: इसे https://mcp.fxsocket.com/mcp पर इंगित करें और कुंजी को X-API-Key हेडर में रखें (Authorization: Bearer भी स्वीकार किया जाता है), या Docker इमेज को लोकल सर्वर के रूप में चलाएँ।
टूल्स
आठ टूल्स, सभी केवल-पढ़ने वाले। हर एक किसी एंडपॉइंट के बजाय किसी सवाल के इर्द-गिर्द बनाया गया है, इसलिए "मेरे सभी खातों में क्या खुला है" एक ही कॉल है जो एक साथ हर टर्मिनल को पढ़ती है।
list_accounts: वह हर खाता जिसे कुंजी देख सकती है, उसकी id, उपनाम, प्लेटफ़ॉर्म, सर्वर, लॉगिन और कनेक्शन स्थिति के साथ, वैकल्पिक रूप से बैलेंस, इक्विटी और प्रति मुद्रा कुल के साथ। एजेंट इसे सबसे पहले कॉल करते हैं।get_account: एक खाता पूरी तरह: बैलेंस, इक्विटी, मार्जिन, मार्जिन लेवल और लीवरेज, स्टॉप-आउट लेवल जैसी खाता सेटिंग्स, और टर्मिनल की सेहत।get_open_positions: सभी खातों में खुली पोज़िशन और पेंडिंग ऑर्डर, सिंबल और प्रकार के अनुसार फ़िल्टर करने योग्य, फ़्लोटिंग प्रॉफ़िट, स्वैप और प्रति मुद्रा कुल के साथ।get_trade_history: किसी अवधि के लिए बंद ट्रेड (डिफ़ॉल्ट रूप से पिछले 7 दिन, अधिकतम 366), जीत, हार, जीत दर, शुद्ध लाभ, सबसे अच्छा और सबसे खराब ट्रेड, और सिंबल के अनुसार विवरण के साथ।search_symbols: ब्रोकर का सटीक सिंबल नाम। कुछ ब्रोकरों पर EURUSD, EURUSD.sd या EURUSDm होता है, इसलिए एजेंट कीमतें माँगने से पहले इसे देख लेते हैं।get_quotes: अधिकतम 20 सिंबल के लिए लाइव bid, ask और spread।get_symbol_info: कॉन्ट्रैक्ट विनिर्देश: digits, कॉन्ट्रैक्ट साइज़, tick मान, वॉल्यूम सीमाएँ, स्वैप दरें, कमीशन और ट्रेडिंग सत्र।get_price_history: किसी सिंबल और टाइमफ़्रेम के लिए OHLC कैंडल, प्रति कॉल अधिकतम 500 बार।
आप क्या पूछ सकते हैं
- "मेरे सभी खातों में मेरी कुल इक्विटी कितनी है, प्रति मुद्रा?"
- "अभी कौन-सी खुली पोज़िशन घाटे में हैं, और कितने में?"
- "पिछले महीने XAUUSD पर मेरी जीत दर क्या थी, और मेरा सबसे खराब ट्रेड कौन-सा था?"
- "मेरे हर ब्रोकर पर EURUSD spread की तुलना करें।"
- "GBPUSD की पिछली 200 H1 कैंडल निकालें और ट्रेंड का वर्णन करें।"
डिज़ाइन से केवल-पढ़ने योग्य
सर्वर ट्रेड नहीं कर सकता क्योंकि उसका कोड किस तक पहुँच सकता है, न कि किसी सेटिंग के कारण: हर टूल टर्मिनल से पढ़ता है और उनमें से कोई भी ऑर्डर नहीं भेज सकता। इसलिए कोई भ्रमित या हेरफेर किया गया एजेंट भी पोज़िशन नहीं खोल सकता, बदल सकता या बंद कर सकता।
धनराशि प्रत्येक खाते की जमा मुद्रा में बताई जाती है और कभी भी मुद्राओं के आर-पार नहीं जोड़ी जाती; टूल्स प्रति मुद्रा कुल लौटाते हैं ताकि मॉडल को वह गणित न करना पड़े। समय ब्रोकर सर्वर समय है, जैसा कि API में हर जगह है।
सीमाएँ: प्रति उपयोगकर्ता प्रति मिनट 60 अनुरोध, एक उत्तर में अधिकतम 50 खाते और 300 ऑर्डर या ट्रेड पंक्तियाँ। गणनाएँ और कुल हमेशा सब कुछ कवर करते हैं; केवल पंक्ति सूचियाँ काटी जाती हैं।
इसे Docker के साथ लोकल रूप से चलाएँ
fxsocket/mcp इमेज सर्वर को लोकल stdio प्रक्रिया के रूप में चलाती है, उन क्लाइंट के लिए जो अपने सर्वर स्वयं शुरू करते हैं। यह एक छोटा रिले है, बिना किसी निर्भरता वाली एक Python फ़ाइल, जो हर संदेश को आपकी कुंजी के साथ mcp.fxsocket.com को भेजती है। टूल्स और आपका डेटा अभी भी FxSocket से आते हैं, इसलिए टूल्स बदलने पर इमेज को कभी अपडेट करने की ज़रूरत नहीं पड़ती। amd64 और arm64 के लिए प्रकाशित।
FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp
Docker Hub · GitHub पर स्रोत (MIT)
प्रोटोकॉल विवरण
- ट्रांसपोर्ट: Streamable HTTP, केवल POST, JSON प्रतिक्रियाएँ। स्टेटलेस, जिसमें जीवित रखने के लिए कोई सत्र नहीं।
- प्रोटोकॉल संस्करण: 2026-07-28 (प्रति-अनुरोध मेटाडेटा, कोई हैंडशेक नहीं) और 2025-03-26 से 2025-11-25 तक (
initializeहैंडशेक)। - प्रमाणीकरण: प्लेटफ़ॉर्म API जैसी ही API कुंजियाँ,
X-API-KeyयाAuthorization: Bearerमें। - अभी तक समर्थित नहीं: claude.ai और ChatGPT में वेब कनेक्टर, जो हेडर के बजाय OAuth से साइन इन करते हैं। Claude Desktop आज Docker इमेज के ज़रिए काम करता है।