Codex + Occult API

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

[mcp_servers.occult-api]
command = "npx"
args = ["-y", "occult-api-mcp"]
env = { OCCULT_API_KEY = "yt_live_your_key_here" }

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

Demandez à Codex CLI :

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, listez tous les endpoints qui mentionnent « dasha », puis appelez celui de la Vimshottari pour un thème et affichez les cinq premières mahadashas dans un tableau.

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.

• Codex configure MCP en TOML, pas en JSON. Le nom de la table contient le nom du serveur : `[mcp_servers.occult-api]`.
• Notez le tiret bas dans `mcp_servers` : les outils JSON utilisent tous `mcpServers` en camelCase, et le TOML ne corrigera pas l’orthographe à votre place.
• Codex lit la config au lancement. Redémarrez la CLI après modification.

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.