Comment connecter FXMacroData à l'IA de Windsurf (MCP)

À la fin de ce guide, votre IDE Windsurf aura un accès direct aux séries d'indicateurs macroéconomiques, aux calendriers de sortie, au positionnement du COT de la CFTC, aux prix des métaux précieux et aux taux de change au comptant dans 18 devises tout cela peut être consulté en anglais clair depuis votre éditeur sans quitter le flux de codage de l'IA.

Le chemin A Connexion par MCP Recommandé

Protocole de contexte type (MCP) est la façon native d'ajouter des outils externes à l'agent Cascade de Windsurf. Un bloc de configuration JSON et Cascade détecte automatiquement chaque outil que le serveur FXMacroData expose aucune définition de schéma, aucune boilerplate HTTP.

Étape 1 Ouvrez le fichier de configuration MCP

Windsurf stocke les définitions du serveur MCP dans un fichier JSON à:

~/.codeium/windsurf/mcp_config.json

Vous pouvez ouvrir ce fichier directement dans Windsurf via la palette de commandes (Ctrl+Shift+P Je suis désolé . Cmd+Shift+PJe suis à la recherche de ... Windsurf: ouvrir la configuration du MCP, ou en naviguant vers Paramètres de surf → MCP et cliquez . Modifier la configurationSi le fichier n'existe pas encore, créez-le.

Étape 2 Ajouter l'entrée du serveur FXMacroData

Ajouter une entrée pour FXMacroData à l'intérieur du mcpServers Choisissez l'option qui correspond le mieux à votre configuration:

Option A Point final hébergé (installation nulle, le plus simple)

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

Cela pointe Cascade vers le serveur MCP FXMacroData de production en utilisant le transport HTTP Streamable. ping Pour les devises autres que l'USD, joignez votre clé API à l'URL:

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

Option B serveur MCP local via uvx

Utilisez ceci si vous préférez un processus local ou si votre réseau limite le streaming HTTP sortant. uvx Le runner télécharge et exécute le Le serveur de base de données Le paquet PyPI est automatiquement

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

Étape 3 Reload des serveurs MCP de Windsurf

Après avoir sauvegardé le fichier de configuration, recharger les serveurs MCP afin que Windsurf récupère la nouvelle entrée.Ctrl+Shift+P Je suis désolé . Cmd+Shift+PJe suis en train de courir .

Windsurf: Refresh MCP Servers

Vous pouvez également naviguer vers Paramètres de surf → MCP et cliquez sur l'icône de rafraîchissement à côté de votre liste de serveurs. Les données de fxmacrodata apparaître dans la liste des serveurs actifs avec un indicateur vert connecté.

Étape 4 Vérifier la connexion dans Cascade

Ouvrez le panneau Cascade et assurez-vous que vous êtes dedans . Je suis agent. mode (pas éditer ou discuter).

Run the FXMacroData ping tool.

Cascade appelle le ping L'outil est en arrière-plan. pong La réponse confirme que le serveur est accessible et que vos informations d'identification sont valides.

Étape 5 Évaluer les outils disponibles

Une fois connecté, Cascade enregistre tous les outils exposés par le serveur.

Cascade décide quel outil appeler à partir de votre prompt en langage naturel. Vous n'avez jamais besoin de spécifier un nom d'outil ou de construire JSON posez simplement la question.

Étape 6 Essayez un véritable flux de travail d'analyste

Vous construisez un signal de carry-trade dans un bloc-notes Python et souhaitez comparer le différentiel de taux de change USDAUD avec le mouvement au comptant AUD/USD au cours de la dernière année.

Récupérez les taux directeurs USD et AUD pour les 12 derniers mois, puis tirez le taux au comptant AUD/USD pour la même fenêtre et écrivez du code Python pour tracer le différentiel de taux parallèlement au taux de change.

Des appels en cascade . indicator_query deux fois (une fois par devise) et forex Une fois, il écrit le code de traçage directement dans votre fichier ouvert.

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

Je suis représentant . indicator_query Réponse:

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

Avec le taux de la politique et la série de devises en main, Cascade peut échafauder le tableau de comparaison complet sans que vous écriviez un seul appel HTTP. Page de l'indicateur des taux directeurs de l 'AUD Je suis désolé . Documents relatifs aux taux directeurs en USD Si vous souhaitez étendre l'analyse, vous pouvez voir le schéma complet des indicateurs.

Le chemin B appels directs à l' API REST Autre option

Si vous préférez des appels HTTP explicites par exemple à l'intérieur d'un bloc-notes Jupyter ouvert dans Windsurf, ou lors de la création d'une Cascade client contextuel personnalisé vous pouvez interroger FXMacroData directement via REST. Tous les terminaux acceptent une clé API de paramètre de requête.

Retrait des données de l'indicateur

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

Vérification du calendrier de sortie

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

Tirage des taux de change au comptant

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

Une liste complète des monnaies et indicateurs disponibles est disponible à l'adresse suivante: /api-data-docs Il est temps de le faire.Chaque page d'indicateur comprend le chemin exact du point final, des descriptions de champs et des exemples de réponses par exemple Inflation en euros ou ... Liste des salariés non agricoles en USDJe suis désolé .

Résumé

Vous avez branché FXMacroData dans Windsurf en deux étapes: ajouter une entrée à ~/.codeium/windsurf/mcp_config.json Il a été confirmé que la connexion avec un ping appel en mode Cascade Agent. A partir de là, chaque requête macro que vous tapez dans Cascade déclenche un appel de données en direct pas de basculement d'onglet du navigateur, pas d'importation manuelle de données.

Prêt à explorer les données disponibles ? Les documents de l'API FXMacroData sont fournis Pour le catalogue complet des indicateurs, ou consultez le Référence au serveur MCP Si vous n'avez pas encore de clé API, souscrivez Pour débloquer les 18 devises et le jeu d'indicateurs complet.