सीधे सामग्री पर जाएँ
Occult API
Model Context Protocol

अपने AI असिस्टेंट से Occult API इस्तेमाल करें

Claude, Cursor या MCP चलाने वाले किसी भी असिस्टेंट को असली एफ़ेमेरिस डेटा से जोड़िए। पंचांग, कुंडली या दशा सीधी भाषा में पूछिए और जवाब में असली गणना पाइए, सच जैसी दिखने वाली कोई गढ़ी हुई बात नहीं।

आप:  कल सूर्योदय के समय जयपुर का पंचांग क्या है?

     → तिथि चतुर्थी (कृष्ण पक्ष), योग वृद्धि, करण बालव

शुरू करने से पहले

आपको एक API कुंजी चाहिए। खाता बनाइए और कुंजियों वाले पेज से कुंजी बनाइए। यह सिर्फ़ एक बार दिखती है, इसलिए पेज छोड़ने से पहले कॉपी कर लीजिए। इसके अलावा बस Node 18 या उससे नया संस्करण चाहिए। बाकी सब npx पहली बार चलने पर ख़ुद डाउनलोड कर लेता है।

सेटअप

हर क्लाइंट के लिए यही एक ब्लॉक है। इसे नीचे दी गई फ़ाइल में जोड़िए। अगर फ़ाइल में पहले से mcpServers वाला हिस्सा है, तो दूसरा न बनाएँ, occult-api को उसी के अंदर रखें।

{
  "mcpServers": {
    "occult-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}
Claude Code (VS Code)~/.claude.jsonWindows पर C:Users<you>.claude.json
Claude Desktopclaude_desktop_config.jsonWindows पर %APPDATA%Claude, macOS पर ~/Library/Application Support/Claude/
Cursor~/.cursor/mcp.json

फिर ऐप को पूरी तरह बंद करके दोबारा खोलिए। MCP सर्वर ऐप शुरू होते समय ही जुड़ते हैं, इसलिए सिर्फ़ विंडो रीलोड करना काफ़ी नहीं।

या टर्मिनल से

अगर आपके पास Claude Code की कमांड लाइन इंस्टॉल है, तो यह कमांड एक ही कदम में यही काम कर देती है। VS Code एक्सटेंशन में यह नहीं चलेगी, क्योंकि उसमें claude कमांड नहीं होती। वहाँ ऊपर वाली कॉन्फ़िग फ़ाइल इस्तेमाल करें।

claude mcp add occult-api -e OCCULT_API_KEY=yt_live_your_key_here -- npx -y occult-api-mcp

असिस्टेंट क्या-क्या कर सकता है

पाँच टूल, जो सभी 299 एंडपॉइंट और 330 गणनाओं को संभालते हैं। हर एंडपॉइंट के लिए अलग टूल जानबूझकर नहीं बनाया गया। हर टूल हर संदेश के साथ मॉडल के संदर्भ में रहता है, और 299 टूल आपके कुछ पूछने से पहले ही बातचीत की सारी जगह घेर लेते। इसलिए असिस्टेंट खोजकर काम करता है।

check_accountमुफ़्त

जाँचता है कि कुंजी चल रही है, और क्रेडिट बैलेंस बताता है। कुछ भी विफल हो तो असिस्टेंट से सबसे पहले यही चलवाइए। इससे पता चल जाता है कि कुंजी गलत है या बैलेंस ख़ाली।

search_endpointsमुफ़्त

नाम या सुविधा से कोई गणना खोजता है। 'manglik' खोजने पर भी नतीजा मिलता है, जबकि इस नाम का कोई एंडपॉइंट नहीं है, क्योंकि यह सिर्फ़ एंडपॉइंट के नाम नहीं, हर गणना का नाम खोजता है।

describe_endpointमुफ़्त

अनुरोध के सटीक फ़ील्ड, हर फ़ील्ड में कौन-से मान चलते हैं, और लाइव सर्वर पर परखा हुआ एक अनुरोध।

call_endpoint1–25 क्रेडिट

कोई भी एंडपॉइंट चलाता है, उसी एंडपॉइंट की कीमत पर: ज़्यादातर के लिए एक क्रेडिट, PDF रिपोर्ट और AI चैट के लिए 25। विफल अनुरोध पर शुल्क नहीं लगता।

get_panchanga1 क्रेडिट

सबसे आम अनुरोध के लिए सीधा रास्ता, ताकि असिस्टेंट को पहले खोजना न पड़े।

कितना खर्च

ठीक उतना ही जितना सीधी HTTP कॉल पर: हर सफल गणना पर एक क्रेडिट (PDF रिपोर्ट और AI चैट पर 25), और विफल अनुरोध पर कुछ नहीं। खोजना और डॉक्स पढ़ना मुफ़्त है, इसलिए असिस्टेंट बिना कुछ खर्च किए पूरा API देख सकता है। हर कॉल के साथ बैलेंस बताया जाता है, और 50 क्रेडिट से कम रह जाने पर चेतावनी मिलती है।

आपकी कुंजी के बारे में

कुंजी आपकी मशीन पर ही रहती है। वह एनवायरनमेंट से पढ़ी जाती है, हेडर में API को भेजी जाती है, और मॉडल को कभी नहीं दिखाई जाती। असिस्टेंट को सिर्फ़ नतीजे दिखते हैं, कुंजी नहीं।

फिर भी यह सर्वर पर रखी जाने वाली गुप्त कुंजी है। जिसके पास यह होगी, वह आपके क्रेडिट खर्च कर सकता है। इसे साझा कॉन्फ़िग और रिपॉज़िटरी से दूर रखें, और लीक होने का शक हो तो कुंजियों वाले पेज से इसे बदल दें।

अगर कुछ गड़बड़ हो

"Your Occult API key is invalid, revoked, or expired"
नई कुंजी बनाइए, env ब्लॉक में बदलिए और ऐप दोबारा शुरू कीजिए। MCP सर्वर अपना एनवायरनमेंट सिर्फ़ एक बार, शुरू होते समय पढ़ते हैं।
"claude" को कमांड के रूप में पहचाना नहीं गया
आप VS Code एक्सटेंशन इस्तेमाल कर रहे हैं, जो claude कमांड इंस्टॉल नहीं करता। ऊपर वाली कॉन्फ़िग फ़ाइल इस्तेमाल करें, वह ठीक यही काम करती है।
सर्वर दिख ही नहीं रहा
जाँचिए कि JSON सही है, फिर ऐप को पूरी तरह दोबारा शुरू कीजिए। शुरुआत की त्रुटियाँ चैट में नहीं, क्लाइंट के MCP लॉग में जाती हैं।
असिस्टेंट को कोई गणना नहीं मिल रही
संस्कृत नाम से पूछिए, जैसे "birth chart" की जगह "kundli"। हर गणना API संदर्भ में दी गई है।
API कुंजी लेंnpm पर देखेंGitHub पर सोर्स