Como conectar FXMacroData à IA do Windsurf (MCP)

No final deste guia, o seu IDE Windsurf terá acesso ao vivo a séries de indicadores macroeconômicos, calendários de lançamento, posicionamento do CFTC COT, preços de metais preciosos e taxas spot de câmbio em 18 moedas tudo consultável em inglês simples a partir do seu editor sem sair do fluxo de codificação da IA.

Caminho A Conectar através do MCP Recomendado

Protocolo de contexto modelo (MCP) é a maneira nativa de adicionar ferramentas externas ao agente Cascade do Windsurf. Um bloco de configuração JSON e Cascade descobre automaticamente todas as ferramentas que o servidor FXMacroData expõe sem definições de esquema, sem boilerplate HTTP.

Passo 1 Abrir o ficheiro de configuração MCP

O Windsurf armazena definições de servidor MCP em um arquivo JSON em:

~/.codeium/windsurf/mcp_config.json

Pode abrir este ficheiro directamente no Windsurf através da paleta de comandos (Ctrl+Shift+P - Não . Cmd+Shift+PE procurando por Windsurf: Abra a configuração do MCP, ou navegando para Configurações de windsurf → MCP e clicando . Editar configuraçãoSe o ficheiro ainda não existir, crie-o.

Passo 2 Adicionar a entrada do servidor FXMacroData

Adicionar uma entrada para FXMacroData dentro do mcpServers Escolha a opção que melhor se encaixa na sua configuração:

Opção A Endpoint hospedado (zero instalação, mais simples)

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp"
    }
  }
}

Isto aponta Cascade para o servidor MCP FXMacroData produção usando o transporte HTTP Streamable. ping Para moedas não-USD, anexe sua chave API ao URL:

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Opção B Servidor local MCP via uvx

Use-o se preferir um processo local ou se a sua rede restringir o streaming HTTP de saída. uvx O runner faz o download e executa o mcp-server-fxmacrodata Pacote PyPI automaticamente.

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Passo 3 Recarregar os servidores MCP do Windsurf

Depois de salvar o arquivo de configuração, recarregue os servidores MCP para que o Windsurf pegue a nova entrada.Ctrl+Shift+P - Não . Cmd+Shift+PE corram:

Windsurf: Refresh MCP Servers

Alternativamente, navegar para Configurações de windsurf → MCP e clique no ícone refresh ao lado da sua lista de servidores. fxmacrodata aparecer na lista de servidores ativos com um indicador verde ligado.

Passo 4 Verificar a ligação em Cascade

Abra o painel Cascade e certifique-se de que está dentro . Agente modo (não Editar ou Chat). Tipo:

Run the FXMacroData ping tool.

Cascade chama o ... ping ferramenta no fundo. pong A resposta confirma que o servidor está acessível e que as suas credenciais são válidas.

Passo 5 Explorar as ferramentas disponíveis

Uma vez ligado, o Cascade registra todas as ferramentas expostas pelo servidor.

Cascade resolve qual ferramenta chamar a partir de seu prompt de linguagem natural. Você nunca precisa especificar um nome de ferramenta ou construir JSON basta fazer a pergunta.

Passo 6 Experimente um fluxo de trabalho real de analista

Você está construindo um sinal de carry-trade em um notebook Python e quer comparar o diferencial de taxa de política USDAUD com o movimento spot do AUD/USD no último ano.

Obter as taxas de política do USD e do AUD nos últimos 12 meses, em seguida, puxar a taxa de spot do AUS/USD para a mesma janela e escrever código Python para traçar o diferencial de taxa ao lado da taxa de câmbio.

Chamadas em cascata . indicator_query duas vezes (uma vez por moeda) e forex O equivalente REST chama que volta essas invocações de ferramentas são:

# USD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/usd/policy_rate?api_key=YOUR_API_KEY"

# AUD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"

# AUD/USD spot rate
curl "https://fxmacrodata.com/api/v1/forex/AUD/USD?api_key=YOUR_API_KEY"

Representante indicator_query Resposta:

{
  "currency": "AUD",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-04-01", "val": 4.10, "announcement_datetime": 1743483000 },
    { "date": "2026-02-18", "val": 4.10, "announcement_datetime": 1739862600 },
    { "date": "2025-12-10", "val": 4.35, "announcement_datetime": 1733806200 },
    { "date": "2025-11-05", "val": 4.35, "announcement_datetime": 1730793000 }
  ]
}

Com a taxa de política e série forex na mão, Cascade pode andaime o gráfico de comparação completa sem você escrever uma única chamada HTTP. Página do indicador de taxas de juro do AUD E ... Docs sobre a taxa de juro de política do dólar Mostre o esquema completo do indicador se quiser alargar a análise.

Caminho B chamadas diretas de REST API Alternativa

Se você preferir chamadas HTTP explícitas por exemplo dentro de um bloco de notas Jupyter aberto no Windsurf, ou ao criar um provedor de contexto Cascade personalizado você pode consultar FXMacroData diretamente via REST. Todos os endpoints aceitam uma chave API de parâmetro de consulta.

Recolha de dados de indicadores

import requests

BASE = "https://fxmacrodata.com/api/v1"
KEY  = "YOUR_API_KEY"

# Latest AUD inflation series
resp = requests.get(
    f"{BASE}/announcements/aud/inflation",
    params={"api_key": KEY},
    timeout=10,
)
data = resp.json()
for row in data["data"][:5]:
    print(row["date"], row["val"])

Verificação do calendário de lançamento

# Upcoming USD releases
resp = requests.get(
    f"{BASE}/calendar/usd",
    params={"api_key": KEY},
    timeout=10,
)
events = resp.json()
for event in events["data"][:3]:
    print(event["indicator"], event["release_date"])

Caso de transferência de moeda estrangeira

# EUR/USD last 30 trading days
resp = requests.get(
    f"{BASE}/forex/EUR/USD",
    params={"api_key": KEY},
    timeout=10,
)
rates = resp.json()["data"]
print(rates[0])  # {"date": "2026-04-15", "rate": 1.1342}

Uma lista completa das moedas e indicadores disponíveis encontra-se em /api-data-docsCada página de indicador inclui o caminho exato do ponto final, descrições de campos e exemplos de respostas por exemplo Inflação em euros Ou ... Lista de salários não agrícolas em USD- Não .

Resumo

Você ligou o FXMacroData ao Windsurf em duas etapas: adicionou uma entrada para ~/.codeium/windsurf/mcp_config.json apontando para o servidor FXMacroData MCP, e confirmou a ligação com um ping chamada no modo Cascade Agent. A partir daqui, cada pergunta de macro que você digitar no Cascade desencadeia uma chamada de dados ao vivo sem troca de guia do navegador, sem importações manuais de dados.

Pronto para explorar os dados disponíveis? Docs da API FXMacroData Para o catálogo completo dos indicadores, ou consulte o Referência do servidor MCP Para opções de autenticação e esquemas de ferramentas avançadas. subscrever para desbloquear todas as 18 moedas e o conjunto completo de indicadores.