GitHub Copilot mit Occult API

Der MCP-Server stellt 299 Astrologie-Endpoints als Tools bereit, die Copilot im Agent-Modus aufrufen kann. Statt nur eine API-Beschreibung zu bekommen und hoffentlich eine korrekte Anfrage zu schreiben, durchsucht der Agent den Katalog, liest das echte Anfrageschema und setzt den Aufruf ab. Die Zahlen in seiner Antwort stammen also aus den Ephemeriden und 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 .vscode/mcp.json (leg die Datei an, falls es sie noch nicht gibt) und füg Folgendes ein:

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

Wenn du die Datei nicht von Hand bearbeiten willst: Dieselbe Einstellung findest du unter Befehlspalette → MCP: Add Server → Command (stdio).

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 Copilot im Agent-Modus:

Liste die Tools auf, die dir der occult-api-Server zur Verfügung stellt.

Du solltest fünf Tools sehen:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Ist die Liste leer, ist der Server nicht gestartet. Meist liegt die Konfigurationsdatei dann am richtigen Ort, hat aber das falsche Format. Prüf deshalb zuerst den Key-Namen oben.

Im Agent-Modus: Prüf mit den occult-api-Tools, ob dieses Geburtshoroskop manglik ist, und zeig mir die Begründung, die die API liefert, statt sie zusammenzufassen.

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 dann „nutze die occult-api-Tools“, und er tut es.

• VS Code nutzt `servers` als obersten Key, NICHT `mcpServers`. Alle anderen Tools auf dieser Liste nutzen `mcpServers` – ein kopiertes Snippet wird deshalb als leere Serverliste geladen, ohne jede Fehlermeldung.
• MCP-Tools gibt es nur im Agent-Modus. Stell die Chat-Ansicht von Ask auf Agent um – sonst ist der Server zwar verbunden, aber nichts greift auf ihn zu.
• Die Datei wird mit dem Repo committet. Nutze für den Schlüssel deshalb `${input:...}`, statt ihn einzufügen – VS Code fragt den Wert beim ersten Start ab.

Die Endpoints sind ganz normales HTTP. Nichts auf dieser Seite ist nötig, um sie zu nutzen:

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

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