Agentes

Pégalo en tu agente antes de que empiece. Es markdown plano, sin autenticación y con CORS abierto: un agente puede descargarlo directamente.

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.

Cuatro reglas, cada una porque corresponde a un error que los agentes cometen de verdad aquí. No es una guía de estilo genérica.

• Agrupa con keys, no hagas bucles. Varios cálculos en una solicitud cuestan un crédito; los mismos cálculos en llamadas separadas cuestan uno cada una. Un agente que busca código legible escribirá el bucle, y lo pagará tu saldo.
• No reintentes un 402. Significa que la clave es válida y que el saldo está a cero. Un agente que lo trate como un fallo pasajero reintentará sin fin, y uno que lo trate como un fallo de autenticación regenerará una clave que funcionaba perfectamente. Solo se reintentan los 429 y los 5xx.
• La clave solo se usa en el servidor. Lo decimos explícitamente porque «llamar desde el cliente» es el camino fácil, y deja tu clave a la vista de todos.
• Lee la especificación, no adivines los nombres de los campos. El documento OpenAPI incluye cada campo, sus valores admitidos y un ejemplo para cada endpoint, verificado contra un servidor en producción en la mayoría de los casos. Una descarga es mejor que tres errores 400.

Nuestro servidor MCP expone los 299 endpoints mediante cinco herramientas, y buscar y leer esquemas no consume créditos: solo un cálculo real los consume. Un agente puede explorar toda la API gratis y gastar solo cuando calcula algo, lo que sale más barato y es más fiable que dejarle adivinar a partir de la documentación.

Vale la pena que le dediques dos minutos antes que tu agente: /AGENTS.md. Si el consejo está mal, serás tú quien lo descubra.