Tradernet MCP Server

Tradernet MCP Server

Servidor MCP para a API da plataforma de negociação Tradernet / Freedom24. Gerencie seu portfólio, faça pedidos, obtenha cotações, pesquise tickers, defina alertas — tudo por meio de assistentes de IA como Claude, ChatGPT e outros.

Ferramentas Disponíveis

Ferramenta	Descrição
get_user_data	Informações da conta, resumo do portfólio, posições abertas
get_portfolio	Posições atuais, saldos, lucros e perdas
place_order	Fazer pedidos de compra/venda/venda a descoberto/margem
cancel_order	Cancelar um pedido ativo
set_stop_loss_take_profit	Definir SL/TP para uma posição
get_security_info	Detalhes do ticker (moeda, bolsa, passo mínimo)
get_quotes_history	Dados históricos de candlestick OHLCV
search_tickers	Pesquisar títulos por nome ou símbolo
add_price_alert	Definir um alerta de preço com notificações
delete_price_alert	Remover um alerta de preço
get_security_sessions	Listar sessões de títulos abertas
raw_api_call	Chamar qualquer comando da API Tradernet diretamente

Configuração

1. Obtenha as Chaves de API

1. Faça login no Tradernet ou Freedom24
2. Vá para as configurações do seu perfil
3. Gere as chaves de API (Chave Pública e Chave Privada)

2. Configure

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tradernet": {
      "command": "npx",
      "args": ["-y", "tradernet-mcp"],
      "env": {
        "TRADERNET_PUBLIC_KEY": "your_public_key",
        "TRADERNET_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

Claude Code

claude mcp add tradernet -- npx -y tradernet-mcp

Em seguida, defina as variáveis de ambiente TRADERNET_PUBLIC_KEY e TRADERNET_PRIVATE_KEY.

ChatGPT

O ChatGPT só oferece suporte a servidores MCP remotos via HTTP. Para conectar este servidor stdio, use o supergateway como ponte e o ngrok para expô-lo publicamente:

1. Inicie o servidor com transporte HTTP:

TRADERNET_PUBLIC_KEY=your_public_key \
TRADERNET_PRIVATE_KEY=your_private_key \
npx -y supergateway --stdio "npx -y tradernet-mcp" --outputTransport streamableHttp --port 8000

2. Exponha-o via ngrok:

ngrok http 8000

3. No ChatGPT: Configurações → Conectores → Adicionar Conector, insira sua URL do ngrok com o caminho /mcp (por exemplo, https://abc123.ngrok-free.app/mcp)

Requer plano ChatGPT Pro, Team ou Enterprise com o Modo de Desenvolvedor ativado.

Exemplos de Uso

Depois de conectado, você pode pedir ao seu assistente de IA coisas como:

• "Mostre meu portfólio"
• "Quais são minhas posições abertas?"
• "Compre 10 ações da AAPL"
• "Defina stop-loss para SBER em 250"
• "Pesquise a ação da Tesla"
• "Mostre o histórico de preços da AAPL no último mês"
• "Defina um alerta quando a MSFT ultrapassar US$ 400"

Variáveis de Ambiente

Variável	Obrigatória	Descrição
TRADERNET_PUBLIC_KEY	Sim	Sua chave pública da API Tradernet
TRADERNET_PRIVATE_KEY	Sim	Sua chave privada da API Tradernet
TRADERNET_API_URL	Não	URL base da API (padrão: https://tradernet.com/api)

Documentação da API

Este servidor implementa a API Tradernet. Para a referência completa da API, consulte a documentação oficial.

Licença

MIT