Cursor + Occult API

Le serveur MCP met 299 endpoints d’astrologie à disposition de Composer sous forme d’outils appelables. Au lieu de décrire une API en espérant que le modèle écrive une requête correcte, il parcourt le catalogue, lit le vrai schéma de requête et lance l’appel : les chiffres de sa réponse viennent des éphémérides, et non de ses données d’entraînement.

Rechercher 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 depuis 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 récupère le serveur au premier lancement.

Demandez à Composer :

Liste les outils dont tu disposes 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é. En général, le fichier de configuration est au bon endroit mais mal structuré : vérifiez d’abord le nom de la clé indiqué plus haut.

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

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

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

Les endpoints sont de simples appels HTTP. 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 dans une requête, facturés un seul crédit. Quatre appels séparés en coûtent quatre.