Trade Agent MCP Server

resmi

Jalankan perdagangan saham dan kripto melalui Trade Agent

GitHub

Dokumentasi

Trade It MCP Server

👉 Dokumentasi Lengkap Di Sini 👈

Sekarang tersedia melalui Official MCP Registry

Daftar isi

Ikhtisar
Memulai
Menghubungkan
Alat
Referensi status perdagangan
ID Broker (API helpers)
Penyangkalan

Ikhtisar

Trade It MCP Server menghadirkan dukungan perdagangan saham, kripto, dan opsi kepada agen. Ini memungkinkan interaksi bahasa alami dengan broker saham dan kripto—eksekusi perdagangan, kueri kinerja portofolio, dan tampilkan wawasan pasar dengan mengirim permintaan bahasa Inggris sederhana melalui protokol MCP.

Endpoint:

HTTP Streamable: https://mcp.tradeit.app/mcp
SSE: https://mcp.tradeit.app/sse

Dukungan Broker:

Dukungan Bursa Kripto:

Coinbase
Kraken

Lebih banyak lagi segera hadir!

Server ini remote sehingga Anda tidak perlu menjalankan apa pun secara lokal untuk terhubung. Cukup arahkan platform agen yang kompatibel dengan MCP Anda ke URL di atas.

Memulai

Pertama, buat akun di https://tradeit.app.
Daftar untuk uji coba gratis paket Pro.
Hubungkan broker pilihan Anda.

Menghubungkan

Hubungkan klien MCP Anda ke https://mcp.tradeit.app/mcp atau https://mcp.tradeit.app/sse.
Otentikasi melalui alur OAuth berbasis browser.
Anda sekarang siap untuk mulai berdagang!

Alat

Alat MCP menghubungkan agen Anda ke broker yang ditautkan: cari simbol, daftar akun, buat pesanan draft, lalu eksekusi hanya setelah konfirmasi.

Alat MCP	Fungsinya
`search_assets`	Mencari saham atau kripto berdasarkan ticker atau nama; mengembalikan harga dan metadata.
`get_accounts`	Mendaftar akun dan saldo yang ditautkan; juga digunakan saat menautkan broker baru.
`create_trade`	Membuat pesanan beli/jual ekuitas/kripto draft untuk ditinjau.
`create_options_trade`	Membuat pesanan opsi single-leg atau multi-leg draft untuk ditinjau.
`execute_trade`	Mengirimkan draft yang dibuat sebelumnya ke broker setelah konfirmasi eksplisit pengguna.

Model keamanan (draft-first)

Perdagangan dimulai sebagai pesanan draft dan tidak dikirim ke broker sampai pengguna dengan jelas mengonfirmasi.

Alur yang dimaksud:

Panggil create_trade atau create_options_trade → Anda mendapatkan draft dengan trade_id.
Tunjukkan kepada pengguna detail pesanan lengkap dan cara melanjutkan.
Panggil execute_trade hanya ketika pengguna secara eksplisit meminta untuk mengeksekusi, mengonfirmasi, atau menempatkan perdagangan.
Jangan panggil execute_trade secara otomatis atau segera setelah membuat draft.

Setelah membuat draft, pastikan pengguna tahu bahwa mereka dapat menempatkan pesanan saat siap (mis. melalui kontrol Eksekusi klien Anda, jika tersedia).

Langkah opsional sebelum membuat draft:

search_assets — konfirmasi ticker dan konteks.
get_accounts — pilih account_id yang tepat ketika pengguna peduli akun mana yang akan digunakan.

Alur eksekusi:

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)

Default akun / pesanan: Jika pengguna menghilangkan jumlah, akun, atau jenis pesanan, Trade It menerapkan jumlah default, akun default, dan pesanan market jika berlaku. Jika auto-execute diaktifkan di pengaturan Trade It, perilaku dapat melewati langkah eksekusi manual dalam beberapa pengaturan; jika ragu, tetap perlakukan eksekusi sebagai dikonfirmasi pengguna.

`search_assets`

Mencari saham atau kripto berdasarkan ticker atau nama.

Parameter: query (string) — mis. "TSLA", "Tesla", "bitcoin".
Mengembalikan: Harga, ticker, bursa, jenis aset, dan metadata terkait.

Contoh:

{ "query": "TSLA" }

Contoh bahasa alami: "Bagaimana kabar Apple?" · "Berapa harga TSLA?"

`get_accounts`

Mendaftar semua akun broker yang ditautkan (dan gunakan alur ini ketika pengguna ingin menghubungkan broker baru).

Parameter: tidak ada.
Mengembalikan: Akun dengan id, name, brokerage, balance, available_cash. Gunakan account.id sebagai account_id dalam panggilan perdagangan ketika akun spesifik diperlukan.

Contoh bahasa alami: "Tampilkan akun saya."

`create_trade`

Membuat pesanan ekuitas atau kripto draft.

Parameter:

Kolom	Tipe	Wajib	Deskripsi
`symbol`	string	Ya	Ticker, mis. `"TSLA"`.
`amount`	number	Ya	Ukuran untuk diperdagangkan.
`unit`	`"dollars"` atau `"shares"`	Ya	Satuan untuk `amount`.
`buy_or_sell`	`"buy"` atau `"sell"`	Ya	Arah.
`order_type`	`"market"`, `"limit"`, `"stop"`, `"stop_limit"`	Tidak	Default ke `"market"`.
`limit_price`	number	Jika limit / stop_limit	Harga maks atau min per saham sesuai yang berlaku.
`stop_price`	number	Jika stop / stop_limit	Harga pemicu stop.
`time_in_force`	`"day"`, `"gtc"`, `"ioc"`, `"fok"`	Tidak	Abaikan untuk default broker.
`account_id`	number	Tidak	Abaikan untuk akun default.

Jenis pesanan:

Tipe	Gunakan ketika	Kolom harga
`market`	Isi pada harga pasar saat ini	Tidak ada
`limit`	Hanya pada `limit_price` atau lebih baik	`limit_price`
`stop`	Pesanan market terpicu pada `stop_price`	`stop_price`
`stop_limit`	Pesanan limit terpicu pada `stop_price`	`stop_price` dan `limit_price`

Contoh JSON:

Beli $500 Apple pada market:

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

Beli 10 saham NVDA hanya jika turun ke $800 atau di bawahnya:

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

Jual 5 saham Meta jika harga turun ke $450 (stop):

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

Beli 10 AAPL jika menembus di atas $200, bayar paling banyak $202/saham:

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

Beli $1.000 Bitcoin:

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

Jual 100 saham Tesla, good till canceled:

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

Contoh bahasa alami: "Beli $1000 Tesla" · "Beli $1000 Tesla hanya jika harga turun ke $150 atau lebih rendah" · "Jual 10 saham Apple jika harga turun ke $140" · "Beli satu saham Apple jika mencapai $200" · "Beli 10 saham Apple jika naik ke $140, tapi jangan bayar lebih dari $142"

`create_options_trade`

Membuat pesanan opsi single-leg atau multi-leg draft (spread, straddle, dll.).

Parameter:

Kolom	Tipe	Wajib	Deskripsi
`symbol`	string	Ya	Ticker acuan, mis. `"SPY"`.
`legs`	array	Ya	Satu atau lebih leg (lihat di bawah).
`direction`	`"debit"` atau `"credit"`	Multi-leg	`"debit"` = Anda bayar; `"credit"` = Anda terima.
`order_type`	`"market"`, `"limit"`, dll.	Tidak	Default ke `"market"`.
`limit_price`	number	Untuk limit	Batas debit/kredit bersih untuk paket.
`time_in_force`	`"day"` atau `"gtc"`	Tidak	Abaikan untuk default.
`account_id`	number	Tidak	Abaikan untuk akun default.

Setiap leg:

Kolom	Tipe	Wajib	Deskripsi
`type`	`"option"` atau `"equity"`	Ya	Jenis leg.
`action`	`"buy"` atau `"sell"`	Ya	Sisi leg.
`position_effect`	`"open"` atau `"close"`	Opsi	Buka posisi baru atau tutup yang sudah ada.
`occ`	string atau `null`	Opsi	String OCC (di bawah); `null` untuk leg ekuitas.
`quantity`	number	Ya	Kontrak (opsi) atau saham (ekuitas).

Format simbol opsi OCC

String OCC mengikuti: YYMMDD + C atau P + strike 8 digit (strike × 1000, diisi nol).

Deskripsi	OCC
20 Jun 2025 $250 call	`250620C00250000`
20 Jun 2025 $260 call	`250620C00260000`
21 Mar 2025 $500 put	`250321P00500000`
19 Des 2025 $1.500 call	`251219C01500000`
16 Jan 2026 $50 put	`260116P00050000`

Pengkodean strike: kalikan dolar dengan 1.000 dan isi hingga 8 digit (mis. $250 → 00250000; $50,50 → 00050500).

Contoh JSON opsi

Single call — beli 1 SPY $520 call exp 20 Jun 2025:

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

Bull call spread (debit) — beli $250 call, jual $260 call, kadaluarsa sama:

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

Bear put spread (debit):

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

Bull put spread (kredit):

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

Spread dengan limit — debit bersih $3,50 atau lebih baik:

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

Tutup long call — jual untuk menutup 2 AAPL $200 call exp 21 Mar 2025:

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

Straddle — long $250 call dan $250 put, kadaluarsa sama:

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

Contoh bahasa alami: "Beli 1 AAPL $300 call kadaluarsa bulan depan" · "Covered call pada MSFT dengan strike $500" · "TSLA call spread: beli $475 / jual $485, minggu depan" · "ATM straddle pada SPY Jumat ini" · "2 AMZN puts, limit $3,50" · "Jual AMZN260130P00200000"

`execute_trade`

Kirim draft ke broker setelah pengguna meninjaunya.

Parameter: trade_id (number) — id draft dari create_trade atau create_options_trade.
Mengembalikan: Perdagangan yang diperbarui; status "placed" atau "failed" (dengan detail kesalahan).

Panggil hanya ketika pengguna dengan jelas mengonfirmasi (mis. eksekusi, konfirmasi, tempatkan, lanjutkan). Konfirmasi perdagangan yang cocok dengan yang baru saja mereka tinjau.

Jangan panggil secara otomatis tepat setelah membuat draft, tanpa menunjukkan detail pesanan, atau ketika status bukan "draft".

Referensi status perdagangan

Status	Arti
`draft`	Dibuat; belum dikirim ke broker
`pending`	Dikirim; menunggu ack broker
`placed`	Diterima; menunggu pengisian
`partially_filled`	Terisi sebagian
`complete`	Terisi penuh
`canceled`	Dibatalkan
`failed`	Ditolak — periksa kesalahan
`disconnected`	Masalah koneksi broker

ID Broker (API helpers)

Broker	ID	Opsi
Robinhood	1	Ya
E*TRADE	2	Ya
Coinbase	3	Hanya kripto
Kraken	5	Hanya kripto
Charles Schwab	7	Ya
Webull	8	Ya
Public	11	Ya
Tastytrade	12	Ya

Klarifikasi: Tanyakan sekali, dengan semua yang Anda butuhkan, ketika: jenis pesanan ambigu (mis. “beli TSLA di $200” — limit vs stop), opsi kehilangan kadaluarsa/strike, beberapa akun berlaku dan tidak ada yang dipilih, atau simbol bisa berarti lebih dari satu aset. Lewati pertanyaan berulang ketika default jelas (jumlah default, pesanan market, akun utama).

Penyangkalan

Investasi melibatkan risiko, termasuk kemungkinan kehilangan pokok.
Trade It bukan penasihat keuangan dan tidak memberikan saran investasi.
Opsi melibatkan risiko substansial dan tidak sesuai untuk semua investor.
Trade It tidak dapat menarik dana, mentransfer aset, atau mengambil hak asuh — hanya dapat menempatkan perdagangan melalui broker yang Anda tautkan.