Windsurf + Occult API

MCP सर्वर 299 ज्योतिष एंडपॉइंट को Cascade के लिए कॉल किए जा सकने वाले टूल के रूप में देता है। API के बारे में बताकर यह उम्मीद करने के बजाय कि मॉडल सही अनुरोध लिखेगा, वह ख़ुद सूची में खोजता है, असली अनुरोध स्कीमा पढ़ता है और कॉल करता है — इसलिए उसके जवाब के अंक ट्रेनिंग डेटा से नहीं, एफ़ेमेरिस से आते हैं।

खोजने और स्कीमा पढ़ने पर कुछ नहीं लगता। क्रेडिट सिर्फ़ सफल call_endpoint पर लगता है, और विफल कॉल मुफ़्त हैं।

डैशबोर्ड में एक कुंजी बनाएँ। वह yt_live_… जैसी दिखती है और उससे आपका क्रेडिट बैलेंस जुड़ा होता है, इसलिए उसे पासवर्ड की तरह रखें: न क्लाइंट-साइड कोड में, न कमिट में।

API कुंजी बनाएँ

~/.codeium/windsurf/mcp_config.json खोलें (Windows पर: %USERPROFILE%\.codeium\windsurf\mcp_config.json), न हो तो बना लें, और यह जोड़ें:

{
  "mcpServers": {
    "occult-api": {
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

अगर फ़ाइल हाथ से नहीं बदलना चाहते, तो यही सेटिंग Cascade पैनल → हथौड़े वाला आइकन → Configure → View raw config में भी है।

yt_live_your_key_here की जगह अपनी असली कुंजी डालें। और कुछ इंस्टॉल नहीं करना — पहली बार चलने पर npx सर्वर ख़ुद ले आता है।

Cascade से पूछें:

occult-api सर्वर से तुम्हें कौन-कौन से टूल मिले हैं, उनकी सूची दिखाओ।

आपको पाँच टूल दिखने चाहिए:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

अगर सूची ख़ाली है, तो सर्वर शुरू नहीं हुआ। आम वजह यह होती है कि कॉन्फ़िग फ़ाइल सही जगह पर तो है, पर उसका ढाँचा गलत है — इसलिए सबसे पहले ऊपर दिया key का नाम जाँचें।

occult-api MCP सर्वर से 15 अगस्त 1990, सुबह 10:30 IST, जयपुर की जन्म कुंडली बनाओ, और लग्न, चंद्र राशि और चल रही विंशोत्तरी महादशा बताओ।

उसे याद से जवाब देने के बजाय API को कॉल करना चाहिए। अगर जवाब तुरंत आ जाए और उसमें कोई टूल कॉल न हो, तो एजेंट ने ट्रेनिंग डेटा से जवाब दिया है — उससे कहें “occult-api टूल इस्तेमाल करो”, और वह करेगा।

• फ़ाइल का नाम `mcp_config.json` है, `mcp.json` नहीं — यह Cursor वाले नाम से अलग है, और गलत फ़ाइल में चिपकाने पर बिना किसी त्रुटि के कुछ नहीं होता।
• बदलाव के बाद Cascade को रीफ़्रेश करना पड़ता है: Windsurf दोबारा खोलने के बजाय MCP पैनल में रीफ़्रेश वाला तीर दबाएँ।

एंडपॉइंट साधारण HTTP हैं। उन्हें इस्तेमाल करने के लिए इस पेज की कोई भी चीज़ ज़रूरी नहीं:

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H 'X-API-Key: yt_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "date_time": "2026-09-17T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana"]
  }'

keys सूची पर ध्यान दें: एक अनुरोध में चार गणनाएँ, और शुल्क एक क्रेडिट। चार बार कॉल करने पर चार लगते।