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 panel → hammer icon → Configure → View raw config में भी है।

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

Cascade से पूछें:

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

जवाब में पाँच टूल आने चाहिए:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

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 सूची पर ध्यान दीजिए: एक अनुरोध में चार गणनाएँ, शुल्क एक क्रेडिट। चार बार कॉल करने पर चार लगते हैं।