Trade Agent MCP Server

आधिकारिक

ट्रेड एजेंट के माध्यम से स्टॉक और क्रिप्टो ट्रेड निष्पादित करें

GitHub
54

दस्तावेज़

ट्रेड इट MCP सर्वर

👉 संपूर्ण दस्तावेज़ीकरण यहाँ 👈

अब आधिकारिक MCP रजिस्ट्री के माध्यम से उपलब्ध

विषय-सूची

अवलोकन

ट्रेड इट MCP सर्वर एजेंटों के लिए स्टॉक, क्रिप्टो और विकल्प ट्रेडिंग समर्थन लाता है। यह स्टॉक और क्रिप्टो ब्रोकरेज के साथ प्राकृतिक-भाषा में बातचीत सक्षम करता है—MCP प्रोटोकॉल के माध्यम से सरल-अंग्रेजी अनुरोध भेजकर ट्रेड निष्पादित करें, पोर्टफोलियो प्रदर्शन क्वेरी करें और बाजार अंतर्दृष्टि प्राप्त करें।

एंडपॉइंट:

  • स्ट्रीमेबल HTTP: https://mcp.tradeit.app/mcp
  • SSE: https://mcp.tradeit.app/sse

ब्रोकरेज समर्थन:

क्रिप्टो एक्सचेंज समर्थन:

जल्द ही और जोड़े जाएंगे!

यह सर्वर दूरस्थ है इसलिए आपको कनेक्ट करने के लिए स्थानीय रूप से कुछ भी चलाने की आवश्यकता नहीं है। बस अपने MCP-संगत एजेंट प्लेटफ़ॉर्म को ऊपर दिए गए URL पर इंगित करें।

शुरू करना

  1. सबसे पहले, https://tradeit.app. पर एक खाता बनाएं
  2. प्रो प्लान के मुफ्त परीक्षण के लिए साइन अप करें।
  3. अपनी पसंद की ब्रोकरेज कनेक्ट करें।

कनेक्ट करना

  1. अपने MCP क्लाइंट को https://mcp.tradeit.app/mcp या https://mcp.tradeit.app/sse से कनेक्ट करें।
  2. ब्राउज़र-आधारित OAuth प्रवाह के माध्यम से प्रमाणित करें।
  3. अब आप ट्रेडिंग शुरू करने के लिए तैयार हैं!

उपकरण

MCP उपकरण आपके एजेंट को लिंक्ड ब्रोकरेज से जोड़ते हैं: प्रतीक खोजें, खाते सूचीबद्ध करें, ड्राफ्ट ऑर्डर बनाएं, फिर पुष्टि के बाद ही निष्पादित करें।

MCP उपकरणयह क्या करता है
search_assetsटिकर या नाम से स्टॉक या क्रिप्टो खोजें; मूल्य और मेटाडेटा लौटाता है।
get_accountsलिंक्ड खाते और शेष राशि सूचीबद्ध करें; नई ब्रोकरेज लिंक करते समय भी उपयोग किया जाता है।
create_tradeसमीक्षा के लिए एक ड्राफ्ट इक्विटी/क्रिप्टो खरीद या बिक्री बनाएं।
create_options_tradeसमीक्षा के लिए एक ड्राफ्ट सिंगल- या मल्टी-लेग विकल्प ऑर्डर बनाएं।
execute_tradeस्पष्ट उपयोगकर्ता पुष्टि के बाद पहले से बनाए गए ड्राफ्ट को ब्रोकर को सबमिट करें।

सुरक्षा मॉडल (ड्राफ्ट-प्रथम)

ट्रेड draft ऑर्डर के रूप में शुरू होते हैं और जब तक उपयोगकर्ता स्पष्ट रूप से पुष्टि नहीं करता, तब तक ब्रोकर को नहीं भेजे जाते।

इच्छित प्रवाह:

  1. create_trade या create_options_trade कॉल करें → आपको एक trade_id के साथ एक ड्राफ्ट मिलता है।
  2. उपयोगकर्ता को पूर्ण ऑर्डर विवरण और आगे बढ़ने का तरीका दिखाएं।
  3. execute_trade को केवल तभी कॉल करें जब उपयोगकर्ता स्पष्ट रूप से निष्पादित करने, पुष्टि करने या ट्रेड लगाने के लिए कहे।
  4. ड्राफ्ट बनाने के तुरंत बाद स्वचालित रूप से execute_trade कॉल न करें।

ड्राफ्ट बनाने के बाद, सुनिश्चित करें कि उपयोगकर्ता जानता है कि वे तैयार होने पर ऑर्डर दे सकते हैं (जैसे आपके क्लाइंट के Execute नियंत्रण के माध्यम से, यदि उपलब्ध हो)।

ड्राफ्ट बनाने से पहले वैकल्पिक कदम:

  • search_assets — टिकर और संदर्भ की पुष्टि करें।
  • get_accounts — जब उपयोगकर्ता को यह ध्यान हो कि कौन सा खाता उपयोग करना है, तो सही account_id चुनें।

निष्पादन प्रवाह:

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → draft with trade_id, status: "draft"
       ↓
Show draft details; user confirms
       ↓
execute_trade(trade_id)
       ↓
Status: "placed" or "failed" (with details)

खाता / ऑर्डर डिफ़ॉल्ट: यदि उपयोगकर्ता राशि, खाता या ऑर्डर प्रकार छोड़ देता है, तो ट्रेड इट उनकी डिफ़ॉल्ट राशि, डिफ़ॉल्ट खाता और जहाँ लागू हो बाजार ऑर्डर लागू करता है। यदि ट्रेड इट सेटिंग्स में स्वतः-निष्पादन सक्षम है, तो कुछ सेटअप में व्यवहार मैन्युअल निष्पादन चरण को छोड़ सकता है; संदेह होने पर, फिर भी निष्पादन को उपयोगकर्ता-पुष्टि के रूप में मानें।

search_assets

टिकर या नाम से स्टॉक या क्रिप्टो खोजें।

  • पैरामीटर: query (स्ट्रिंग) — उदा. "TSLA", "Tesla", "bitcoin"।
  • लौटाता है: मूल्य, टिकर, एक्सचेंज, परिसंपत्ति प्रकार और संबंधित मेटाडेटा।

उदाहरण:

{ "query": "TSLA" }

प्राकृतिक-भाषा उदाहरण: "Apple कैसा चल रहा है?" · "TSLA का मूल्य क्या है?"

get_accounts

सभी लिंक्ड ब्रोकरेज खातों को सूचीबद्ध करें (और जब उपयोगकर्ता नई ब्रोकरेज कनेक्ट करना चाहे तो इस प्रवाह का उपयोग करें)।

  • पैरामीटर: कोई नहीं।
  • लौटाता है: id, name, brokerage, balance, available_cash के साथ खाते। जब किसी विशिष्ट खाते की आवश्यकता हो तो ट्रेड कॉल में account.id को account_id के रूप में उपयोग करें।

प्राकृतिक-भाषा उदाहरण: "मेरे खाते दिखाओ।"

create_trade

एक ड्राफ्ट इक्विटी या क्रिप्टो ऑर्डर बनाएं।

पैरामीटर:

फ़ील्डप्रकारआवश्यकविवरण
symbolस्ट्रिंगहाँटिकर, उदा. "TSLA"।
amountसंख्याहाँट्रेड करने का आकार।
unit"dollars" या "shares"हाँamount के लिए इकाई।
buy_or_sell"buy" या "sell"हाँदिशा।
order_type"market", "limit", "stop", "stop_limit"नहीं"market" पर डिफ़ॉल्ट।
limit_priceसंख्यायदि सीमा / स्टॉप_सीमालागू होने पर प्रति शेयर अधिकतम या न्यूनतम मूल्य।
stop_priceसंख्यायदि स्टॉप / स्टॉप_सीमास्टॉप ट्रिगर मूल्य।
time_in_force"day", "gtc", "ioc", "fok"नहींब्रोकरेज डिफ़ॉल्ट के लिए छोड़ें।
account_idसंख्यानहींडिफ़ॉल्ट खाते के लिए छोड़ें।

ऑर्डर प्रकार:

प्रकारकब उपयोग करेंमूल्य फ़ील्ड
marketवर्तमान बाजार पर भरेंकोई नहीं
limitकेवल limit_price या बेहतर परlimit_price
stopबाजार ऑर्डर stop_price पर ट्रिगर होता हैstop_price
stop_limitसीमा ऑर्डर stop_price पर ट्रिगर होता हैstop_price और limit_price

JSON उदाहरण:

Apple के $500 बाजार पर खरीदें:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

NVDA के 10 शेयर केवल तभी खरीदें यदि यह $800 या उससे नीचे गिरता है:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

Meta के 5 शेयर बेचें यदि मूल्य $450 तक गिरता है (स्टॉप):

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

10 AAPL खरीदें यदि यह $200 से ऊपर टूटता है, अधिकतम $202/शेयर का भुगतान करते हुए:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

$1,000 का Bitcoin खरीदें:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

Tesla के 100 शेयर बेचें, रद्द होने तक अच्छा:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

प्राकृतिक-भाषा उदाहरण: "$1000 का Tesla खरीदें" · "$1000 का Tesla केवल तभी खरीदें यदि मूल्य $150 या उससे कम हो जाए" · "Apple के 10 शेयर बेचें यदि मूल्य $140 तक गिरता है" · "Apple का एक शेयर खरीदें यदि यह $200 को छूता है" · "Apple के 10 शेयर खरीदें यदि यह $140 तक बढ़ता है, लेकिन $142 से अधिक भुगतान न करें"

create_options_trade

एक ड्राफ्ट सिंगल-लेग या मल्टी-लेग विकल्प ऑर्डर बनाएं (स्प्रेड, स्ट्रैडल, आदि)।

पैरामीटर:

फ़ील्डप्रकारआवश्यकविवरण
symbolस्ट्रिंगहाँअंतर्निहित टिकर, उदा. "SPY"।
legsसरणीहाँएक या अधिक लेग (नीचे देखें)।
direction"debit" या "credit"मल्टी-लेग"debit" = आप भुगतान करते हैं; "credit" = आप एकत्र करते हैं।
order_type"market", "limit", आदि।नहीं"market" पर डिफ़ॉल्ट।
limit_priceसंख्यासीमा के लिएपैकेज के लिए शुद्ध डेबिट/क्रेडिट सीमा।
time_in_force"day" या "gtc"नहींडिफ़ॉल्ट के लिए छोड़ें।
account_idसंख्यानहींडिफ़ॉल्ट खाते के लिए छोड़ें।

प्रत्येक लेग:

फ़ील्डप्रकारआवश्यकविवरण
type"option" या "equity"हाँलेग प्रकार।
action"buy" या "sell"हाँलेग का पक्ष।
position_effect"open" या "close"विकल्पनई स्थिति खोलें या मौजूदा बंद करें।
occस्ट्रिंग या nullविकल्पOCC स्ट्रिंग (नीचे); इक्विटी लेग के लिए null।
quantityसंख्याहाँअनुबंध (विकल्प) या शेयर (इक्विटी)।

OCC विकल्प प्रतीक प्रारूप

OCC स्ट्रिंग इस प्रकार होती है: YYMMDD + C या P + 8-अंकीय स्ट्राइक (स्ट्राइक × 1000, शून्य-पैडेड)।

विवरणOCC
20 जून, 2025 $250 कॉल250620C00250000
20 जून, 2025 $260 कॉल250620C00260000
21 मार्च, 2025 $500 पुट250321P00500000
19 दिसंबर, 2025 $1,500 कॉल251219C01500000
16 जनवरी, 2026 $50 पुट260116P00050000

स्ट्राइक एन्कोडिंग: डॉलर को 1,000 से गुणा करें और 8 अंकों तक पैड करें (जैसे $250 → 00250000; $50.50 → 00050500)।

विकल्प JSON उदाहरण

एकल कॉल — 1 SPY $520 कॉल खरीदें जो 20 जून, 2025 को समाप्त हो रहा है:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

बुल कॉल स्प्रेड (डेबिट) — $250 कॉल खरीदें, $260 कॉल बेचें, समान समाप्ति:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

बियर पुट स्प्रेड (डेबिट):

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

बुल पुट स्प्रेड (क्रेडिट):

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

सीमा के साथ स्प्रेड — शुद्ध डेबिट $3.50 या बेहतर:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

लॉन्ग कॉल बंद करें — 2 AAPL $200 कॉल बेचकर बंद करें जो 21 मार्च, 2025 को समाप्त हो रहे हैं:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

स्ट्रैडल — लॉन्ग $250 कॉल और $250 पुट, समान समाप्ति:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

प्राकृतिक-भाषा उदाहरण: "1 AAPL $300 कॉल खरीदें जो अगले महीने समाप्त हो रहा है" · "MSFT पर $500 स्ट्राइक पर कवर्ड कॉल" · "TSLA कॉल स्प्रेड: $475 खरीदें / $485 बेचें, अगले सप्ताह" · "इस शुक्रवार SPY पर ATM स्ट्रैडल" · "2 AMZN पुट, सीमा $3.50" · "AMZN260130P00200000 बेचें"

execute_trade

उपयोगकर्ता द्वारा समीक्षा करने के बाद ब्रोकरेज को एक ड्राफ्ट भेजें।

  • पैरामीटर: trade_id (संख्या) — create_trade या create_options_trade से ड्राफ्ट का id।
  • लौटाता है: अद्यतन ट्रेड; स्थिति "placed" या "failed" (त्रुटि विवरण के साथ)।

केवल तभी कॉल करें जब उपयोगकर्ता स्पष्ट रूप से पुष्टि करे (जैसे निष्पादित करें, पुष्टि करें, इसे लगाएं, आगे बढ़ें)। उस ट्रेड की पुष्टि करें जो उन्होंने अभी समीक्षा की है।

ड्राफ्ट बनाने के तुरंत बाद, ऑर्डर विवरण दिखाए बिना, या जब स्थिति "draft" न हो, स्वचालित रूप से कॉल न करें।

ट्रेड स्थिति संदर्भ

स्थितिअर्थ
draftबनाया गया; अभी तक ब्रोकर को नहीं भेजा गया
pendingसबमिट किया गया; ब्रोकर पावती की प्रतीक्षा में
placedस्वीकृत; भराव की प्रतीक्षा में
partially_filledआंशिक रूप से भरा गया
completeपूरी तरह से भरा गया
canceledरद्द किया गया
failedअस्वीकृत — त्रुटियाँ जाँचें
disconnectedब्रोकरेज कनेक्शन समस्या

ब्रोकरेज आईडी (API सहायक)

ब्रोकरेजआईडीविकल्प
Robinhood1हाँ
E*TRADE2हाँ
Coinbase3केवल क्रिप्टो
Kraken5केवल क्रिप्टो
Charles Schwab7हाँ
Webull8हाँ
Public11हाँ
Tastytrade12हाँ

स्पष्टीकरण: एक बार पूछें, अपनी ज़रूरत की हर चीज़ के साथ, जब: ऑर्डर प्रकार अस्पष्ट हो (जैसे “TSLA $200 पर खरीदें” — सीमा बनाम स्टॉप), विकल्पों में समाप्ति/स्ट्राइक गायब हो, कई खाते लागू हों और कोई चुना न गया हो, या एक प्रतीक एक से अधिक परिसंपत्ति का अर्थ हो सकता है। जब डिफ़ॉल्ट स्पष्ट हों तो अनावश्यक प्रश्न छोड़ें (डिफ़ॉल्ट राशि, बाजार ऑर्डर, प्राथमिक खाता)।

अस्वीकरण

  • निवेश में जोखिम शामिल है, जिसमें मूलधन की संभावित हानि भी शामिल है।
  • ट्रेड इट एक वित्तीय सलाहकार नहीं है और निवेश सलाह प्रदान नहीं करता है।
  • विकल्पों में पर्याप्त जोखिम शामिल है और ये सभी निवेशकों के लिए उपयुक्त नहीं हैं।
  • ट्रेड इट धन निकाल नहीं सकता, परिसंपत्तियाँ स्थानांतरित नहीं कर सकता, या अभिरक्षा नहीं ले सकता — यह केवल आपकी लिंक्ड ब्रोकरेज के माध्यम से ट्रेड लगा सकता है।