Codex + Occult API

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

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

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

API कुंजी बनाएँ

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

[mcp_servers.occult-api]
command = "npx"
args = ["-y", "occult-api-mcp"]
env = { OCCULT_API_KEY = "yt_live_your_key_here" }

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

Codex CLI से पूछें:

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

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

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

occult-api MCP सर्वर से वे सारे एंडपॉइंट दिखाओ जिनमें 'dasha' आता है, फिर किसी कुंडली के लिए विंशोत्तरी वाला कॉल करो और पहली पाँच महादशाएँ तालिका में दिखाओ।

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

• Codex में MCP का कॉन्फ़िग TOML में होता है, JSON में नहीं। तालिका के नाम में सर्वर का नाम आता है: `[mcp_servers.occult-api]`।
• `mcp_servers` में अंडरस्कोर पर ध्यान दें — JSON वाले सभी टूल camelCase में `mcpServers` लिखते हैं, और TOML आपकी वर्तनी ठीक नहीं करेगा।
• Codex कॉन्फ़िग शुरू होते समय पढ़ता है। बदलाव के बाद CLI दोबारा शुरू करें।

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