Trade Agent MCP Server

resmi

Trade Agent aracılığıyla hisse senedi ve kripto para işlemleri gerçekleştirin

GitHub

Dokümantasyon

Trade It MCP Sunucusu

👉 Tam Dokümantasyon Burada 👈

Artık Resmi MCP Kayıt Defteri üzerinden erişilebilir

İçindekiler

Genel Bakış
Başlangıç
Bağlanma
Araçlar
İşlem durumu referansı
Aracı kurum kimlikleri (API yardımcıları)
Sorumluluk reddi beyanları

Genel Bakış

Trade It MCP Sunucusu, hisse senedi, kripto ve opsiyon ticareti desteğini aracılara getirir. MCP protokolü üzerinden düz İngilizce talepler göndererek hisse senedi ve kripto aracı kurumlarıyla doğal dilde etkileşim sağlar—işlemleri gerçekleştirin, portföy performansını sorgulayın ve piyasa içgörülerini yüzeye çıkarın.

Uç Noktalar:

Akışkan HTTP: https://mcp.tradeit.app/mcp
SSE: https://mcp.tradeit.app/sse

Aracı Kurum Desteği:

Kripto Borsası Desteği:

Coinbase
Kraken

Yakında daha fazlası eklenecek!

Bu sunucu uzak olduğundan, bağlanmak için yerel olarak herhangi bir şey çalıştırmanıza gerek yoktur. Sadece MCP uyumlu aracı platformunuzu yukarıdaki URL'ye yönlendirin.

Başlangıç

Önce, https://tradeit.app. adresinde bir hesap oluşturun
Pro planının ücretsiz denemesine kaydolun.
Tercih ettiğiniz aracı kurumu bağlayın.

Bağlanma

MCP istemcinizi https://mcp.tradeit.app/mcp veya https://mcp.tradeit.app/sse adresine bağlayın.
Tarayıcı tabanlı OAuth akışıyla kimlik doğrulaması yapın.
Artık ticarete başlamaya hazırsınız!

Araçlar

MCP araçları, aracınızı bağlı aracı kurumlara bağlar: sembolleri arayın, hesapları listeleyin, taslak emirler oluşturun, ardından yalnızca onaylandıktan sonra gerçekleştirin.

MCP aracı	Ne yapar
`search_assets`	Hisse senedi veya kriptoyu sembol veya isme göre arar; fiyat ve meta veri döndürür.
`get_accounts`	Bağlı hesapları ve bakiyeleri listeler; ayrıca yeni bir aracı kurum bağlarken kullanılır.
`create_trade`	İncelenmek üzere bir taslak hisse senedi/kripto alım veya satımı oluşturur.
`create_options_trade`	İncelenmek üzere bir taslak tek veya çok ayaklı opsiyon emri oluşturur.
`execute_trade`	Açık kullanıcı onayından sonra önceden oluşturulmuş bir taslağı aracı kuruma gönderir.

Güvenlik modeli (önce taslak)

İşlemler draft emirleri olarak başlar ve kullanıcı açıkça onaylayana kadar aracı kuruma gönderilmez.

Amaçlanan akış:

create_trade veya create_options_trade çağrısı yapın → bir trade_id içeren bir taslak alırsınız.
Kullanıcıya tam emir ayrıntılarını ve nasıl devam edeceğini gösterin.
execute_trade işlevini yalnızca kullanıcı açıkça gerçekleştirmeyi, onaylamayı veya işlemi yapmayı istediğinde çağırın.
Bir taslak oluşturduktan sonra execute_trade işlevini otomatik olarak veya hemen çağırmayın.

Bir taslak oluşturduktan sonra, kullanıcının hazır olduğunda emri verebileceğini bildiğinden emin olun (örneğin, istemcinizin Gerçekleştir kontrolü aracılığıyla, varsa).

Taslak oluşturmadan önceki isteğe bağlı adımlar:

search_assets — sembolü ve bağlamı onaylayın.
get_accounts — kullanıcı hangi hesabı kullanacağını önemsediğinde doğru account_id seçin.

Gerçekleştirme akışı:

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)

Hesap / emir varsayılanları: Kullanıcı miktarı, hesabı veya emir türünü atlarsa, Trade It varsayılan miktarını, varsayılan hesabını ve uygun yerlerde piyasa emirlerini uygular. Trade It ayarlarında otomatik gerçekleştirme etkinse, bazı kurulumlarda davranış manuel gerçekleştirme adımını atlayabilir; şüphe durumunda, yine de gerçekleştirmeyi kullanıcı onaylı olarak kabul edin.

`search_assets`

Hisse senedi veya kriptoyu sembol veya isme göre arayın.

Parametre: query (dize) — örn. "TSLA", "Tesla", "bitcoin".
Döndürür: Fiyat, sembol, borsa, varlık türü ve ilgili meta veriler.

Örnek:

{ "query": "TSLA" }

Doğal dil örnekleri: "Apple nasıl gidiyor?" · "TSLA'nın fiyatı ne?"

`get_accounts`

Tüm bağlı aracı kurum hesaplarını listeleyin (ve kullanıcı yeni bir aracı kurum bağlamak istediğinde bu akışı kullanın).

Parametreler: yok.
Döndürür: id, name, brokerage, balance, available_cash içeren hesaplar. Belirli bir hesap gerektiğinde, işlem çağrılarında account.id değerini account_id olarak kullanın.

Doğal dil örneği: "Hesaplarımı göster."

`create_trade`

Bir taslak hisse senedi veya kripto emri oluşturun.

Parametreler:

Alan	Tür	Gerekli	Açıklama
`symbol`	dize	Evet	Sembol, örn. `"TSLA"`.
`amount`	sayı	Evet	İşlem yapılacak büyüklük.
`unit`	`"dollars"` veya `"shares"`	Evet	`amount` için birim.
`buy_or_sell`	`"buy"` veya `"sell"`	Evet	Yön.
`order_type`	`"market"`, `"limit"`, `"stop"`, `"stop_limit"`	Hayır	Varsayılan `"market"`.
`limit_price`	sayı	Limit / stop_limit ise	Uygulanabilir olduğu şekilde hisse başına maksimum veya minimum fiyat.
`stop_price`	sayı	Stop / stop_limit ise	Stop tetikleme fiyatı.
`time_in_force`	`"day"`, `"gtc"`, `"ioc"`, `"fok"`	Hayır	Aracı kurum varsayılanı için atlayın.
`account_id`	sayı	Hayır	Varsayılan hesap için atlayın.

Emir türleri:

Tür	Ne zaman kullanılır	Fiyat alanları
`market`	Mevcut piyasadan gerçekleştir	Yok
`limit`	Yalnızca `limit_price` veya daha iyisinde	`limit_price`
`stop`	Piyasa emri `stop_price` seviyesinde tetiklenir	`stop_price`
`stop_limit`	Limit emri `stop_price` seviyesinde tetiklenir	`stop_price` ve `limit_price`

JSON örnekleri:

Piyasadan 500$'lık Apple al:

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

10 adet NVDA hissesini yalnızca 800$ veya altına düşerse al:

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

Fiyat 450$'a düşerse 5 adet Meta hissesi sat (stop):

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

200$'ın üzerine çıkarsa 10 AAPL al, hisse başına en fazla 202$ öde:

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

1.000$ değerinde Bitcoin al:

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

100 adet Tesla hissesi sat, iptal edilene kadar geçerli:

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

Doğal dil örnekleri: "1000$'lık Tesla al" · "1000$'lık Tesla'yı yalnızca fiyat 150$ veya altına düşerse al" · "Fiyat 140$'a düşerse 10 adet Apple hissesi sat" · "200$'ı vurursa bir adet Apple hissesi al" · "140$'a yükselirse 10 adet Apple hissesi al, ancak 142$'dan fazla ödeme"

`create_options_trade`

Bir taslak tek ayaklı veya çok ayaklı opsiyon emri (spreadler, straddlelar, vb.) oluşturun.

Parametreler:

Alan	Tür	Gerekli	Açıklama
`symbol`	dize	Evet	Dayanak varlık sembolü, örn. `"SPY"`.
`legs`	dizi	Evet	Bir veya daha fazla ayak (aşağıya bakın).
`direction`	`"debit"` veya `"credit"`	Çok ayaklı	`"debit"` = siz ödersiniz; `"credit"` = siz tahsil edersiniz.
`order_type`	`"market"`, `"limit"`, vb.	Hayır	Varsayılan `"market"`.
`limit_price`	sayı	Limit için	Paket için net borç/alacak limiti.
`time_in_force`	`"day"` veya `"gtc"`	Hayır	Varsayılan için atlayın.
`account_id`	sayı	Hayır	Varsayılan hesap için atlayın.

Her ayak:

Alan	Tür	Gerekli	Açıklama
`type`	`"option"` veya `"equity"`	Evet	Ayak türü.
`action`	`"buy"` veya `"sell"`	Evet	Ayağın tarafı.
`position_effect`	`"open"` veya `"close"`	Opsiyonlar	Yeni bir pozisyon açın veya mevcut olanı kapatın.
`occ`	dize veya `null`	Opsiyonlar	OCC dizesi (aşağıda); hisse senedi ayakları için `null`.
`quantity`	sayı	Evet	Kontratlar (opsiyonlar) veya hisseler (hisse senedi).

OCC opsiyon sembol formatı

OCC dizeleri şu formatı takip eder: YYMMDD + C veya P + 8 haneli kullanım fiyatı (kullanım fiyatı × 1000, sıfırlarla doldurulmuş).

Açıklama	OCC
20 Haz 2025 250$ alım	`250620C00250000`
20 Haz 2025 260$ alım	`250620C00260000`
21 Mar 2025 500$ satım	`250321P00500000`
19 Ara 2025 1.500$ alım	`251219C01500000`
16 Oca 2026 50$ satım	`260116P00050000`

Kullanım fiyatı kodlaması: doları 1.000 ile çarpın ve 8 haneye tamamlayın (örn. 250$ → 00250000; 50,50$ → 00050500).

Opsiyon JSON örnekleri

Tek alım — 1 SPY 520$ alım, son kullanma 20 Haz 2025:

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

Boğa alım spreadi (borçlu) — 250$ alım al, 260$ alım sat, aynı son kullanma:

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

Ayı satım spreadi (borçlu):

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

Boğa satım spreadi (alacaklı):

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

Limitli spread — net borç 3,50$ veya daha iyisi:

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

Uzun alımı kapat — 2 AAPL 200$ alım, son kullanma 21 Mar 2025, kapatmak için sat:

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

Straddle — uzun 250$ alım ve 250$ satım, aynı son kullanma:

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

Doğal dil örnekleri: "Gelecek ay son kullanma tarihli 1 AAPL 300$ alım al" · "MSFT'de 500$ kullanım fiyatlı kapalı alım" · "TSLA alım spreadi: 475$ al / 485$ sat, gelecek hafta" · "Bu Cuma SPY'da ATM straddle" · "2 AMZN satım, limit 3,50$" · "AMZN260130P00200000 sat"

`execute_trade`

Kullanıcı inceledikten sonra bir taslağı aracı kuruma gönderin.

Parametre: trade_id (sayı) — create_trade veya create_options_trade işlevinden gelen taslağın id değeri.
Döndürür: Güncellenmiş işlem; durum "placed" veya "failed" (hata ayrıntılarıyla birlikte).

Yalnızca kullanıcı açıkça onayladığında çağırın (örn. gerçekleştir, onayla, işlemi yap, devam et). Az önce inceledikleriyle eşleşen işlemi onaylayın.

Bir taslak oluşturduktan hemen sonra, emir ayrıntılarını göstermeden veya durum "draft" değilse otomatik olarak çağırmayın.

İşlem durumu referansı

Durum	Anlamı
`draft`	Oluşturuldu; henüz aracı kuruma gönderilmedi
`pending`	Gönderildi; aracı kurum onayı bekleniyor
`placed`	Kabul edildi; gerçekleşme bekleniyor
`partially_filled`	Kısmen gerçekleşti
`complete`	Tamamen gerçekleşti
`canceled`	İptal edildi
`failed`	Reddedildi — hataları kontrol edin
`disconnected`	Aracı kurum bağlantı sorunu

Aracı kurum kimlikleri (API yardımcıları)

Aracı Kurum	Kimlik	Opsiyonlar
Robinhood	1	Evet
E*TRADE	2	Evet
Coinbase	3	Yalnızca kripto
Kraken	5	Yalnızca kripto
Charles Schwab	7	Evet
Webull	8	Evet
Public	11	Evet
Tastytrade	12	Evet

Açıklama: Emir türü belirsiz olduğunda (örn. "TSLA'yı 200$'dan al" — limit vs stop), opsiyonlarda son kullanma/kullanım fiyatı eksik olduğunda, birden fazla hesap geçerliyken hiçbiri seçilmediğinde veya bir sembol birden fazla varlığı ifade edebildiğinde, ihtiyacınız olan her şeyle birlikte bir kez sorun. Varsayılanlar net olduğunda (varsayılan miktar, piyasa emri, birincil hesap) gereksiz soruları atlayın.

Sorumluluk reddi beyanları

Yatırım yapmak, anapara kaybı olasılığı da dahil olmak üzere risk içerir.
Trade It bir finansal danışman değildir ve yatırım tavsiyesi sağlamaz.
Opsiyonlar önemli risk içerir ve tüm yatırımcılar için uygun değildir.
Trade It fon çekemez, varlık transfer edemez veya saklama hizmeti veremez — yalnızca bağlı aracı kurumlarınız aracılığıyla işlem yapabilir.