Model Context Protocol

Occult API direkt in deinem KI-Assistenten

Verbinde Claude, Cursor oder jeden anderen MCP-fähigen Assistenten mit echten Ephemeridendaten. Frag in normaler Sprache nach einem Panchanga, einem Kundli oder einer Dasha – und du bekommst eine echte Berechnung zurück, keine Erfindung, die nur plausibel klingt.

du:  Wie ist das Panchanga für Jaipur morgen bei Sonnenaufgang?

     → Tithi Chaturthi (Krishna Paksha), Yoga Vriddhi, Karana Balava

Bevor du loslegst

Du brauchst einen API-Schlüssel. Leg ein Konto an und erstell auf der Seite „Schlüssel“ einen neuen. Er wird nur einmal angezeigt, also kopier ihn, bevor du die Seite verlässt. Ansonsten brauchst du nur Node 18 oder neuer – alles andere lädt npx beim ersten Start herunter.

Einrichtung

Alle Clients nutzen denselben Block. Füg ihn in die unten genannte Datei ein. Gibt es dort schon einen Abschnitt mcpServers, kommt occult-api dort hinein – leg keinen zweiten an.

{
  "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.jsonC:Users<you>.claude.json unter Windows

Claude Desktopclaude_desktop_config.json%APPDATA%Claude unter Windows, ~/Library/Application Support/Claude/ unter macOS

Cursor~/.cursor/mcp.json

Starte die App danach vollständig neu. MCP-Server werden beim Start verbunden – das Fenster neu zu laden reicht nicht.

Oder im Terminal

Wenn du Claude Code für die Kommandozeile installiert hast, erledigt dieser Befehl alles in einem Schritt. In der VS-Code-Erweiterung klappt das nicht, weil es dort keinen claude-Befehl gibt – nimm dann die Konfigurationsdatei oben.

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

Was der Assistent kann

Fünf Tools decken alle 299 Endpoints und 330 Berechnungen ab. Ein Tool pro Endpoint gibt es bewusst nicht: Jedes Tool steht bei jeder Nachricht im Kontext des Modells, und 299 davon würden das Gespräch verdrängen, bevor du überhaupt etwas gefragt hast. Stattdessen sucht der Assistent.

check_accountKostenlos

Prüft, ob der Schlüssel funktioniert, und zeigt das Credit-Guthaben. Lass den Assistenten das zuerst ausführen, wenn etwas nicht klappt – so siehst du, ob der Schlüssel ungültig oder das Guthaben leer ist.

search_endpointsKostenlos

Findet eine Berechnung über ihren Namen oder ein Stichwort. Auch „manglik“ führt zum Ziel, obwohl kein Endpoint so heißt – durchsucht werden alle Berechnungen, nicht nur die Namen der Endpoints.

describe_endpointKostenlos

Die genauen Felder der Anfrage, die erlaubten Werte für jedes Feld und ein Anfrage-Body, der an einem Live-Server geprüft wurde.

call_endpoint1–25 Credits

Ruft jeden beliebigen Endpoint zu dessen Preis auf – ein Credit für die meisten, 25 für PDF-Berichte und KI-Chat. Fehlgeschlagene Anfragen kosten nichts.

get_panchanga1 Credit

Eine feste Abkürzung für die häufigste Anfrage, damit der Assistent sie nicht erst suchen muss.

Was es kostet

Genau so viel wie ein direkter HTTP-Aufruf: ein Credit pro erfolgreicher Berechnung (25 für PDF-Berichte und KI-Chat), nichts für fehlgeschlagene Anfragen. Suchen und Doku lesen sind kostenlos, ein Assistent kann also die ganze API erkunden, ohne etwas auszugeben. Mit jedem Aufruf kommt dein aktuelles Guthaben zurück, und unter 50 Credits bekommst du eine Warnung.

Zu deinem Schlüssel

Der Schlüssel bleibt auf deinem Rechner. Er wird aus der Umgebung gelesen, als Header an die API geschickt und dem Modell nie gezeigt. Der Assistent sieht die Ergebnisse, aber nie die Zugangsdaten.

Trotzdem ist er ein serverseitiger Zugangsschlüssel: Wer ihn hat, kann deine Credits ausgeben. Er gehört nicht in geteilte Konfigurationen oder Repositories. Wenn du glaubst, dass er öffentlich geworden ist, tausch ihn auf der Seite „Schlüssel“ aus.

Wenn etwas nicht klappt

„Your Occult API key is invalid, revoked, or expired“: Erstell einen neuen Schlüssel, aktualisier den env-Block und starte die App neu. MCP-Server lesen ihre Umgebung nur einmal ein, beim Start.
„claude“ wird nicht als Befehl erkannt: Du nutzt die VS-Code-Erweiterung, und die installiert keinen claude-Befehl. Nimm die Konfigurationsdatei oben – das Ergebnis ist genau dasselbe.
Der Server taucht überhaupt nicht auf: Prüf, ob das JSON gültig ist, und starte die App dann vollständig neu. Fehler beim Start landen im MCP-Log des Clients, nicht im Chat.
Der Assistent findet eine Berechnung nicht: Versuch es mit dem Sanskrit-Namen, also „kundli“ statt „Geburtshoroskop“. Alle Berechnungen findest du in der Referenz.

API-Schlüssel holen Auf npm ansehen Quellcode auf GitHub