Cursor + Occult API

Der MCP-Server stellt 299 Astrologie-Endpoints als Tools bereit, die Composer direkt aufrufen kann. Statt eine API zu beschreiben und zu hoffen, dass das Modell eine korrekte Anfrage schreibt, durchsucht der Agent den Katalog, liest das echte Anfrageschema und führt den Aufruf aus. Die Zahlen in seiner Antwort stammen also aus den Ephemeriden, nicht aus seinen Trainingsdaten.

Suchen und Schemas lesen kostet nichts. Nur ein erfolgreicher call_endpoint verbraucht einen Credit, fehlgeschlagene Aufrufe sind kostenlos.

Erstell einen im Dashboard. Er sieht aus wie yt_live_… und hängt an deinem Credit-Guthaben – behandle ihn also wie ein Passwort: nie in clientseitigen Code, nie in einen Commit.

API-Schlüssel erstellen

Öffne ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json; leg die Datei an, falls es sie noch nicht gibt) und füg Folgendes hinzu:

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

Du willst die Datei nicht von Hand bearbeiten? Dieselbe Einstellung findest du unter Settings → Cursor Settings → MCP → Add new global MCP server.

Ersetz yt_live_your_key_here durch deinen echten Schlüssel. Sonst musst du nichts installieren – npx lädt den Server beim ersten Start.

Frag Composer:

Welche Tools hast du vom occult-api-Server? Liste sie auf.

Du solltest fünf Tools zurückbekommen:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Ist die Liste leer, wurde der Server nicht gestartet. Meist liegt die Konfigurationsdatei zwar am richtigen Ort, hat aber den falschen Aufbau – prüf also zuerst den Key-Namen oben.

Hol mit dem occult-api-MCP-Server das heutige Panchanga für Jaipur und zeig mir Tithi, Nakshatra und das Rahu-Kaal-Zeitfenster. Frag alle Keys in einem einzigen Aufruf ab.

Der Agent sollte die API aufrufen, statt aus dem Gedächtnis zu antworten. Kommt die Antwort sofort und ohne Tool-Aufruf, stammt sie aus den Trainingsdaten – sag „nutze die occult-api-Tools“, dann tut er es.

• Eine projektlokale `.cursor/mcp.json` hat Vorrang vor der globalen. So bekommt ein einzelnes Repo seinen eigenen Schlüssel, ohne dass du an deinem Rechner etwas änderst.
• Cursor lädt MCP-Server beim Speichern neu. Erscheint die Tool-Liste nicht, schalt den Server in den Settings aus und wieder ein, statt den Editor neu zu starten.
• Leg dauerhafte Anweisungen in `.cursor/rules/` ab, statt sie in jedem Prompt zu wiederholen. Schon eine Regel, die `keys` zu bündeln statt einmal pro Berechnung aufzurufen, zahlt sich sofort aus.

Die Endpoints sind ganz normales HTTP. Um sie zu nutzen, brauchst du nichts von dieser Seite:

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"]
  }'

Beachte das keys-Array: vier Berechnungen in einer Anfrage, abgerechnet als ein Credit. Vier einzelne Aufrufe kosten vier.