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

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

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