Cursor + Occult API

MCP sunucusu, 299 astroloji endpoint'ini Composer için çağrılabilir araçlar olarak sunar. Bir API'yi tarif edip modelin doğru isteği yazmasını ummak yerine, model kataloğu arar, gerçek istek şemasını okur ve çağrıyı yapar. Böylece yanıtındaki rakamlar eğitim verisinden değil, efemeristen gelir.

Arama yapmak ve şema okumak ücretsizdir. Kredi yalnızca başarılı bir call_endpoint çağrısında harcanır; başarısız çağrılar ücretsizdir.

Kontrol panelinden bir anahtar oluşturun. Anahtar yt_live_… biçimindedir ve kredi bakiyenize bağlıdır; ona bir parola gibi davranın: istemci tarafı koda koymayın, depoya commit etmeyin.

API anahtarı oluşturun

~/.cursor/mcp.json dosyasını açın (Windows'ta: %USERPROFILE%\.cursor\mcp.json; yoksa oluşturun) ve şunu ekleyin:

{
  "mcpServers": {
    "occult-api": {
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

Dosyayı elle düzenlemek istemiyorsanız aynı ayar Settings → Cursor Settings → MCP → Add new global MCP server altında da bulunur.

yt_live_your_key_here yerine gerçek anahtarınızı yazın. Başka bir şey kurmanız gerekmez; npx sunucuyu ilk çalıştırmada indirir.

Composer'a şunu sorun:

occult-api sunucusundan gelen araçları listele.

Beş araç görmelisiniz:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Liste boşsa sunucu başlamamıştır. En yaygın neden, yapılandırma dosyasının doğru yerde ama yanlış yapıda olmasıdır; her şeyden önce yukarıdaki anahtar adını kontrol edin.

occult-api MCP sunucusunu kullanarak Jaipur için bugünün panchanga'sını al ve bana tithi, nakshatra ve rahu kaal aralığını göster. Anahtarları tek çağrıda topla.

Ajan bu soruyu ezberden değil, API'yi çağırarak yanıtlamalı. Yanıt anında gelir ve hiçbir araç çağrısı içermezse ajan eğitim verisinden yanıt vermiştir; “occult-api araçlarını kullan” deyin, kullanacaktır.

• Projeye özel bir `.cursor/mcp.json` dosyası genel dosyayı geçersiz kılar; bilgisayarınızın ayarlarını değiştirmeden tek bir depoya kendi anahtarını bu şekilde verebilirsiniz.
• Cursor, MCP sunucularını kaydettiğinizde yeniden yükler. Araç listesi görünmezse editörü yeniden başlatmak yerine Settings'te sunucuyu kapatıp açın.
• Sürekli geçerli talimatları her prompt'ta tekrarlamak yerine `.cursor/rules/` klasörüne yazın. Her hesaplama için ayrı çağrı yapmak yerine `keys` ile tek istekte toplamayı söyleyen tek bir kural, kendini anında amorti eder.

Endpoint'ler sıradan HTTP endpoint'leridir. Onları kullanmak için bu sayfadakilerin hiçbiri gerekmez:

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 dizisine dikkat edin: tek istekte dört hesaplama, tek kredi olarak ücretlendirilir. Dört ayrı çağrı dört kredi tutar.