GitHub Copilot + Occult API

MCP सर्वर 299 ज्योतिष एंडपॉइंट को Copilot agent mode के लिए कॉल किए जा सकने वाले टूल के रूप में देता है। 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 agent mode से पूछें:

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

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

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

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

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

• VS Code में सबसे ऊपर की key `servers` है, `mcpServers` नहीं। इस सूची के बाकी सभी टूल `mcpServers` इस्तेमाल करते हैं, इसलिए कहीं से कॉपी किया स्निपेट ख़ाली सर्वर सूची के रूप में लोड होगा और कोई त्रुटि नहीं आएगी।
• MCP टूल सिर्फ़ agent mode में मिलते हैं। Chat view को 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 सूची पर ध्यान दें: एक अनुरोध में चार गणनाएँ, और शुल्क एक क्रेडिट। चार बार कॉल करने पर चार लगते।