Aller au contenu

Replit + Occult API

Ajoutez le serveur MCP à un Repl via le panneau Integrations — aucun fichier de config. La configuration prend environ deux minutes et le serveur tourne en local : votre clé ne quitte jamais votre machine.

Ce que cela vous apporte

Grâce au serveur MCP, Replit Agent 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.

1. Obtenez une clé

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

2. Ajoutez le serveur

Replit n’a aucun fichier de configuration MCP : c’est le seul outil de notre liste où il n’y a rien à coller ni à commiter. Ajoutez le serveur depuis l’interface :

Replit Agent → Integrations → Add MCP server

Indiquez la commande npx avec les arguments -y occult-api-mcp, et définissez la variable d’environnement OCCULT_API_KEY avec votre clé.

3. Vérifiez la connexion

Demandez à Replit Agent :

prompt
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.

4. Un premier prompt à essayer

prompt
Avec le serveur MCP occult-api, créez une petite page Flask qui affiche le panchanga du jour pour une ville saisie par le visiteur.

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.

Bon à savoir sur Replit

  • Replit est le seul outil ici SANS fichier de configuration. Tout se configure dans le panneau Integrations : rien à coller, rien à commiter.
  • Enregistrez la clé API comme Secret Replit au lieu de la taper dans le panneau : elle ne suivra pas un fork du Repl.
  • Un Repl forké n’emporte pas vos Secrets. La personne qui le forke fournit sa propre clé, et c’est généralement ce que vous voulez.

Si vous préférez vous passer de MCP

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

curl
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.

Autres outils

Suivant