FxSocket

npx add-mcp 'https://mcp.fxsocket.com/mcp'

Servidor MCP do MetaTrader

Dê a um agente de IA acesso de leitura às suas contas MetaTrader 4 e MetaTrader 5. O servidor MCP do FxSocket permite que Claude, Cursor, VS Code e qualquer outro cliente Model Context Protocol respondam a perguntas sobre suas operações: saldo e patrimônio entre contas, o que está aberto agora, como foi o mês passado, cotações ao vivo e histórico de preços. É somente leitura. Nenhuma ferramenta pode colocar, modificar ou fechar uma ordem.

URL do servidor https://mcp.fxsocket.com/mcp

1. Crie uma chave de API somente leitura

Na página de chaves de API, crie uma chave somente leitura. Ela começa com fxs_ro_, pode chamar todas as ferramentas daqui e também não consegue operar por nenhum outro endpoint. Dê um nome a ela e limite-a às contas que o agente deve ver, e o agente nunca saberá que as outras existem. Sua chave completa fxs_live_ também funciona, mas um agente não tem utilidade para ela.

2. Conecte seu cliente

Clientes que aceitam uma URL de servidor remoto e um cabeçalho conectam-se diretamente. Clientes que só iniciam servidores locais, como o Claude Desktop, usam a imagem Docker.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"

{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

Qualquer outro cliente funciona da mesma forma: aponte-o para https://mcp.fxsocket.com/mcp com a chave em um cabeçalho X-API-Key (Authorization: Bearer também é aceito), ou execute a imagem Docker como um servidor local.

Ferramentas

Oito ferramentas, todas somente leitura. Cada uma é moldada em torno de uma pergunta, e não de um endpoint, então "o que está aberto nas minhas contas" é uma única chamada que lê todos os terminais de uma vez.

• list_accounts: Todas as contas que a chave pode ver, com seu id, apelido, plataforma, servidor, login e status de conexão, opcionalmente com saldo, patrimônio e totais por moeda. Os agentes a chamam primeiro.
• get_account: Uma conta por completo: saldo, patrimônio, margem, nível de margem e alavancagem, configurações da conta como o nível de stop-out, e a saúde do terminal.
• get_open_positions: Posições abertas e ordens pendentes entre contas, filtráveis por símbolo e tipo, com lucro flutuante, swap e totais por moeda.
• get_trade_history: Negociações fechadas em um período (os últimos 7 dias por padrão, até 366), com ganhos, perdas, taxa de acerto, lucro líquido, a melhor e a pior negociação, e um detalhamento por símbolo.
• search_symbols: O nome exato do símbolo na corretora. EURUSD é EURUSD.sd ou EURUSDm em algumas corretoras, então os agentes o consultam antes de pedir preços.
• get_quotes: Bid, ask e spread ao vivo para até 20 símbolos.
• get_symbol_info: A especificação do contrato: dígitos, tamanho do contrato, valor do tick, limites de volume, taxas de swap, comissões e sessões de negociação.
• get_price_history: Candles OHLC para um símbolo e timeframe, até 500 barras por chamada.

O que você pode perguntar

• "Qual é o meu patrimônio total entre todas as contas, por moeda?"
• "Quais posições abertas estão no prejuízo agora, e em quanto?"
• "Qual foi minha taxa de acerto em XAUUSD no mês passado, e qual foi minha pior negociação?"
• "Compare o spread do EURUSD em cada uma das minhas corretoras."
• "Puxe os últimos 200 candles H1 de GBPUSD e descreva a tendência."

Somente leitura por design

O servidor não consegue operar por causa do que seu código pode alcançar, não por causa de uma configuração: todas as ferramentas leem do terminal e nenhuma delas pode enviar uma ordem. Assim, um agente confuso ou manipulado ainda não consegue abrir, alterar ou fechar uma posição.

Os valores monetários são informados na moeda de depósito de cada conta e nunca somados entre moedas; as ferramentas retornam totais por moeda para que o modelo não precise fazer essa aritmética. Os horários são do servidor da corretora, como em todo o resto da API.

Limites: 60 requisições por minuto por usuário, até 50 contas e 300 linhas de ordens ou negociações em uma resposta. Contagens e totais sempre cobrem tudo; apenas as listas de linhas são cortadas.

Execute localmente com Docker

A imagem fxsocket/mcp executa o servidor como um processo stdio local, para clientes que iniciam seus próprios servidores. É um pequeno relay, um único arquivo Python sem dependências, que repassa cada mensagem para mcp.fxsocket.com com sua chave. As ferramentas e seus dados ainda vêm do FxSocket, então a imagem nunca precisa ser atualizada quando as ferramentas mudam. Publicada para amd64 e arm64.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · Código-fonte no GitHub (MIT)

Detalhes do protocolo

• Transporte: Streamable HTTP, somente POST, respostas JSON. Sem estado, sem sessão para manter ativa.
• Versões do protocolo: 2026-07-28 (metadados por requisição, sem handshake) e 2025-03-26 até 2025-11-25 (o handshake initialize).
• Autenticação: as mesmas chaves de API da API da plataforma, em X-API-Key ou Authorization: Bearer.
• Ainda não suportado: os conectores web no claude.ai e no ChatGPT, que fazem login com OAuth em vez de um cabeçalho. O Claude Desktop funciona hoje por meio da imagem Docker.