GitHub Copilot + Occult API

Grâce au serveur MCP, le mode agent de Copilot peut appeler 299 endpoints d’astrologie comme des outils. Plutôt que d’écrire une requête d’après une description de l’API en espérant qu’elle soit correcte, il cherche dans le catalogue, lit le vrai schéma de requête et fait l’appel : les nombres de sa réponse viennent ainsi des éphémérides, et non de ses données d’entraînement.

Chercher et lire les schémas ne coûte rien. Seul un call_endpoint réussi consomme un crédit, et les appels en échec sont gratuits.

Créez-en une dans le tableau de bord. Elle ressemble à yt_live_… et donne accès à votre solde de crédits : traitez-la comme un mot de passe. Jamais dans du code côté client, jamais dans un commit.

Créer une clé API

Ouvrez .vscode/mcp.json (créez-le s’il n’existe pas) et ajoutez :

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

Si vous préférez ne pas modifier le fichier à la main, le même réglage se trouve dans Command Palette → MCP: Add Server → Command (stdio).

Remplacez yt_live_your_key_here par votre vraie clé. Rien d’autre à installer : npx télécharge le serveur au premier lancement.

Demandez au mode agent de Copilot :

Listez les outils dont vous disposez via le serveur occult-api.

Vous devriez obtenir cinq outils :

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Si la liste est vide, le serveur n’a pas démarré. La cause habituelle : le fichier de config est au bon endroit, mais sa structure est mauvaise. Vérifiez donc d’abord le nom de la clé indiqué plus haut.

En mode agent : utilisez les outils occult-api pour vérifier si ce thème natal est manglik, et montrez le raisonnement renvoyé par l’API au lieu de le résumer.

L’agent doit appeler l’API plutôt que répondre de mémoire. Si la réponse arrive instantanément sans aucun appel d’outil, il a répondu à partir de ses données d’entraînement : dites-lui « utilisez les outils occult-api » et il le fera.

• VS Code utilise `servers` comme clé de premier niveau, et NON `mcpServers`. Tous les autres outils de cette liste utilisent `mcpServers` : un extrait copié tel quel se chargera comme une liste de serveurs vide, sans la moindre erreur.
• Les outils MCP ne sont disponibles qu’en mode agent. Faites passer la vue Chat de Ask à Agent, sinon le serveur se connecte mais rien ne peut l’atteindre.
• Le fichier est commité avec le dépôt : utilisez `${input:...}` pour la clé au lieu de la coller. VS Code demandera la valeur au premier lancement.

Les endpoints sont du HTTP ordinaire. Rien sur cette page n’est nécessaire pour les utiliser :

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

Remarquez le tableau keys : quatre calculs en une seule requête, facturés un seul crédit. Quatre appels coûteraient quatre crédits.