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

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

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