Windsurf + Occult API

Grâce au serveur MCP, Cascade 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 ~/.codeium/windsurf/mcp_config.json (sous Windows : %USERPROFILE%\.codeium\windsurf\mcp_config.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 Cascade panel → hammer icon → Configure → View raw config.

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

Demandez à Cascade :

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, calculez le thème natal du 15 août 1990 à 10 h 30 IST, à Jaipur, et donnez-moi l’ascendant, le signe lunaire et la mahadasha Vimshottari en cours.

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.

• Le fichier s’appelle `mcp_config.json`, pas `mcp.json` : le nom diffère de celui de Cursor, et coller la config dans le mauvais fichier échoue sans aucun message.
• Cascade doit être actualisé après modification : cliquez sur la flèche d’actualisation du panneau MCP au lieu de rouvrir Windsurf.

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.