Trade Agent MCP Server

oficial

Execute negociações de ações e criptomoedas via Trade Agent

GitHub

Documentação

Trade Agent MCP Server

👉 Documentação Completa Aqui 👈

Agora disponível através do Registro Oficial MCP

Índice

Visão Geral
Primeiros Passos
Conexão
Ferramentas
Referência de status de negociação
IDs de Corretoras (auxiliares de API)
Avisos Legais

Visão Geral

O Trade Agent MCP Server traz suporte a negociação de ações, criptomoedas e opções para agentes. Ele permite interação em linguagem natural com corretoras de ações e criptomoedas — execute negociações, consulte o desempenho do portfólio e obtenha insights de mercado enviando solicitações em inglês simples através do protocolo MCP.

Endpoints:

HTTP Transmissível: https://mcp.tradeit.app/mcp
SSE: https://mcp.tradeit.app/sse

Suporte a Corretoras:

Suporte a Exchanges de Criptomoedas:

Coinbase
Kraken

Mais em breve!

Este servidor é remoto, então você não precisa executar nada localmente para conectar. Basta apontar sua plataforma de agente compatível com MCP para a URL acima.

Primeiros Passos

Primeiro, crie uma conta em https://tradeit.app.
Inscreva-se no teste gratuito do plano Pro.
Conecte a corretora de sua escolha.

Conexão

Conecte seu cliente MCP a https://mcp.tradeit.app/mcp ou https://mcp.tradeit.app/sse.
Autentique-se através do fluxo OAuth baseado no navegador.
Agora você está pronto para começar a negociar!

Ferramentas

As ferramentas MCP conectam seu agente às corretoras vinculadas: pesquise símbolos, liste contas, crie ordens de rascunho e então execute somente após confirmação.

Ferramenta MCP	O que faz
`search_assets`	Pesquisa uma ação ou criptomoeda por ticker ou nome; retorna preço e metadados.
`get_accounts`	Lista contas vinculadas e saldos; também usado ao vincular uma nova corretora.
`create_trade`	Cria uma ordem de rascunho de compra ou venda de renda variável/cripto para revisão.
`create_options_trade`	Cria uma ordem de rascunho de opções de perna única ou múltipla para revisão.
`execute_trade`	Envia um rascunho criado anteriormente para a corretora após confirmação explícita do usuário.

Modelo de segurança (rascunho primeiro)

As negociações começam como ordens de draft e não são enviadas à corretora até que o usuário confirme claramente.

Fluxo pretendido:

Chame create_trade ou create_options_trade → você obtém um rascunho com um trade_id.
Mostre ao usuário os detalhes completos da ordem e como proceder.
Chame execute_trade somente quando o usuário solicitar explicitamente para executar, confirmar ou enviar a negociação.
Não chame execute_trade automaticamente ou imediatamente após criar um rascunho.

Após criar um rascunho, certifique-se de que o usuário saiba que pode enviar a ordem quando estiver pronto (por exemplo, através do controle Executar do seu cliente, se disponível).

Etapas opcionais antes de criar um rascunho:

search_assets — confirme o ticker e o contexto.
get_accounts — escolha o account_id correto quando o usuário se importa com qual conta usar.

Fluxo de execução:

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)

Padrões de conta / ordem: Se o usuário omitir quantidade, conta ou tipo de ordem, o Trade Agent aplica sua quantidade padrão, conta padrão e ordens de mercado quando aplicável. Se a execução automática estiver habilitada nas configurações do Trade Agent, o comportamento pode pular a etapa de execução manual em algumas configurações; em caso de dúvida, ainda trate a execução como confirmada pelo usuário.

`search_assets`

Pesquisa uma ação ou criptomoeda por ticker ou nome.

Parâmetro: query (string) — ex. "TSLA", "Tesla", "bitcoin".
Retorna: Preço, ticker, exchange, tipo de ativo e metadados relacionados.

Exemplo:

{ "query": "TSLA" }

Exemplos em linguagem natural: "Como está a Apple?" · "Qual o preço da TSLA?"

`get_accounts`

Lista todas as contas de corretora vinculadas (e use este fluxo quando o usuário quiser conectar uma nova corretora).

Parâmetros: nenhum.
Retorna: Contas com id, name, brokerage, balance, available_cash. Use account.id como account_id em chamadas de negociação quando uma conta específica for necessária.

Exemplo em linguagem natural: "Mostre minhas contas."

`create_trade`

Cria uma ordem de rascunho de renda variável ou cripto.

Parâmetros:

Campo	Tipo	Obrigatório	Descrição
`symbol`	string	Sim	Ticker, ex. `"TSLA"`.
`amount`	number	Sim	Tamanho a negociar.
`unit`	`"dollars"` ou `"shares"`	Sim	Unidade para `amount`.
`buy_or_sell`	`"buy"` ou `"sell"`	Sim	Direção.
`order_type`	`"market"`, `"limit"`, `"stop"`, `"stop_limit"`	Não	Padrão é `"market"`.
`limit_price`	number	Se limit / stop_limit	Preço máx ou mín por ação, conforme aplicável.
`stop_price`	number	Se stop / stop_limit	Preço de gatilho do stop.
`time_in_force`	`"day"`, `"gtc"`, `"ioc"`, `"fok"`	Não	Omita para o padrão da corretora.
`account_id`	number	Não	Omita para a conta padrão.

Tipos de ordem:

Tipo	Use quando	Campos de preço
`market`	Preencher ao preço de mercado atual	Nenhum
`limit`	Somente a `limit_price` ou melhor	`limit_price`
`stop`	Ordem de mercado dispara a `stop_price`	`stop_price`
`stop_limit`	Ordem limitada dispara a `stop_price`	`stop_price` e `limit_price`

Exemplos JSON:

Comprar $500 de Apple a mercado:

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

Comprar 10 ações da NVDA somente se cair para $800 ou abaixo:

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

Vender 5 ações da Meta se o preço cair para $450 (stop):

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

Comprar 10 AAPL se superar $200, pagando no máximo $202/ação:

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

Comprar $1.000 de Bitcoin:

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

Vender 100 ações da Tesla, válida até cancelar:

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

Exemplos em linguagem natural: "Compre $1000 de Tesla" · "Compre $1000 de Tesla somente se o preço cair para $150 ou menos" · "Venda 10 ações da Apple se o preço cair para $140" · "Compre uma ação da Apple se atingir $200" · "Compre 10 ações da Apple se subir para $140, mas não pague mais que $142"

`create_options_trade`

Cria uma ordem de rascunho de opções de perna única ou múltipla (spreads, straddles, etc.).

Parâmetros:

Campo	Tipo	Obrigatório	Descrição
`symbol`	string	Sim	Ticker do ativo subjacente, ex. `"SPY"`.
`legs`	array	Sim	Uma ou mais pernas (veja abaixo).
`direction`	`"debit"` ou `"credit"`	Multi-perna	`"debit"` = você paga; `"credit"` = você recebe.
`order_type`	`"market"`, `"limit"`, etc.	Não	Padrão é `"market"`.
`limit_price`	number	Para limit	Limite de débito/crédito líquido para o pacote.
`time_in_force`	`"day"` ou `"gtc"`	Não	Omita para o padrão.
`account_id`	number	Não	Omita para a conta padrão.

Cada perna:

Campo	Tipo	Obrigatório	Descrição
`type`	`"option"` ou `"equity"`	Sim	Tipo de perna.
`action`	`"buy"` ou `"sell"`	Sim	Lado da perna.
`position_effect`	`"open"` ou `"close"`	Opções	Abrir uma nova posição ou fechar uma existente.
`occ`	string ou `null`	Opções	String OCC (abaixo); `null` para pernas de renda variável.
`quantity`	number	Sim	Contratos (opções) ou ações (renda variável).

Formato de símbolo de opções OCC

Strings OCC seguem: YYMMDD + C ou P + strike de 8 dígitos (strike × 1000, preenchido com zeros).

Descrição	OCC
Call de $250 em 20 de jun de 2025	`250620C00250000`
Call de $260 em 20 de jun de 2025	`250620C00260000`
Put de $500 em 21 de mar de 2025	`250321P00500000`
Call de $1.500 em 19 de dez de 2025	`251219C01500000`
Put de $50 em 16 de jan de 2026	`260116P00050000`

Codificação do strike: multiplique dólares por 1.000 e preencha com 8 dígitos (ex. $250 → 00250000; $50,50 → 00050500).

Exemplos JSON de opções

Call única — comprar 1 call de SPY $520 expirando em 20 de jun de 2025:

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

Bull call spread (débito) — comprar call $250, vender call $260, mesmo vencimento:

{
  "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 (débito):

{
  "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 (crédito):

{
  "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 com limite — débito líquido $3,50 ou melhor:

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

Fechar uma call comprada — vender para fechar 2 calls AAPL $200 expirando em 21 de mar de 2025:

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

Straddle — comprar call $250 e put $250, mesmo vencimento:

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

Exemplos em linguagem natural: "Compre 1 call AAPL $300 expirando mês que vem" · "Covered call na MSFT com strike $500" · "Call spread TSLA: comprar $475 / vender $485, próxima semana" · "Straddle ATM na SPY esta sexta" · "2 puts AMZN, limite $3,50" · "Vender AMZN260130P00200000"

`execute_trade`

Envia um rascunho para a corretora após o usuário tê-lo revisado.

Parâmetro: trade_id (number) — o id do rascunho de create_trade ou create_options_trade.
Retorna: Negociação atualizada; status "placed" ou "failed" (com detalhes do erro).

Chame somente quando o usuário confirmar claramente (ex. executar, confirmar, enviar, prosseguir). Confirme a negociação que corresponde ao que eles acabaram de revisar.

Não chame automaticamente logo após criar um rascunho, sem mostrar os detalhes da ordem, ou quando o status não for "draft".

Referência de status de negociação

Status	Significado
`draft`	Criado; ainda não enviado à corretora
`pending`	Enviado; aguardando confirmação da corretora
`placed`	Aceito; aguardando preenchimento
`partially_filled`	Parcialmente preenchido
`complete`	Totalmente preenchido
`canceled`	Cancelado
`failed`	Rejeitado — verifique os erros
`disconnected`	Problema de conexão com a corretora

IDs de Corretoras (auxiliares de API)

Corretora	ID	Opções
Robinhood	1	Sim
E*TRADE	2	Sim
Coinbase	3	Somente cripto
Kraken	5	Somente cripto
Charles Schwab	7	Sim
Webull	8	Sim
Public	11	Sim
Tastytrade	12	Sim

Esclarecimento: Pergunte uma vez, com tudo o que você precisa, quando: o tipo de ordem for ambíguo (ex. “comprar TSLA a $200” — limit vs stop), opções estiverem sem vencimento/strike, várias contas se aplicarem e nenhuma for escolhida, ou um símbolo puder significar mais de um ativo. Pule perguntas redundantes quando os padrões forem claros (quantidade padrão, ordem de mercado, conta principal).

Avisos Legais

Investir envolve risco, incluindo possível perda do principal.
Trade Agent não é um consultor financeiro e não fornece aconselhamento de investimento.
Opções envolvem risco substancial e não são adequadas para todos os investidores.
Trade Agent não pode sacar fundos, transferir ativos ou tomar custódia — ele só pode realizar negociações através de suas corretoras vinculadas.