Trade Agent

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

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

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

विषय-सूची

• अवलोकन
• शुरू करना
• कनेक्ट करना
• उपकरण
  • सुरक्षा मॉडल (ड्राफ्ट-प्रथम)
  • search_assets
  • get_accounts
  • create_trade
  • create_options_trade
    • OCC विकल्प प्रतीक प्रारूप
    • विकल्प JSON उदाहरण
  • execute_trade
• ट्रेड स्थिति संदर्भ
• ब्रोकरेज आईडी (API सहायक)
• अस्वीकरण

अवलोकन

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

एंडपॉइंट:

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

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

• Robinhood
• Charles Schwab
• E*Trade
• Webull
• Public
• Tastytrade

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

• Coinbase
• Kraken

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

यह सर्वर दूरस्थ है इसलिए आपको कनेक्ट करने के लिए स्थानीय रूप से कुछ भी चलाने की आवश्यकता नहीं है। बस अपने 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 सहायक)

ब्रोकरेज	आईडी	विकल्प
Robinhood	1	हाँ
E*TRADE	2	हाँ
Coinbase	3	केवल क्रिप्टो
Kraken	5	केवल क्रिप्टो
Charles Schwab	7	हाँ
Webull	8	हाँ
Public	11	हाँ
Tastytrade	12	हाँ

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

अस्वीकरण

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

---