How to Connect FXMacroData to Windsurf AI (MCP)

इस गाइड के अंत तक आपके विंडसर्फ आईडीई में मैक्रोइकॉनॉमिक इंडिकेटर सीरीज़, रिलीज कैलेंडर, सीएफटीसी सीओटी पोजिशनिंग, कीमती धातुओं की कीमतें और 18 मुद्राओं में विदेशी मुद्रा स्पॉट दरों तक लाइव पहुंच होगी सभी आपके एडिटर के अंदर से एआई कोडिंग प्रवाह को छोड़ने के बिना सादे अंग्रेजी में क्वेरी करने योग्य हैं।

मार्ग A MCP के माध्यम से कनेक्ट करें अनुशंसित

मॉडल संदर्भ प्रोटोकॉल (एमसीपी) विंडसर्फ के कैस्केड एजेंट में बाहरी उपकरण जोड़ने का मूल तरीका है. एक JSON कॉन्फ़िग ब्लॉक और कैस्केट स्वचालित रूप से प्रत्येक उपकरण को खोजता है जो FXMacroData सर्वर कोई स्कीमा परिभाषा, कोई HTTP बॉयलरप्लेट नहीं।

चरण 1 MCP विन्यास फ़ाइल खोलें

विंडसर्फ एक JSON फ़ाइल में MCP सर्वर परिभाषाओं को संग्रहीत करता हैः

~/.codeium/windsurf/mcp_config.json

आप इस फ़ाइल को सीधे विंडसर्फ में कमांड पैलेट के माध्यम से खोल सकते हैं (Ctrl+Shift+P / Cmd+Shift+P) और खोज रहे हैं विंडसर्फः MCP कॉन्फ़िग खोलें, या नेविगेट करके विंडसर्फ सेटिंग्स → एमसीपी और क्लिक कर रहा है कॉन्फ़िगरेशन संपादित करें. यदि फ़ाइल अभी तक मौजूद नहीं है, तो इसे बनाएँ.

चरण 2 FXMacroData सर्वर प्रविष्टि जोड़ें

के अंदर FXMacroData के लिए एक प्रविष्टि जोड़ें mcpServers ऑब्जेक्ट. विकल्प चुनें जो आपके सेटअप के लिए सबसे अच्छा फिट बैठता हैः

विकल्प A होस्ट किया गया एंडपॉइंट (शून्य स्थापना, सबसे सरल)

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

यह स्ट्रीम करने योग्य HTTP परिवहन का उपयोग कर उत्पादन FXMacroData MCP सर्वर पर कैस्केड को इंगित करता है। ping उपकरण बिना एपीआई कुंजी के तुरंत काम करता है. गैर-यूएसडी मुद्राओं के लिए, यूआरएल के लिए अपनी एपीआय कुंजी संलग्न करेंः

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

विकल्प B स्थानीय MCP सर्वर के माध्यम से uvx

यदि आप स्थानीय प्रक्रिया पसंद करते हैं या यदि आपका नेटवर्क आउटबाउंड HTTP स्ट्रीमिंग को प्रतिबंधित करता है तो इसका उपयोग करें. uvx रनर डाउनलोड करता है और निष्पादित करता है mcp-server-fxmacrodata PyPI पैकेज स्वचालित रूप से।

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

चरण 3 विंडसर्फ एमसीपी सर्वर को पुनः लोड करें

कॉन्फ़िग फ़ाइल सहेजने के बाद, MCP सर्वर को पुनः लोड करें ताकि विंडसर्फ नई प्रविष्टि उठाए. कमांड पैलेट खोलें (Ctrl+Shift+P / Cmd+Shift+P) और चलाओः

Windsurf: Refresh MCP Servers

वैकल्पिक रूप से, नेविगेट करें विंडसर्फ सेटिंग्स → एमसीपी और अपने सर्वर सूची के बगल में ताज़ा आइकन पर क्लिक करें. आपको देखना चाहिए fxmacrodata सक्रिय सर्वर सूची में हरे रंग के कनेक्टेड संकेतक के साथ दिखाई देगा।

चरण 4 कैस्केड में कनेक्शन सत्यापित करें

कैस्केड पैनल खोलें और सुनिश्चित करें कि आप में हैं एजेंट मोड (संपादित या चैट नहीं) । प्रकार:

Run the FXMacroData ping tool.

कैस्केड कॉल करता है ping पृष्ठभूमि में उपकरण। pong प्रतिक्रिया सर्वर की पुष्टि करता है और आपके क्रेडेंशियल्स मान्य हैं. आप लाइव डेटा क्वेरी करने के लिए तैयार हैं.

चरण 5 उपलब्ध साधनों का पता लगाएं

एक बार कनेक्ट होने के बाद, कैस्केड सर्वर द्वारा उजागर किए गए सभी उपकरणों को पंजीकृत करता है। यहाँ पूरा सेट हैः

कैस्केड आपके प्राकृतिक भाषा संकेत से कॉल करने के लिए कौन सा उपकरण तय करता है. आपको कभी भी एक उपकरण नाम निर्दिष्ट करने या JSON बनाने की आवश्यकता नहीं है बस सवाल पूछें।

चरण 6 एक वास्तविक विश्लेषक कार्यप्रवाह का प्रयास करें

आप एक पायथन नोटबुक में एक ले-ट्रेड सिग्नल बना रहे हैं और पिछले वर्ष में AUD/USD स्पॉट आंदोलन के साथ USDAUD नीति दर अंतर की तुलना करना चाहते हैं। कैस्केड एजेंट मोड में, विंडसर्फ को संकेत देंः

अंतिम 12 महीनों के लिए अमरीकी डालर और ऑस्ट्रेलियाई डालर की नीतिगत दरें प्राप्त करें, फिर उसी विंडो के लिए ऑस्ट्रेलियाई डॉलर/अमेरिकी डालर का स्पॉट दर निकालें और विनिमय दर के साथ दर अंतर को प्लॉट करने के लिए पायथन कोड लिखें।

कैस्केड कॉल indicator_query दो बार (एक बार प्रति मुद्रा) और forex एक बार, तो अपने खुले फ़ाइल में सीधे प्लॉटिंग कोड लिखता है. समकक्ष आराम कॉल है कि वापस इन उपकरण आह्वान कर रहे हैं:

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

प्रतिनिधि indicator_query उत्तरः

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

नीति दर और विदेशी मुद्रा श्रृंखला के साथ हाथ में, कैस्केड आप एक भी HTTP कॉल लिखने के बिना पूर्ण तुलना चार्ट मचान कर सकते हैं। एयूडी नीतिगत दर सूचक पृष्ठ और अमरीकी डालर नीतिगत दर डॉक्स यदि आप विश्लेषण का विस्तार करना चाहते हैं तो पूर्ण सूचक योजना दिखाएं।

पथ बी प्रत्यक्ष REST एपीआई कॉल विकल्प

यदि आप स्पष्ट HTTP कॉल पसंद करते हैं, उदाहरण के लिए विंडसर्फ में खुली Jupyter नोटबुक के अंदर, या कस्टम कैस्केड संदर्भ प्रदाता बनाते समय आप सीधे REST के माध्यम से FXMacroData क्वेरी कर सकते हैं. सभी एंडपॉइंट क्वेરી-पैरामीटर एपीआई कुंजी स्वीकार करते हैं.

सूचक डेटा प्राप्त करना

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

रिलीज कैलेंडर की जाँच करना

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

विदेशी मुद्रा स्पॉट दरों का उपयोग

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

उपलब्ध मुद्राओं और संकेतकों की पूरी सूची /api-data-docsप्रत्येक संकेतकों के पृष्ठ में अंतिम बिंदु पथ, क्षेत्र विवरण और उदाहरण उत्तर शामिल हैं। यूरो मुद्रास्फीति या अमरीकी डालर में गैर-कृषि वेतन. .

सारांश

आपने दो चरणों में FXMacroData को विंडसर्फ में तारित किया हैः में एक प्रविष्टि जोड़ी ~/.codeium/windsurf/mcp_config.json FXMacroData MCP सर्वर की ओर इशारा करते हुए, और एक के साथ कनेक्शन की पुष्टि की ping कैस्केड एजेंट मोड में कॉल करें. यहाँ से, आप कैस्केट में टाइप करते हैं प्रत्येक मैक्रो प्रश्न एक लाइव डेटा कॉल ट्रिगर करता है कोई ब्राउज़र टैब स्विचिंग, कोई मैनुअल डेटा आयात नहीं।

क्या आप उपलब्ध डेटा का पता लगाने के लिए तैयार हैं? FXMacroData एपीआई दस्तावेज़ पूर्ण सूचक सूची के लिए, या एमसीपी सर्वर संदर्भ प्रमाणीकरण विकल्पों और उन्नत उपकरण योजनाओं के लिए. यदि आपके पास अभी तक एपीआई कुंजी नहीं है, सदस्यता लेना सभी 18 मुद्राओं और पूर्ण सूचक सेट को अनलॉक करने के लिए।