Agenten

Kopier das in deinen Agenten, bevor er loslegt. Es ist reines Markdown, ohne Authentifizierung und mit offenem CORS – ein Agent kann es auch direkt abrufen.

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.

Vier Regeln, und hinter jeder steckt ein Fehler, den Agenten hier tatsächlich machen. Kein allgemeiner Styleguide.

• Mit keys bündeln statt Schleifen schreiben. Mehrere Berechnungen in einer Anfrage kosten einen Credit; als einzelne Aufrufe kostet jede Berechnung einen. Ein Agent, der auf lesbaren Code optimiert, schreibt die Schleife – und dein Guthaben zahlt dafür.
• Einen 402 nicht wiederholen. Er bedeutet: Der Schlüssel ist gültig, das Guthaben leer. Ein Agent, der das für einen vorübergehenden Fehler hält, versucht es endlos weiter. Hält er es für einen Authentifizierungsfehler, erzeugt er einen neuen Schlüssel, obwohl der alte völlig in Ordnung ist. Wiederholen lohnt sich nur bei 429 und 5xx.
• Der Schlüssel gehört ausschließlich auf den Server. Das steht ausdrücklich drin, weil „einfach vom Client aus aufrufen“ der bequemste Weg ist – und deinen Schlüssel öffentlich macht.
• Spezifikation lesen, keine Feldnamen raten. Das OpenAPI-Dokument enthält jedes Feld, seine erlaubten Werte und für jeden Endpoint ein Beispiel, bei den meisten an einem Live-Server geprüft. Einmal nachlesen ist besser als drei 400er.

Unser MCP-Server stellt alle 299 Endpoints über fünf Tools bereit, und Suchen und Schemas lesen kostet keine Credits – nur eine echte Berechnung. Ein Agent kann die gesamte API kostenlos erkunden und zahlt erst, wenn er wirklich etwas berechnet. Das ist günstiger und zuverlässiger, als ihn anhand der Doku raten zu lassen.

Nimm dir zwei Minuten dafür, bevor dein Agent es tut: /AGENTS.md. Wenn ein Rat darin falsch ist, merkst am Ende du es.