GitHub Copilot + Occult API

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

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

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

API कुंजी बनाएँ

.vscode/mcp.json खोलिए (न हो तो बना लीजिए) और यह जोड़िए:

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

अगर फ़ाइल हाथ से नहीं बदलना चाहते, तो यही सेटिंग Command Palette → MCP: Add Server → Command (stdio) में भी है।

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

Copilot एजेंट मोड से पूछें:

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

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

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

एजेंट मोड में: occult-api के टूल से जाँचो कि यह जन्म कुंडली मांगलिक है या नहीं, और API जो कारण देता है वे पूरे दिखाओ, उनका सार नहीं।

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

• VS Code में सबसे ऊपर की कुंजी `servers` है, `mcpServers` नहीं। इस सूची के बाकी सभी टूल `mcpServers` इस्तेमाल करते हैं, इसलिए कहीं से कॉपी किया गया हिस्सा ख़ाली सर्वर सूची के रूप में लोड होगा और कोई त्रुटि नहीं दिखेगी।
• MCP टूल सिर्फ़ एजेंट मोड में मिलते हैं। Chat व्यू को Ask से Agent पर बदलिए, वरना सर्वर जुड़ तो जाएगा पर कोई उस तक पहुँच नहीं पाएगा।
• यह फ़ाइल रिपॉज़िटरी के साथ कमिट होती है, इसलिए कुंजी पेस्ट करने के बजाय `${input:...}` इस्तेमाल कीजिए। पहली बार चलने पर VS Code कुंजी ख़ुद पूछ लेगा।

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