Capital.com Public API MCP Server
आधिकारिकCapital.com MCP सर्वर आपके AI सहायक को सीधे आपके ट्रेडिंग खाते से बात करने देता है। बाजार डेटा, पोजीशन जांच, ट्रेड पूर्वावलोकन – सभी सरल भाषा में, आपके AI टूल को छोड़े बिना।
Capital Com Public API MCP के साथ आप क्या कर सकते हैं?
- सत्र स्थिति जांचें और लॉग इन करें — सहायक से अपने कनेक्शन की पुष्टि करने और
cap_session_statusतथाcap_session_loginका उपयोग करके प्रमाणीकरण करने के लिए कहें। - बाजार खोजें और निरीक्षण करें —
cap_market_searchके साथ "Bitcoin" या "GOLD" जैसे उपकरण खोजें, फिर विवरण, ऐतिहासिक मूल्य या ग्राहक भावना प्राप्त करें। - जोखिम नियंत्रण के साथ ट्रेड का पूर्वावलोकन और निष्पादन करें —
cap_trade_preview_positionके माध्यम से एक स्थिति का पूर्वावलोकन करें, सामान्यीकृत आकार और जांच की समीक्षा करें, फिरcap_trade_execute_position(इसके लिएconfirm=trueआवश्यक है) के साथ निष्पादित करें। - स्थितियों और कार्यशील ऑर्डरों की निगरानी करें —
cap_trade_positions_listके साथ खुली स्थितियों की सूची देखें, ऑर्डर स्थिति जांचें, और आवश्यकतानुसार बंद या रद्द करें। - वॉचलिस्ट प्रबंधित करें —
cap_watchlists_create,cap_watchlists_add_marketऔर संबंधित टूल का उपयोग करके वॉचलिस्ट बनाएं, देखें और अपडेट करें। - रीयल-टाइम मूल्य और पोर्टफोलियो P&L स्ट्रीम करें —
cap_stream_pricesके माध्यम से लाइव मूल्य अपडेट की सदस्यता लें याcap_stream_portfolio(WebSocket) के साथ पोर्टफोलियो P&L ट्रैक करें।
दस्तावेज़
Capital.com MCP सर्वर
Capital.com Open API के लिए मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर - आपके Capital.com ट्रेडिंग खाते तक LLM-संचालित पहुँच सक्षम करता है।
⚠️ महत्वपूर्ण सूचना
Capital.com पब्लिक API और इससे जुड़ने वाले किसी भी तृतीय-पक्ष उपकरण, जिसमें AI या LLM-आधारित उपकरण शामिल हैं, का आपका उपयोग आपके अपने विवेक और जोखिम पर है। Capital.com केवल निष्पादन-आधारित आधार पर काम करता है और किसी भी तृतीय-पक्ष सॉफ़्टवेयर, उसके आउटपुट या किसी भी परिणामी परिणामों को नियंत्रित, समर्थन या उसके लिए दायित्व स्वीकार नहीं करता है। इस पृष्ठ पर कुछ भी निवेश सलाह या व्यापार करने की अनुशंसा नहीं है। आप अपने खाते पर सभी ट्रेडिंग निर्णयों, कॉन्फ़िगरेशन और स्वचालित गतिविधि के लिए पूरी तरह से जिम्मेदार हैं, और आपको यह सुनिश्चित करना होगा कि आपका उपयोग Capital.com के नियम और शर्तों, इलेक्ट्रॉनिक ट्रेडिंग शर्तों और आपके अधिकार क्षेत्र के सभी लागू कानूनों का अनुपालन करता है।
क्रिप्टो डेरिवेटिव Capital Com (UK) Ltd के साथ पंजीकृत खुदरा ग्राहकों के लिए उपलब्ध नहीं हैं।
- लाइव ट्रेडिंग पर विचार करने से पहले हमेशा डेमो खाते से शुरुआत करें
- ट्रेडिंग डिफ़ॉल्ट रूप से अक्षम है और इसके लिए स्पष्ट कॉन्फ़िगरेशन की आवश्यकता होती है
- सभी व्यापार संचालन के लिए दो-चरणीय निष्पादन (पूर्वावलोकन → पुष्टि → निष्पादित) की आवश्यकता होती है
- अंतर्निहित जोखिम नियंत्रण: अनुमति सूची, आकार सीमाएँ, दैनिक ऑर्डर सीमाएँ
- अपने जोखिम पर उपयोग करें - लेखक व्यापारिक नुकसान के लिए कोई दायित्व नहीं लेते हैं
आगे के प्रश्नों/स्पष्टीकरणों के लिए, कृपया FAQ देखें: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server
त्वरित आरंभ मार्गदर्शिका
चरण 1: Capital.com API क्रेडेंशियल प्राप्त करें
-
खाता बनाएँ: capital.com/trading/signup पर जाएँ
- परीक्षण के लिए डेमो खाता चुनें (अनुशंसित)
- अपना ईमेल सत्यापित करें
-
2FA सक्षम करें: सेटिंग्स > सुरक्षा > दो-कारक प्रमाणीकरण
- API कुंजी उत्पन्न करने से पहले आवश्यक
-
API कुंजी उत्पन्न करें: सेटिंग्स > API एकीकरण > नई कुंजी उत्पन्न करें
- एक लेबल सेट करें (जैसे, "MCP सर्वर")
- एक कस्टम पासवर्ड सेट करें (यह आपका प्लेटफ़ॉर्म पासवर्ड नहीं है)
- दिखाई गई API कुंजी सहेजें (केवल एक बार प्रदर्शित!)
- नोट: API कुंजियाँ ट्रेडिंग-सक्षम हैं; Capital.com केवल-पढ़ने के लिए कुंजियाँ प्रदान नहीं करता है
चरण 2: स्थापित और कॉन्फ़िगर करें
आपके पास दो स्थापना विकल्प हैं:
विकल्प A: MCPB बंडल के माध्यम से एक-क्लिक स्थापना (अनुशंसित)
रेपो एक manifest.json शिप करता है जो MCPB (MCP बंडल) कल्पना के अनुरूप है — स्थानीय MCP सर्वरों को पैकेज करने के लिए Anthropic का खुला मानक। यह आपको कॉन्फ़िग फ़ाइलों को मैन्युअल रूप से संपादित किए बिना Claude Desktop (और अन्य MCPB-संगत क्लाइंट) में सर्वर स्थापित करने देता है।
पूर्वापेक्षाएँ: uv (सर्वर अपने रनटाइम के रूप में uv का उपयोग करता है — brew install uv के साथ स्थापित करें या uv डॉक्स देखें)।
चरण:
- रेपो क्लोन करें और
.mcpbबंडल बनाएँ (npxके लिए Node.js की आवश्यकता है):git clone https://github.com/capital-com-sv/capital-mcp.git cd capital-mcp npx @anthropic-ai/mcpb pack . capital-mcp.mcpb - Claude Desktop में
capital-mcp.mcpbखोलें (डबल-क्लिक करें, या इसे ऐप में खींचें)। - Claude Desktop आपसे उपयोगकर्ता कॉन्फ़िग मान (API कुंजी, पहचानकर्ता, पासवर्ड, ट्रेडिंग नियंत्रण) के लिए संकेत करेगा। उन्हें भरें और स्थापित करें पर क्लिक करें।
- Claude Desktop को पुनरारंभ करें और पूछकर सत्यापित करें: "कौन से Capital.com उपकरण उपलब्ध हैं?"
अतिरिक्त आदेशों (validate, info, unpack, sign) के लिए MCPB CLI संदर्भ देखें।
विकल्प B: स्क्रिप्ट के माध्यम से मैन्युअल स्थापना
पूर्वापेक्षाएँ: Python 3.10+ और Git स्थापित होना चाहिए।
- macOS:
brew install python3 git - Ubuntu/Debian:
sudo apt install python3 python3-venv git - Windows: python.org (स्थापना के दौरान "PATH में जोड़ें" चेक करें) + git-scm.com
Mac/Linux:
cd /path/to/capital-mcp
./install.sh
Windows (PowerShell):
cd C:\path\to\capital-mcp
pwsh install.ps1
इंस्टॉल स्क्रिप्ट एक वर्चुअल वातावरण बनाएगी, निर्भरताएँ स्थापित करेगी, और आपके लिए MCP क्लाइंट कॉन्फ़िगरेशन प्रिंट करेगी।
अपने क्रेडेंशियल्स के साथ .env संपादित करें:
# 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
चरण 3: सर्वर का स्थानीय रूप से परीक्षण करें
Mac/Linux:
source venv/bin/activate
python -m capital_mcp.server
Windows (PowerShell):
.\venv\Scripts\Activate.ps1
python -m capital_mcp.server
आपको देखना चाहिए:
INFO - Starting Capital.com MCP Server (env: demo)
INFO - Trading enabled: False
रोकने के लिए Ctrl+C दबाएँ।
समस्या निवारण: लॉग जाँचें
यदि आपको Claude Desktop या अन्य क्लाइंट के साथ MCP सर्वर का उपयोग करते समय समस्याएँ आती हैं, तो लॉग फ़ाइलें जाँचें:
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
एकीकरण
नोट:
/path/to/capital-mcp/venv/bin/pythonको अपने वास्तविक venv Python पथ से बदलें। इंस्टॉल स्क्रिप्ट आपके लिए इसे प्रिंट करती है। Windows पर,C:\path\to\capital-mcp\venv\Scripts\python.exeका उपयोग करें।
Claude Desktop
💡 सुझाव: यदि आपने MCPB बंडल (ऊपर विकल्प A) के माध्यम से स्थापित किया है, तो इस अनुभाग को छोड़ दें — Claude Desktop आपके लिए
manifest.jsonके आधार पर कॉन्फ़िग लिखता है। इस अनुभाग का उपयोग केवल मैन्युअल स्क्रिप्ट स्थापनाओं के लिए करें।
macOS/Linux
कॉन्फ़िग स्थान: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) या ~/.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 को पुनरारंभ करें। टाइप करके सत्यापित करें: "कौन से Capital.com उपकरण उपलब्ध हैं?"
Windows
कॉन्फ़िग स्थान: %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 को पुनरारंभ करें।
Claude Code
claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server
Cursor IDE
सेटिंग्स खोलें (Cmd+, / Ctrl+,) > एक्सटेंशन > MCP > कॉन्फ़िगर करें। जोड़ें:
{
"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 को पुनरारंभ करें।
Codex
सेटिंग्स > MCP सर्वर > सर्वर जोड़ें। ऊपर दिए गए समान कमांड, args और env vars का उपयोग करें।
Windsurf
~/.windsurf/mcp/servers.json बनाएँ/संपादित करें:
{
"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 को पुनरारंभ करें।
कस्टम MCP क्लाइंट
कोई भी STDIO-सक्षम MCP क्लाइंट काम करता है। Node.js के साथ उदाहरण:
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
उपयोग के उदाहरण
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
व्यापार निष्पादन वर्कफ़्लो (जब ट्रेडिंग सक्षम हो)
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"
पर्यावरण चर संदर्भ
आवश्यक
CAP_ENV- वातावरण:demoयाlive(डिफ़ॉल्ट: डेमो)CAP_API_KEY- Capital.com से API कुंजीCAP_IDENTIFIER- लॉगिन ईमेलCAP_API_PASSWORD- API कुंजी कस्टम पासवर्ड
जोखिम नियंत्रण (अनुशंसित)
CAP_ALLOW_TRADING- ट्रेडिंग सक्षम करें (डिफ़ॉल्ट: गलत)CAP_ALLOWED_EPICS- अल्पविराम से अलग अनुमति सूची (जैसे, "SILVER,GOLD,BTCUSD") या अप्रतिबंधित के लिए "ALL"CAP_MAX_POSITION_SIZE- अधिकतम स्थिति आकार (डिफ़ॉल्ट: 1.0)CAP_MAX_WORKING_ORDER_SIZE- अधिकतम ऑर्डर आकार (डिफ़ॉल्ट: 1.0)CAP_MAX_OPEN_POSITIONS- अधिकतम समवर्ती स्थितियाँ (डिफ़ॉल्ट: 3)CAP_MAX_ORDERS_PER_DAY- दैनिक ऑर्डर सीमा (डिफ़ॉल्ट: 20)CAP_REQUIRE_EXPLICIT_CONFIRM- confirm=true आवश्यक करें (डिफ़ॉल्ट: सही)CAP_DRY_RUN- सभी व्यापार निष्पादन अवरुद्ध करें (डिफ़ॉल्ट: गलत)
वैकल्पिक
CAP_DEFAULT_ACCOUNT_ID- लॉगिन के बाद डिफ़ॉल्ट खाताCAP_HTTP_TIMEOUT_S- HTTP टाइमआउट (डिफ़ॉल्ट: 15)CAP_LOG_LEVEL- लॉग स्तर: DEBUG, INFO, WARNING, ERROR (डिफ़ॉल्ट: INFO)
MCP उपकरण (36 कार्यान्वित)
सत्र (4)
cap_session_status- सत्र जानकारी प्राप्त करेंcap_session_login- सत्र बनाएँcap_session_ping- जीवित रखेंcap_session_logout- सत्र समाप्त करें
बाज़ार डेटा (6)
cap_market_search- बाज़ार खोजेंcap_market_get- बाज़ार विवरण प्राप्त करेंcap_market_prices- ऐतिहासिक मूल्यcap_market_sentiment- ग्राहक भावनाcap_market_navigation_root- बाज़ार श्रेणियाँ रूटcap_market_navigation_node- बाज़ार श्रेणियाँ नोड
खाता (6)
cap_account_list- खातों की सूची बनाएँcap_account_preferences_get- प्राथमिकताएँ प्राप्त करेंcap_account_preferences_set- प्राथमिकताएँ सेट करेंcap_account_history_activity- गतिविधि इतिहासcap_account_history_transactions- लेन-देन इतिहासcap_account_demo_topup- डेमो खाता टॉप अप करें
ट्रेडिंग (11)
-
केवल-पढ़ने के लिए:
cap_trade_positions_list- स्थितियों की सूची बनाएँcap_trade_positions_get- स्थिति विवरण प्राप्त करेंcap_trade_orders_list- कार्यशील ऑर्डरों की सूची बनाएँcap_trade_confirm_get- पुष्टिकरण स्थिति प्राप्त करेंcap_trade_confirm_wait- पुष्टिकरण की प्रतीक्षा करें
-
पूर्वावलोकन:
cap_trade_preview_position- स्थिति का पूर्वावलोकन करेंcap_trade_preview_working_order- ऑर्डर का पूर्वावलोकन करें
-
निष्पादित करें:
cap_trade_execute_position- स्थिति निष्पादित करेंcap_trade_execute_working_order- ऑर्डर निष्पादित करेंcap_trade_positions_close- स्थिति बंद करेंcap_trade_orders_cancel- ऑर्डर रद्द करें
वॉचलिस्ट (6)
cap_watchlists_list- वॉचलिस्ट की सूची बनाएँcap_watchlists_create- वॉचलिस्ट बनाएँcap_watchlists_get- वॉचलिस्ट प्राप्त करेंcap_watchlists_add_market- बाज़ार जोड़ेंcap_watchlists_delete- वॉचलिस्ट हटाएँcap_watchlists_remove_market- बाज़ार हटाएँ
स्ट्रीमिंग (3)
cap_stream_prices- रीयल-टाइम मूल्य स्ट्रीम करें (WebSocket)cap_stream_alerts- मूल्य स्तर अलर्ट स्ट्रीम करें (WebSocket)cap_stream_portfolio- लाइव पोर्टफोलियो P&L स्ट्रीम करें (WebSocket)
MCP प्रॉम्प्ट (वर्कफ़्लो टेम्पलेट)
MCP प्रॉम्प्ट संरचित वर्कफ़्लो हैं जो Claude को जटिल बहु-चरणीय ट्रेडिंग संचालन के माध्यम से मार्गदर्शन करते हैं। वे सामान्य कार्यों के लिए चरण-दर-चरण निर्देश और सर्वोत्तम अभ्यास प्रदान करते हैं।
उपलब्ध प्रॉम्प्ट (7)
1. market_scan - बाज़ार विश्लेषण वर्कफ़्लो
ट्रेडिंग स्थितियों के लिए वॉचलिस्ट को स्कैन करने में आपका मार्गदर्शन करता है।
पैरामीटर:
watchlist_id- स्कैन करने के लिए वॉचलिस्ट (पहले वॉचलिस्ट सूचीबद्ध करने के लिए खाली छोड़ें)timeframe- मूल्य रिज़ॉल्यूशन: MINUTE, MINUTE_5, HOUR, DAY (डिफ़ॉल्ट: HOUR)lookback_periods- लाने के लिए कैंडल की संख्या: 1-1000 (डिफ़ॉल्ट: 24)
वर्कफ़्लो:
- वॉचलिस्ट बाज़ार प्राप्त करें
- प्रत्येक बाज़ार के लिए मूल्य डेटा प्राप्त करें
- तकनीकी विश्लेषण (रुझान, समर्थन/प्रतिरोध, पैटर्न)
- वैकल्पिक भावना जाँच
- अवसर सारांश उत्पन्न करें
उदाहरण उपयोग:
- "मेरी वॉचलिस्ट का विश्लेषण करने के लिए market_scan प्रॉम्प्ट का उपयोग करें"
- "ट्रेडिंग सेटअप के लिए मेरे बाज़ारों को स्कैन करें"
वास्तविक ट्रेडिंग: अपने कॉन्फ़िगरेशन को इसमें बदलें: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'
2. trade_proposal - व्यापार योजना वर्कफ़्लो
जोखिम प्रबंधन उपकरणों के साथ एक व्यापार प्रस्ताव बनाने में आपका मार्गदर्शन करता है।
पैरामीटर:
epic- व्यापार करने के लिए बाज़ार (आवश्यक, जैसे, SILVER, GOLD)direction- BUY या SELL (डिफ़ॉल्ट: BUY)thesis- आपका ट्रेडिंग तर्क (वैकल्पिक)risk_percent- शेष राशि के % के रूप में जोखिम (डिफ़ॉल्ट: 1.0%)
वर्कफ़्लो:
- बाज़ार विवरण और डीलिंग नियम प्राप्त करें
- जोखिम % के आधार पर स्थिति आकार की गणना करें
- स्टॉप लॉस और टेक प्रॉफिट स्तर परिभाषित करें
- व्यापार का पूर्वावलोकन करें (केवल सत्यापन - कोई निष्पादन नहीं)
- संभावित निष्पादन के लिए preview_id लौटाएँ
उदाहरण उपयोग:
- "SILVER के लिए एक व्यापार प्रस्ताव बनाएँ"
- "2% जोखिम के साथ GOLD पर एक लंबे व्यापार का प्रस्ताव करें"
नोट: यह प्रॉम्प्ट व्यापार निष्पादित नहीं करता है - यह केवल पूर्वावलोकन बनाता है।
3. execute_trade - व्यापार निष्पादन वर्कफ़्लो
पूर्वावलोकन किए गए व्यापार को निष्पादित करने में आपका मार्गदर्शन करता है।
पैरामीटर:
preview_id- trade_proposal से पूर्वावलोकन आईडी (आवश्यक)
वर्कफ़्लो:
- सत्यापित करें कि preview_id प्रदान किया गया है और मान्य है
- सभी जोखिम नियंत्रणों की पुनः जाँच करें
- ब्रोकर के साथ स्थिति निष्पादित करें
- पुष्टिकरण के लिए पोल करें (स्वीकृत/अस्वीकृत)
- अंतिम स्थिति की रिपोर्ट करें
उदाहरण उपयोग:
- "मेरे द्वारा अभी पूर्वावलोकन किए गए व्यापार को निष्पादित करें"
- "पूर्वावलोकन आईडी abc-123 के साथ व्यापार करें"
नोट:
- CAP_ALLOW_TRADING=true की आवश्यकता है
- अनुमति सूची में epic की आवश्यकता है
- पूर्वावलोकन समाप्त नहीं होना चाहिए (2-मिनट TTL)
- ⚠️ यह एक वास्तविक व्यापार करेगा
4. position_review - पोर्टफोलियो विश्लेषण वर्कफ़्लो
आपकी खुली स्थितियों और ऑर्डरों का विश्लेषण करने में आपका मार्गदर्शन करता है।
पैरामीटर: कोई नहीं (सभी मौजूदा स्थितियों का विश्लेषण करता है)
वर्कफ़्लो:
- सभी खुली स्थितियाँ प्राप्त करें
- सभी कार्यशील ऑर्डर प्राप्त करें
- P&L, जोखिम और एक्सपोज़र मेट्रिक्स की गणना करें
- एकाग्रता और सहसंबंध जोखिमों की पहचान करें
- संभावित समायोजन सुझाएँ (निष्पादित किए बिना)
उदाहरण उपयोग:
- "मेरी वर्तमान स्थितियों की समीक्षा करें"
- "मेरे पोर्टफोलियो एक्सपोज़र का विश्लेषण करें"
नोट: यह एक केवल-पढ़ने वाला वर्कफ़्लो है - कोई व्यापार निष्पादित नहीं किया जाता है।
5. live_price_monitor - रीयल-टाइम मूल्य ट्रैकिंग (WebSocket)
जब मूल्य एक सीमा से अधिक बढ़ जाते हैं तो तत्काल अलर्ट के साथ लाइव बाज़ार मूल्यों की निगरानी करें।
पैरामीटर:
epics- निगरानी करने के लिए बाज़ार EPIC की सूची (खोजने/चुनने के लिए खाली छोड़ें, अधिकतम 40)duration_minutes- कितनी देर तक निगरानी करनी है (डिफ़ॉल्ट: 5 मिनट, अधिकतम: 10 मिनट)threshold_percent- जब मूल्य इस % से अधिक बढ़ जाए तो अलर्ट करें (डिफ़ॉल्ट: 1.0%)
वर्कफ़्लो:
- निगरानी करने के लिए बाज़ार चुनें (या सीधे EPIC प्रदान करें)
- आधार रेखा स्थापित करने के लिए प्रारंभिक मूल्य प्राप्त करें
- रीयल-टाइम WebSocket मूल्य अपडेट की सदस्यता लें
- निरंतर अपडेट के साथ लाइव मूल्य बोर्ड प्रदर्शित करें
- जब कोई बाज़ार threshold_percent से अधिक बढ़ जाए तो अलर्ट करें
- duration_minutes के बाद ऑटो-स्टॉप करें
उदाहरण उपयोग:
- "2 मिनट के लिए GOLD और SILVER की कीमतों की निगरानी करें"
- "अगले 5 मिनट के लिए BTC देखें, 2% चाल पर अलर्ट करें"
नोट:
CAP_WS_ENABLED=trueआवश्यक है। Capital.com वेबसॉकेट सत्र अधिकतम 10 मिनट तक चलते हैं।
6. real_time_alerts - सशर्त मूल्य अलर्ट (वेबसॉकेट)
मूल्य स्तर अलर्ट सेट करें और जब बाज़ार आपके लक्ष्य तक पहुँचें तो तुरंत सूचनाएँ प्राप्त करें।
पैरामीटर:
alert_config- प्रति EPIC अलर्ट स्तर (जैसे,{"GOLD": 2050.0, "SILVER": 28.5})duration_minutes- अधिकतम निगरानी अवधि (डिफ़ॉल्ट: 5 मिनट)auto_stop- पहले अलर्ट के बाद निगरानी रोकें? (डिफ़ॉल्ट: true)
कार्यप्रवाह:
- अलर्ट शर्तें कॉन्फ़िगर करें (प्रत्येक बाज़ार के लिए मूल्य स्तर)
- वेबसॉकेट मूल्य अपडेट की सदस्यता लें
- अलर्ट ट्रिगर के लिए लगातार निगरानी करें
- शर्त पूरी होने पर तुरंत अलर्ट भेजें
- वैकल्पिक रूप से निगरानी जारी रखें या पहले अलर्ट के बाद रोकें
उदाहरण उपयोग:
- "जब GOLD 2050 पर पहुँचे तो मुझे अलर्ट करें"
- "जब SILVER 28 से नीचे गिरे तो सूचित करें"
नोट: CAP_WS_ENABLED=true आवश्यक है।
7. live_portfolio_monitor - रीयल-टाइम P&L ट्रैकिंग (वेबसॉकेट)
बाज़ार मूल्यों में बदलाव के साथ अपने पोर्टफोलियो P&L को रीयल-टाइम में अपडेट होते देखें।
पैरामीटर:
duration_minutes- निगरानी अवधि (डिफ़ॉल्ट: 5 मिनट, अधिकतम: 10 मिनट)alert_pnl_threshold- जब कुल P&L इस राशि से अधिक हो जाए तो अलर्ट करें (डिफ़ॉल्ट: $100)
कार्यप्रवाह:
- वर्तमान खुली स्थितियाँ प्राप्त करें
- स्थिति बाज़ारों के लिए मूल्य अपडेट की सदस्यता लें
- मूल्यों में बदलाव के अनुसार लाइव P&L की गणना करें
- रीयल-टाइम पोर्टफोलियो डैशबोर्ड प्रदर्शित करें
- जब P&L सीमा पार करे तो अलर्ट करें
उदाहरण उपयोग:
- "5 मिनट के लिए मेरे पोर्टफोलियो P&L की निगरानी करें"
- "रीयल-टाइम में स्थितियाँ देखें, $500 P&L पर अलर्ट करें"
नोट: CAP_WS_ENABLED=true और सक्रिय स्थितियाँ आवश्यक हैं।
प्रॉम्प्ट का उपयोग कैसे करें
Claude Desktop या अन्य MCP क्लाइंट में, प्रॉम्प्ट उपलब्ध इंटरैक्शन पैटर्न के रूप में दिखाई देते हैं। आप उन्हें बातचीत में स्वाभाविक रूप से लागू कर सकते हैं:
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]
प्रॉम्प्ट संपूर्ण कार्यप्रवाह के दौरान ट्रेडिंग नियंत्रण बनाए रखते हुए संरचित मार्गदर्शन प्रदान करते हैं।
MCP संसाधन (केवल-पढ़ने योग्य डेटा)
MCP संसाधन URI-आधारित संसाधनों के माध्यम से सर्वर स्थिति और कॉन्फ़िगरेशन तक केवल-पढ़ने योग्य पहुँच प्रदान करते हैं। उपकरणों के विपरीत (जो कार्रवाइयाँ करते हैं), संसाधन वह डेटा उजागर करते हैं जिसे क्लाइंट पढ़ और मॉनिटर कर सकते हैं।
उपलब्ध संसाधन
1. cap://status - सर्वर स्थिति
रीयल-टाइम सर्वर और सत्र जानकारी।
रिटर्न: सर्वर स्वास्थ्य, सत्र स्थिति, प्रमाणीकरण स्थिति, दर सीमाओं के साथ JSON
उदाहरण:
{
"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"
}
}
उपयोग के मामले: सर्वर स्वास्थ्य की निगरानी करें, सत्र स्थिति जाँचें, प्रमाणीकरण समस्याओं को डीबग करें
2. cap://risk-policy - जोखिम नीति
व्यापक जोखिम प्रबंधन कॉन्फ़िगरेशन और ट्रेडिंग नियंत्रण।
रिटर्न: सभी सत्यापन परतों, ट्रेडिंग नियंत्रण सुविधाओं और ट्रेडिंग प्रतिबंधों के साथ JSON
उदाहरण:
{
"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
}
}
उपयोग के मामले: सक्रिय ट्रेडिंग नियंत्रणों को समझें, जोखिम कॉन्फ़िगरेशन का ऑडिट करें, अनुपालन दस्तावेज़ीकरण
3. cap://allowed-epics - ट्रेडिंग अनुमति-सूची
वर्तमान ट्रेडिंग अनुमति-सूची कॉन्फ़िगरेशन जो अनुमत बाज़ारों को दर्शाता है।
रिटर्न: अनुमति-सूची मोड, अनुमत epics और कॉन्फ़िगरेशन निर्देशों के साथ JSON
उदाहरण:
{
"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)"
}
}
उपयोग के मामले: जाँचें कि कौन से बाज़ार व्यापार योग्य हैं, अनुमति-सूची कॉन्फ़िगरेशन सत्यापित करें
4. cap://market-cache/{epic} - बाज़ार विवरण (गतिशील)
किसी विशिष्ट epic के लिए कैश्ड बाज़ार विवरण (ब्रोकर से लाइव प्राप्ति)।
पैरामीटर:
epic- बाज़ार पहचानकर्ता (जैसे, "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")
रिटर्न: व्यापक बाज़ार जानकारी के साथ JSON
प्रमाणीकरण: आवश्यक
उदाहरण: 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"
}
उपयोग के मामले: बाज़ार विवरण प्राप्त करें, ट्रेडिंग नियम जाँचें, मार्जिन आवश्यकताओं का विश्लेषण करें
संसाधनों का उपयोग कैसे करें
Claude Desktop या अन्य MCP क्लाइंट में, संसाधनों को URI द्वारा एक्सेस किया जा सकता है:
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]
संसाधन उपकरणों को चलाए बिना सर्वर स्थिति और कॉन्फ़िगरेशन का निरीक्षण करने का एक सुविधाजनक तरीका प्रदान करते हैं। वॉचलिस्ट डेटा के लिए, cap_watchlists_list और cap_watchlists_get उपकरणों का उपयोग करें।
व्यापार निष्पादन प्रक्रिया
अनिवार्य दो-चरणीय निष्पादन
सभी साइड-इफ़ेक्ट ऑपरेशन एक सख्त पूर्वावलोकन → निष्पादन प्रवाह का उपयोग करते हैं:
-
पूर्वावलोकन: ब्रोकर नियमों + स्थानीय जोखिम नीति के विरुद्ध व्यापार को मान्य करें
- सामान्यीकृत अनुरोध + जोखिम जाँच के साथ
preview_idलौटाता है - कोई साइड इफ़ेक्ट नहीं, केवल-पढ़ने योग्य सत्यापन
- सामान्यीकृत अनुरोध + जोखिम जाँच के साथ
-
निष्पादित करें:
preview_idका उपयोग करके व्यापार सबमिट करें- महत्वपूर्ण जाँच पुनः चलाता है
- यदि
CAP_REQUIRE_EXPLICIT_CONFIRM=trueतोconfirm=trueआवश्यक है - ब्रोकर पुष्टि के लिए पोल करता है
- दैनिक ऑर्डर काउंटर बढ़ाता है
जोखिम नियंत्रण
- अनुमति-सूची: केवल
CAP_ALLOWED_EPICSमें मौजूद EPICs का व्यापार किया जा सकता है - आकार सीमाएँ: अधिकतम स्थिति/ऑर्डर आकार लागू
- स्थिति सीमाएँ: किसी भी समय अधिकतम खुली स्थितियाँ
- दैनिक सीमाएँ: प्रति दिन अधिकतम ऑर्डर
- आकार सामान्यीकरण: ब्रोकर न्यूनतम/अधिकतम/वृद्धि के अनुसार राउंड करता है
- ड्राई-रन मोड: सक्षम होने पर सभी निष्पादनों को रोकता है
दस्तावेज़ीकरण
- उपयोग मार्गदर्शिका: USAGE.md - उदाहरणों सहित व्यापक उपयोग मार्गदर्शिका
- Capital.com API संदर्भ: https://open-api.capital.com/
- Capital.com API पोस्टमैन संग्रह: https://github.com/capital-com-sv/capital-api-postman
लाइसेंस
MIT
अस्वीकरण – तृतीय-पक्ष उपकरणों के साथ Capital.com सार्वजनिक API का उपयोग
तृतीय-पक्ष एकीकरण
यह पृष्ठ वर्णन करता है कि ग्राहक Capital.com सार्वजनिक API को तृतीय-पक्ष सॉफ़्टवेयर, उपकरणों या एकीकरणों से कैसे जोड़ सकते हैं, जिनमें कृत्रिम बुद्धिमत्ता या बड़े भाषा मॉडल ('LLM') द्वारा संचालित शामिल हैं। ऐसा कोई भी तृतीय-पक्ष सॉफ़्टवेयर, उपकरण या एकीकरण Capital.com से स्वतंत्र है और Capital.com की सेवाओं का हिस्सा नहीं बनता है। Capital.com किसी भी तृतीय-पक्ष सॉफ़्टवेयर, उसकी कार्यक्षमता, आउटपुट या उसके उपयोग से उत्पन्न होने वाले किसी भी परिणाम को नियंत्रित, विकसित, समर्थन या उसके लिए कोई दायित्व स्वीकार नहीं करता है। Capital.com सार्वजनिक API के संबंध में तृतीय-पक्ष उपकरणों या एकीकरणों का कोई भी उपयोग पूरी तरह से आपके अपने जोखिम पर है। आप अपने द्वारा चुने गए किसी भी तृतीय-पक्ष उपकरण की शर्तों, गोपनीयता नीतियों और डेटा-हैंडलिंग प्रथाओं की समीक्षा करने के लिए जिम्मेदार हैं।
सार्वजनिक API का उपयोग
Capital.com सार्वजनिक API का आपका उपयोग पूरी तरह से आपके अपने विवेक और जोखिम पर है। Capital.com सार्वजनिक API को सूचनात्मक और ट्रेडिंग उद्देश्यों के लिए उपलब्ध कराता है लेकिन किसी विशेष उपयोग, एकीकरण या ट्रेडिंग रणनीति की अनुशंसा, समर्थन या प्रोत्साहन नहीं करता है। आप API तक पहुँचने और उसका उपयोग करने के तरीके के लिए पूरी तरह से जिम्मेदार हैं, जिसमें सबमिट किए गए किसी भी ऑर्डर के पैरामीटर, किसी भी कनेक्टेड टूल या सिस्टम का कॉन्फ़िगरेशन और प्राप्त किसी भी डेटा की व्याख्या शामिल है। Capital.com API के आपके उपयोग से उत्पन्न होने वाले नुकसान या अनपेक्षित परिणामों के लिए कोई दायित्व स्वीकार नहीं करता है, चाहे वह सीधे या तृतीय-पक्ष उपकरणों के माध्यम से एक्सेस किया गया हो। API उपलब्धता, कार्यक्षमता और विनिर्देशों को बिना किसी पूर्व सूचना के किसी भी समय संशोधित, दर-सीमित, निलंबित या बंद किया जा सकता है। आपका सार्वजनिक API का उपयोग Capital.com के नियम और शर्तों और इलेक्ट्रॉनिक ट्रेडिंग शर्तों के अधीन है, जिन्हें आपको API का उपयोग करने से पहले ध्यान से पढ़ना चाहिए।
केवल-निष्पादन सेवा और कोई निवेश सलाह नहीं Capital.com अपनी सेवाएँ केवल-निष्पादन के आधार पर प्रदान करता है। वित्तीय साधनों के व्यापार में नुकसान का महत्वपूर्ण जोखिम शामिल है। इस पृष्ठ पर, सार्वजनिक API में, या किसी भी तृतीय-पक्ष सॉफ़्टवेयर या एकीकरण में कुछ भी निवेश सलाह, व्यक्तिगत अनुशंसा या किसी वित्तीय साधन को खरीदने या बेचने का आग्रह नहीं है। इसमें AI, LLM-आधारित या अन्य स्वचालित उपकरणों द्वारा उत्पन्न कोई भी आउटपुट, सिग्नल, सुझाव या विश्लेषण शामिल है। सभी ट्रेडिंग निर्णय, जिनमें कोई भी स्वचालित या एल्गोरिथम गतिविधि शामिल है, आपके अपने जोखिम पर लिए जाते हैं और आपकी एकमात्र जिम्मेदारी बने रहते हैं। स्वचालित और एल्गोरिथम ट्रेडिंग के जोखिम स्वचालित या एल्गोरिथम ट्रेडिंग उपकरणों के संबंध में सार्वजनिक API के उपयोग में अतिरिक्त जोखिम शामिल हैं, जिनमें निम्नलिखित शामिल हैं लेकिन इन्हीं तक सीमित नहीं हैं: मानवीय समीक्षा या हस्तक्षेप के बिना ऑर्डरों का तीव्र निष्पादन; सिस्टम त्रुटियाँ, सॉफ़्टवेयर विफलताएँ या कनेक्टिविटी समस्याएँ; अपेक्षित कीमतों से भौतिक रूप से भिन्न कीमतों पर निष्पादन; और गलत कॉन्फ़िगर किए गए उपकरणों या पैरामीटरों से उत्पन्न अनपेक्षित या गलत ऑर्डर। Capital.com ऐसे जोखिमों से या अपने सिस्टम और किसी भी तृतीय-पक्ष उपकरण के बीच परस्पर क्रिया से उत्पन्न होने वाले किसी भी नुकसान के लिए जिम्मेदार नहीं है। पिछला प्रदर्शन और स्वचालित उपकरणों द्वारा उत्पन्न कोई भी आउटपुट भविष्य के परिणामों का संकेत नहीं हैं।
निषिद्ध उपयोग
सार्वजनिक API और किसी भी कनेक्टेड टूल का उपयोग Capital.com प्लेटफ़ॉर्म में हेरफेर करने, मूल्य निर्धारण या विलंबता का शोषण करने, बाज़ार दुरुपयोग में संलग्न होने या कोई अनुचित लाभ प्राप्त करने के लिए नहीं किया जाना चाहिए। Capital.com API पहुँच और/या आपके खाते को प्रतिबंधित, निलंबित या समाप्त करने का अधिकार सुरक्षित रखता है जहाँ वह यथोचित रूप से मानता है कि ऐसा दुरुपयोग हुआ है या होने की संभावना है। ग्राहकों को किसी भी तृतीय पक्ष को अपने खाते पर विवेकाधीन नियंत्रण रखने की अनुमति नहीं देनी चाहिए।
आपकी जिम्मेदारियाँ
आप यह सुनिश्चित करने के लिए जिम्मेदार हैं कि Capital.com प्लेटफ़ॉर्म, सार्वजनिक API और किसी भी तृतीय-पक्ष उपकरण या एकीकरण का आपका उपयोग Capital.com के नियम और शर्तों, इलेक्ट्रॉनिक ट्रेडिंग शर्तों और आपके अधिकार क्षेत्र के सभी लागू कानूनों और विनियमों का अनुपालन करता है। आपको स्वचालित ट्रेडिंग उपकरणों का उपयोग करने से पहले सावधानीपूर्वक विचार करना चाहिए कि क्या वे आपकी परिस्थितियों, अनुभव और जोखिम सहनशीलता के लिए उपयुक्त हैं। Capital.com दृढ़ता से अनुशंसा करता है कि आप किसी भी स्वचालित उपकरण या एकीकरण को लाइव ट्रेडिंग वातावरण से जोड़ने से पहले डेमो खाते का उपयोग करके उनका पूरी तरह से परीक्षण करें।