Model Context Protocol

Occult API'yi yapay zekâ asistanınızdan kullanın

Claude, Cursor ya da MCP uyumlu herhangi bir asistanı gerçek efemeris verilerine bağlayın. Panchanga, kundli ya da dasha'yı gündelik dille isteyin; karşılığında makul görünen bir uydurma değil, gerçek bir hesaplama alın.

siz:  Yarın gün doğumunda Jaipur için panchanga nedir?

      → tithi Chaturthi (Krishna paksha), yoga Vriddhi, karana Balava

Başlamadan önce

Bir API anahtarına ihtiyacınız var. Hesap oluşturun ve Anahtarlar sayfasından bir anahtar üretin. Anahtar yalnızca bir kez gösterilir, sayfadan ayrılmadan önce kopyalayın. Bunun dışında yalnızca Node 18 ya da daha yeni bir sürüm gerekir; gerisini npx ilk çalıştırmada indirir.

Kurulum

Tüm istemciler aynı bloğu kullanır. Bloğu aşağıdaki dosyaya ekleyin. Dosyada zaten bir mcpServers bölümü varsa ikinci bir bölüm eklemeyin, occult-api girdisini mevcut bölümün içine koyun.

{
  "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'ta C:Users<you>.claude.json

Claude Desktopclaude_desktop_config.jsonWindows'ta %APPDATA%Claude, macOS'te ~/Library/Application Support/Claude/

Cursor~/.cursor/mcp.json

Ardından uygulamayı tamamen kapatıp yeniden açın. MCP sunucuları açılışta bağlanır; pencereyi yenilemek yetmez.

Ya da terminalden

Claude Code komut satırı aracı kuruluysa aynı işi bu komut tek adımda yapar. VS Code eklentisinde claude komutu olmadığı için orada çalışmaz; onun yerine yukarıdaki yapılandırma dosyasını kullanın.

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

Asistan neler yapabilir

299 endpoint'in ve 330 hesaplamanın tamamını kapsayan beş araç. Her endpoint için ayrı bir araç bilerek yok: her araç her mesajda modelin bağlamında yer kaplar ve 299 araç, daha siz bir şey sormadan sohbeti boğardı. Bunun yerine asistan arama yapar.

check_accountÜcretsiz

Anahtarın çalıştığını doğrular ve kredi bakiyesini bildirir. Bir şey ters giderse asistandan önce bunu çalıştırmasını isteyin; sorunun anahtarda mı yoksa boş bakiyede mi olduğunu ayırt eder.

search_endpointsÜcretsiz

Bir hesaplamayı adına ya da özelliğine göre bulur. Bu adda bir endpoint olmasa da 'manglik' araması sonuç verir; çünkü yalnızca endpoint adlarında değil, tüm hesaplama adlarında arar.

describe_endpointÜcretsiz

İsteğin alanlarını, her alanın alabileceği değerleri ve canlı sunucuda doğrulanmış bir istek gövdesini verir.

call_endpoint1–25 kredi

Herhangi bir endpoint'i o endpoint'in ücretiyle çalıştırır: çoğu için bir kredi, PDF raporları ve yapay zekâ sohbeti için 25. Başarısız istekler ücretlendirilmez.

get_panchanga1 kredi

En sık yapılan istek için hazır bir kısayol; asistanın önce onu araması gerekmez.

Ücreti ne kadar

Doğrudan bir HTTP çağrısıyla tam olarak aynı: başarılı her hesaplama için bir kredi (PDF raporları ve yapay zekâ sohbeti için 25), başarısız istekler ücretsiz. Arama yapmak ve dokümantasyonu okumak ücretsizdir; asistan hiçbir şey harcamadan tüm API'yi keşfedebilir. Bakiye her çağrıyla birlikte döner ve 50 kredinin altına düştüğünüzde uyarı alırsınız.

Anahtarınız hakkında

Anahtar bilgisayarınızda kalır. Ortam değişkeninden okunur, API'ye bir başlık olarak gönderilir ve modele asla gösterilmez. Asistan sonuçları görür, kimlik bilgisini hiçbir zaman görmez.

Yine de sunucu tarafında saklanması gereken bir kimlik bilgisidir: anahtarı ele geçiren herkes kredilerinizi harcayabilir. Paylaşılan yapılandırma dosyalarına ve kod depolarına koymayın; sızdığından şüpheleniyorsanız Anahtarlar sayfasından yenileyin.

Bir sorun çıkarsa

"Your Occult API key is invalid, revoked, or expired": Yeni bir anahtar oluşturun, env bloğunu güncelleyin ve uygulamayı yeniden başlatın. MCP sunucuları ortam değişkenlerini yalnızca bir kez, açılışta okur.
"claude" bir komut olarak tanınmıyor: VS Code eklentisini kullanıyorsunuz; bu eklenti claude komutunu kurmaz. Yukarıdaki yapılandırma dosyasını kullanın, tam olarak aynı işi görür.
Sunucu hiç görünmüyor: JSON'un geçerli olduğunu kontrol edin, ardından uygulamayı tamamen kapatıp yeniden açın. Açılış hataları sohbete değil, istemcinin MCP günlüğüne yazılır.
Asistan bir hesaplamayı bulamıyor: Sanskritçe adını deneyin: "doğum haritası" yerine "kundli" gibi. Tüm hesaplamalar referansta listelenir.

API anahtarı alın npm'de görüntüleyin GitHub'daki kaynak kod