Como conectar FXMacroData à IA do cursor (MCP)

Até o final deste guia, o Cursor 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 no editor sem sair do seu fluxo de trabalho de desenvolvimento.

Caminho A Conectar através do MCP Recomendado

Protocolo de contexto modelo (MCP) é o mecanismo nativo do Cursor para conectar ferramentas externas. Um bloco de configuração JSON e o Cursors auto-descobre todas as ferramentas que o servidor FXMacroData expõe sem código de plugin personalizado, sem boilerplate HTTP.

Passo 1 Configurações MCP abertas no cursor

O cursor lê as definições do servidor MCP a partir de um arquivo JSON. Há dois escopos que você pode usar:

• Global (recomendado) disponível em todos os seus projectos. Configurações do cursor (Cmd+Shift+J no macOS ou Ctrl+Shift+J no Windows/Linux), navegue para MCP, e clique Adicionar novo servidor global MCPIsto abre . ~/.cursor/mcp.json- Não .
• Nível do projecto abrangido por um único espaço de trabalho. .cursor/mcp.json arquivo na raiz do seu diretório de projeto.

De qualquer forma, a estrutura JSON é a mesma. Escolha a opção que melhor se adapte ao seu fluxo de trabalho.

Passo 2 Adicionar a configuração do servidor FXMacroData MCP

Abre . ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto) e adicionar a entrada FXMacroData. Duas opções estão disponíveis dependendo se você prefere um endpoint hospedado ou um processo local.

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

Ponta o cursor diretamente para o servidor FXMacroData MCP de produção através de dados HTTP Streamable. ping ferramenta de trabalho imediatamente sem uma chave API.

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

Para acesso completo a várias moedas, anexe sua chave API ao URL:

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "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 corredor faz download e executa o mcp-server-fxmacrodata Pacote PyPI automaticamente sem manual pip install necessários.

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

Passo 3 Reinicie o cursor e verifique se o servidor aparece

Depois de salvar o arquivo JSON, reinicie o cursor (ou recarregue a janela com Cmd+Shift+P - Não . Ctrl+Shift+P - Não. Desenvolvedor: Reload Window) O cursor analisará a configuração MCP e registrará quaisquer servidores que encontrar.

Para confirmar que o servidor está carregado, abra. Configurações do cursor → MCPDevias ver . fxmacrodata Se o status mostrar um erro, verifique a sintaxe do JSON e certifique-se de que uvx é instalado (para a opção B).

Passo 4 Verificar a ligação com um ping

Abra o painel de bate-papo do cursor, mude para Agente modo e tipo:

Run the FXMacroData ping tool.

O cursor chama o ping Uma ferramenta. 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 conectado, o agente do cursor tem acesso a todas as ferramentas expostas pelo servidor FXMacroData:

O agente do cursor resolve qual ferramenta chamar a partir do seu prompt de linguagem natural. Você nunca precisa especificar um nome de ferramenta ou escrever JSON basta fazer a pergunta.

Passo 6 Experimente um fluxo de trabalho real para desenvolvedores

Você está criando um sinal de carry-trade em um arquivo 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 do cursor . indicator_query duas vezes (uma vez por moeda) e forex As chamadas REST equivalentes por trás dessas 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 série de taxas de política e dados de taxa de ponto em mãos, o cursor pode construir o gráfico de comparação completo sem que você escreva uma única chamada HTTP ou saia do editor. 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 em um bloco de notas Jupyter executado através do Cursor, ou ao criar uma ferramenta de contexto personalizada você pode consultar FXMacroData diretamente através do REST. Todos os endpoints aceitam uma chave API de parâmetro de consulta.

Obtenção 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}

O catálogo completo dos indicadores encontra-se em /api-data-docsCada página 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 Cursor em duas etapas: adicionou a configuração do servidor para ~/.cursor/mcp.json (ou o equivalente ao nível do projecto) e confirmou a ligação com um ping chamada no modo agente. A partir daqui, cada pergunta de macro que você digitar no painel do agente do cursor desencadeia uma chamada de dados ao vivo sem guias do navegador, sem importação manual de dados, sem mudança de contexto.

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.