Replit + Occult API

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

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

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

API कुंजी बनाएँ

Replit में MCP की कोई कॉन्फ़िगरेशन फ़ाइल नहीं होती। हमारी सूची में यही एक टूल है जिसमें न कुछ पेस्ट करना है, न कमिट करना है। सर्वर इंटरफ़ेस से जोड़िए:

Replit Agent → Integrations → Add MCP server

कमांड में npx और आर्ग्युमेंट में -y occult-api-mcp दीजिए, और एनवायरनमेंट वेरिएबल OCCULT_API_KEY में अपनी कुंजी डालिए।

Replit Agent से पूछें:

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

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

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

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

occult-api MCP सर्वर से एक छोटा Flask पेज बनाओ जो विज़िटर के लिखे शहर का आज का पंचांग दिखाए।

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

• यहाँ Replit ही अकेला टूल है जिसमें कोई कॉन्फ़िगरेशन फ़ाइल नहीं। पूरा सेटअप Integrations पैनल से होता है, इसलिए न कुछ पेस्ट करना है, न कमिट करना है।
• API कुंजी पैनल में टाइप करने के बजाय Replit Secret के रूप में रखिए, ताकि Repl का फ़ोर्क बनने पर वह साथ न जाए।
• फ़ोर्क किए गए Repl में आपके Secrets नहीं जाते। जो फ़ोर्क करेगा, वह अपनी कुंजी डालेगा, और आम तौर पर आप यही चाहते हैं।

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