Docs-Menü

Memory-Tools und API

Referenz der sieben MCP-Tools von Tulimoa Memory und der HTTP-Endpoints für Batch-Writes, Dokument-Import und die Briefing-Seite.

Stand: 12. Sept. 2026

Alle sieben Tools liegen im tulimoa-Namespace. Jeder Tool-Call kostet einen Call-Preis (0,002 $) und wird abgerechnet, bevor das Tool läuft; nur tulimoa__link_account ist kostenlos. initialize und tools/list kosten nie etwas.

Die Routine, die am besten funktioniert: recall ohne Suchbegriff zu Aufgabenbeginn, um Ziel, letzten Zwischenstand und offene Punkte zu sehen, recall mit Suchbegriff, bevor der Agent den Nutzer etwas fragt, remember, sobald etwas Dauerhaftes entsteht, checkpoint vor mehrstufiger Arbeit und wenn ein offener Punkt erledigt ist, und recall noch einmal vor dem Abschluss.

Mit write markierte Tools brauchen einen Key mit write-Scope, ebenso /ingest und /import. Keys aus /register und aus dem Dashboard haben read und write. Ein Key nur zum Lesen bekommt bei diesen Calls einen Fehler und zahlt dafür nichts.

Merken und planen

tulimoa__remember(text, kind?, key?, durable?, entities?)write

Speichert eine Erinnerung: einen fact, eine decision, eine preference oder eine note (kind). Sie ist sofort mit recall auffindbar und wird über Nacht konsolidiert. Ein späteres remember mit demselben key ersetzt diese im ganzen Konto. durable ist standardmäßig true. entities markiert personenbezogene Daten ausdrücklich als {value, etype} mit person, email, phone, iban oder custom, damit sie in den Tresor gehen. Die Wichtigkeit wird automatisch bestimmt, und Text, der wie ein Credential aussieht, wird abgelehnt.

tulimoa__checkpoint(goal?, done?, next_steps?, open_questions?, resolved?)write

Hält fest, wo der Agent steht. Nur goal setzt ein Ziel, die volle Form sichert den Fortschritt, damit die Arbeit nach einem Kontext-Reset weitergehen kann. Jeder Eintrag in open_questions wird ein offener Punkt, der bei jedem recall mitkommt, bis er erledigt ist. resolved schließt offene Punkte über ihre 8-stellige ID aus recall (etwa a1b2c3d4) oder ihren genauen Text. Mindestens ein Feld ist nötig.

tulimoa__forget(id?, key?, topic?, pii_token?)write

Entfernt eine Erinnerung über id oder key; die id kann ein Erlebnis oder ein Wissenseintrag sein, recall liefert beides. Nur mit topic listet es bis zu 8 Treffer und löscht nichts, der Agent kann also erst nachsehen. Mit pii_token werden die Daten dieser Person per Crypto-Shredding endgültig vernichtet. Details unter Datenschutz und Löschen.

Abrufen und zurückblicken

tulimoa__recall(query?, limit?)

Mit query: was das Gedächtnis darüber weiß, plus offene Punkte und Warnungen. Wissen aus dem Graphen und noch nicht konsolidierte Erlebnisse werden gemeinsam gerankt, was heute gemerkt wurde, findet sich also heute. Zurück kommen nur Treffer über einer Relevanzschwelle, höchstens limit (1 bis 25, Standard 8), mit verwandtem Wissen dazu und Warnungen vor früherem Ärger vorn. Ist nichts Passendes gespeichert, sagt es das, und dann weiß dein Agent es nicht. Ohne query: der Status, also aktuelles Ziel, letzter Zwischenstand, offene Punkte und Warnungen.

tulimoa__briefing(date?)

Das Morgenbriefing: Was konsolidiert, gefestigt und vergessen wurde und welche Probleme noch offen sind. date als YYYY-MM-DD, ohne Angabe das neueste. Ein guter erster Call nach dem Wiederverbinden.

tulimoa__timeline(from?, to?, session?, query?, limit?)

Die wörtliche Geschichte in Reihenfolge: rohe Erlebnisse nach Zeitraum, Session oder Stichwort. limit 1 bis 100, Standard 30. Zeiträume älter als 14 Tage kommen aus dem Archiv, bis zu 62 Tage pro Anfrage.

Konto

tulimoa__link_account(email?, webhook_url?)write

Liefert einen Code wie ABCD-2345, den ein Mensch innerhalb von 30 Minuten im Tulimoa-Dashboard einträgt. Ab dann sieht er dort Guthaben, Schlüssel, Wissen und Briefings und wird rechtzeitig gewarnt. email und webhook_url (https) bekommen die Warnungen direkt. Kostenlos, kein Call-Preis.

HTTP-Endpoints

Neben MCP gibt es ein paar einfache HTTP-Endpoints auf https://memory.tulimoa.com. Schreibende Endpoints nutzen denselben Bearer-Key.

EndpointWas er tutKosten
POST /ingestBatch-Write von bis zu 100 Erlebnissen. Arten: note, ingest, tool_call, tool_result, remember. durable ist hier standardmäßig false.Ein Call-Preis pro angefangene 10 Erlebnisse
POST /importImportiert ein Dokument als {title?, text, session_id?}, zerlegt in Stücke von etwa 900 Zeichen, höchstens 400 Stück; der Rest fällt weg. Dauerhaft gespeichert und in der nächsten Nacht konsolidiert.Ein Call-Preis pro angefangene 10 Stück
/briefingDie letzten 14 Briefings als Webseite. Der Key kommt in ein Formular (POST), nie in die URL.Kostenlos
POST /register, POST /topupKonto anlegen oder Guthaben aufladen per x402, siehe Verbinden.Der gezahlte Betrag, voll gutgeschrieben
GET /.well-known/x402, GET /llms.txtMaschinenlesbare Bedingungen und eine kurze Anleitung für Agents.Kostenlos
Tool-Ergebnisse und Notizen in einem Batch schicken
curl -X POST https://memory.tulimoa.com/ingest \
  -H "Authorization: Bearer tlm_mem_..." \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "deploy-2026-09-12",
    "episodes": [
      { "kind": "tool_result", "text": "Deploy to staging succeeded", "payload": { "tool": "deploy" } },
      { "kind": "note", "text": "The customer prefers weekly summaries", "durable": true }
    ]
  }'

Die Antwort meldet stored, dropped und quarantined plus die neuen IDs. Alles, was hier ankommt, ist sofort auffindbar und wird in der nächsten Nacht konsolidiert, siehe Schlaf, Wissen und Morgenbriefing.