Cursor + Occult API

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

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

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

API कुंजी बनाएँ

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

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

अगर फ़ाइल हाथ से नहीं बदलना चाहते, तो यही सेटिंग Settings → Cursor Settings → MCP → Add new global MCP server में भी है।

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

Composer से पूछें:

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

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

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

occult-api MCP सर्वर से जयपुर का आज का पंचांग निकालो, और तिथि, नक्षत्र और राहु काल का समय दिखाओ। keys एक ही कॉल में भेजना।

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

• प्रोजेक्ट के अंदर की `.cursor/mcp.json` ग्लोबल फ़ाइल से ऊपर मानी जाती है। इसी तरह आप पूरी मशीन की सेटिंग बदले बिना किसी एक रिपॉज़िटरी को उसकी अपनी कुंजी दे सकते हैं।
• सेव करते ही Cursor MCP सर्वर दोबारा लोड कर लेता है। अगर टूल की सूची न दिखे, तो एडिटर दोबारा शुरू करने के बजाय Settings में सर्वर को बंद करके फिर चालू करें।
• हमेशा लागू होने वाले निर्देश हर प्रॉम्प्ट में दोहराने के बजाय `.cursor/rules/` में रखें — बस एक नियम कि हर गणना के लिए अलग कॉल नहीं, `keys` एक साथ भेजो, तुरंत अपना फ़ायदा दिखा देता है।

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