Agents

Collez ceci dans votre agent avant qu’il ne commence. C’est du Markdown simple, sans authentification, avec CORS ouvert : un agent peut le récupérer directement.

Read https://occultapi.com/AGENTS.md before writing any code against Occult API.
Use the OpenAPI spec at https://occultapi.com/openapi.json for exact field names.

Quatre règles, chacune répondant à une erreur que les agents font réellement ici. Ce n’est pas un guide de style générique.

• Regroupez avec keys, pas de boucle. Plusieurs calculs dans une même requête coûtent un crédit ; les mêmes calculs en appels séparés coûtent un crédit chacun. Un agent qui privilégie un code lisible écrira la boucle, et c’est votre solde qui paiera.
• Ne relancez pas une erreur 402. Elle signifie que la clé est valide et le solde vide. Un agent qui y voit une panne passagère relancera indéfiniment ; un agent qui y voit un échec d’authentification régénérera une clé parfaitement valide. Seules les erreurs 429 et 5xx peuvent être relancées.
• La clé s’utilise uniquement côté serveur. Nous le précisons, car « l’appeler depuis le client » est la solution de facilité, et elle publie votre clé.
• Lisez la spécification, ne devinez pas les noms de champs. Le document OpenAPI contient chaque champ, ses valeurs autorisées et un exemple pour chaque endpoint, vérifié sur un serveur en service pour la plupart. Une seule lecture vaut mieux que trois erreurs 400.

Notre serveur MCP expose les 299 endpoints via cinq outils, et rechercher ou lire les schémas ne coûte aucun crédit : seul un vrai calcul est facturé. Un agent peut explorer toute l’API gratuitement et ne dépenser que lorsqu’il calcule quelque chose. C’est à la fois moins cher et plus fiable que de le laisser deviner à partir de la documentation.

Cela vaut deux minutes de votre temps avant d’en valoir pour votre agent : /AGENTS.md. C’est vous qui découvrirez si le conseil était mauvais.