Cursor + Occult API

MCP sunucusu, 299 astroloji endpoint'ini Composer tarafından ç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ı kendisi yapar. Böylece yanıtındaki sayılar eğitim verisinden değil, efemeristen gelir.

Arama yapmak ve şemaları okumak ücretsizdir. Yalnızca başarılı bir call_endpoint kredi harcar; başarısız çağrılar ücretsizdir.

Kontrol panelinden bir anahtar oluşturun. yt_live_… biçimindedir ve kredi bakiyenizi taşır; bu yüzden onu bir parola gibi koruyun: istemci tarafı koda asla koymayın, asla 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ıza gerek yok; npx sunucuyu ilk çalıştırmada indirir.

Composer'a sorun:

occult-api sunucusundan hangi araçlara sahip olduğunu listele.

Beş araç görmeniz gerekir:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Liste boşsa sunucu başlamamıştır. En sık neden, yapılandırma dosyasının doğru yerde ama yanlış yapıda olmasıdır; bu yüzden 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; tithi, nakshatra ve rahu kaal aralığını göster. Anahtarları tek çağrıda topla.

Ajan bu soruyu ezberden yanıtlamak yerine API'yi çağırmalıdır. 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 dosyanın yerine geçer; makinenizdeki ayarları değiştirmeden tek bir depoya ayrı anahtar vermenin yolu budur.
• Cursor, MCP sunucularını kaydettiğinizde yeniden yükler. Araç listesi görünmezse editörü yeniden başlatmak yerine Settings içinde sunucuyu kapatıp yeniden açın.
• Kalıcı talimatları her prompt'ta tekrarlamak yerine `.cursor/rules/` içine koyun. Her hesaplama için ayrı çağrı yerine `keys` değerlerini tek çağrıda toplamasını söyleyen tek bir kural bile kendini hemen amorti eder.

Endpoint'ler sıradan HTTP'dir. Onları kullanmak için bu sayfadaki hiçbir şey zorunlu değildir:

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.