Cómo conectar FXMacroData a la IA de Windsurf (MCP)

Al final de esta guía, su IDE de Windsurf tendrá acceso en vivo a las series de indicadores macroeconómicos, calendarios de lanzamiento, posicionamiento de CFTC COT, precios de metales preciosos y tasas spot de divisas en 18 monedas todo consultable en inglés sencillo desde el interior de su editor sin salir del flujo de codificación de IA.

Ruta A Conexión a través de MCP Recomendado

Protocolo de contexto modelo (MCP) es la forma nativa de añadir herramientas externas al agente Cascade de Windsurf. Un bloque de configuración JSON y Cascade descubre automáticamente todas las herramienta que el servidor FXMacroData expone sin definiciones de esquema, sin boilerplate HTTP.

Paso 1 Abrir el archivo de configuración MCP

Windsurf almacena las definiciones del servidor MCP en un archivo JSON en:

~/.codeium/windsurf/mcp_config.json

Puede abrir este archivo directamente en Windsurf a través de la paleta de comandos (Ctrl+Shift+P - ¿ Qué ? Cmd+Shift+PY buscamos Windsurf: Configuración abierta de MCP, o navegando hacia Configuración de windsurf → MCP y haciendo clic . Editar la configuraciónSi el archivo aún no existe, créalo.

Paso 2 Añadir la entrada del servidor FXMacroData

Añadir una entrada para FXMacroData dentro del mcpServers Seleccione la opción que mejor se adapte a su configuración:

Opción A Endpoint alojado (instalación cero, más simple)

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

Esto señala Cascade en el servidor MCP de producción FXMacroData utilizando el transporte HTTP Streamable. ping Para monedas que no sean USD, añada su clave API a la URL:

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

Opción B servidor MCP local a través de uvx

Utilice esto si prefiere un proceso local o si su red restringe el streaming HTTP saliente. uvx El ejecutor descarga y ejecuta el El servidor de mcp-fxmacrodata El paquete PyPI se ejecuta automáticamente.

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

Paso 3 Recargar los servidores MCP de Windsurf

Después de guardar el archivo de configuración, vuelva a cargar los servidores MCP para que Windsurf recoge la nueva entrada.Ctrl+Shift+P - ¿ Qué ? Cmd+Shift+PY corra:

Windsurf: Refresh MCP Servers

O bien, navegar hacia Configuración de windsurf → MCP y haga clic en el icono de actualización junto a la lista de servidores. Fxmacrodata es el nombre de la aplicación aparecerá en la lista de servidores activos con un indicador verde conectado.

Paso 4 Verifique la conexión en Cascade

Abre el panel Cascade y asegúrate de estar dentro . Agente de la policía modo (no Editar o Chat). Tipo:

Run the FXMacroData ping tool.

Cascade llama a la ping herramienta en el fondo. pong La respuesta confirma que el servidor es accesible y sus credenciales son válidas.

Paso 5 Explore las herramientas disponibles

Una vez conectado, Cascade registra todas las herramientas que el servidor expone.

Cascade resuelve qué herramienta llamar desde su mensaje de lenguaje natural. Nunca necesita especificar un nombre de herramientas o construir JSON simplemente haga la pregunta.

Paso 6 Pruebe un flujo de trabajo real de analista

Está construyendo una señal de carry-trade en un cuaderno de Python y desea comparar el diferencial de tasa de política USDAUD con el movimiento al contado de AUD/USD durante el último año.

Recoja las tasas de política del USD y del AUD durante los últimos 12 meses, luego extraiga la tasa al contado del AUS/USD para la misma ventana y escriba código Python para trazar el diferencial de tasa junto con el tipo de cambio.

Las llamadas en cascada . indicator_query dos veces (una vez por moneda) y forex Una vez, luego escribe el código de trazado directamente en su archivo abierto.

# 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 Respuesta:

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

Con la tasa de política y la serie de divisas en la mano, Cascade puede construir el gráfico de comparación completo sin que escriba una sola llamada HTTP. Página del indicador de tipos de interés de la política de la AUD ¿ Qué ? Documentación sobre las tasas de interés de política monetaria en USD Muestra el esquema completo del indicador si quieres ampliar el análisis.

Ruta B llamadas directas de REST API El número de personas

Si prefiere llamadas HTTP explícitas por ejemplo dentro de un cuaderno de notas Jupyter abierto en Windsurf, o al crear un proveedor de contexto Cascade personalizado puede consultar FXMacroData directamente a través de REST. Todos los puntos finales aceptan una clave API de parámetro de consulta.

Obtención de datos 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"])

Verificación del calendario de lanzamiento

# 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"])

Pulling de las tasas de cambio al contado

# 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}

En el apartado 2 se incluye una lista completa de las monedas e indicadores disponibles . /api-datos-docCada página de indicadores incluye la ruta exacta del punto final, descripciones de campos y ejemplos de respuestas por ejemplo Inflación en euros ¿ Qué ? Las nóminas no agrícolas en dólares- ¿ Qué ?

Resumen de las actividades

Ha conectado FXMacroData a Windsurf en dos pasos: añadió una entrada a ~/.codeium/windsurf/mcp_config.json apuntando al servidor FXMacroData MCP, y confirmó la conexión con un ping desde aquí, cada pregunta de macro que escribas en Cascade desencadena una llamada de datos en vivo sin cambio de pestaña del navegador, sin importación manual de datos.

¿Está listo para explorar qué datos están disponibles? Docs de la API de FXMacroData Para obtener el catálogo completo de indicadores, o consulte el Referencia del servidor MCP Si aún no tiene una clave API, suscribirse Para desbloquear las 18 monedas y el conjunto completo de indicadores.