Cursor + Occult API

Grâce au serveur MCP, Composer 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 ~/.cursor/mcp.json (sous Windows : %USERPROFILE%\.cursor\mcp.json) — créez-le s’il n’existe pas — et ajoutez :

{
  "mcpServers": {
    "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 Settings → Cursor Settings → MCP → Add new global MCP server.

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

Demandez à Composer :

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.

Avec le serveur MCP occult-api, récupérez le panchanga du jour pour Jaipur et montrez-moi la tithi, le nakshatra et la plage du rahu kaal. Regroupez les clés en un seul appel.

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.

• Un fichier `.cursor/mcp.json` propre au projet prend le pas sur le fichier global : c’est ainsi qu’on donne sa propre clé à un dépôt sans toucher à la configuration de sa machine.
• Cursor recharge les serveurs MCP à l’enregistrement. Si la liste des outils n’apparaît pas, désactivez puis réactivez le serveur dans Settings au lieu de redémarrer l’éditeur.
• Placez les consignes permanentes dans `.cursor/rules/` au lieu de les répéter dans chaque prompt : une seule règle demandant de regrouper les `keys` plutôt que d’appeler une fois par calcul est rentabilisée immédiatement.

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.