TulimoaTulimoaDocs
Docs-Menü

Memory-Tools und API

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

Stand: 12. Sept. 2026

Alle 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 zu Aufgabenbeginn, remember sobald etwas Dauerhaftes entsteht, checkpoint vor mehrstufiger Arbeit, catch_up nach einem Reconnect und recall noch einmal vor dem Abschluss.

Mit write markierte Tools brauchen einen Key mit write-Scope, ebenso /ingest und /import. Keys aus /register 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). 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?)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. open_questions: [] leert die offenen Punkte der Session. Mindestens ein Feld ist nötig.

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

Entfernt ein Erlebnis über id oder key. 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?)

Liefert, was das Gedächtnis zu query weiß, plus offene Punkte und Warnungen. limit 1 bis 25, Standard 8; ohne query kommen nur die offenen Punkte. Durchsucht den Wissensgraphen nach Bedeutung und Stichwort, zieht verwandtes Wissen dazu, stellt Warnungen vor früherem Ärger nach vorn und greift auf rohe Erlebnisse zurück, solange der Graph wenig weiß.

tulimoa__know(topic)

Ein günstiges Ja oder Nein: Weiß das Gedächtnis etwas über topic? Liefert eine Zuversicht und das nächste Label, keine Inhalte. Es prüft nur konsolidiertes Wissen und sagt darum bis zur ersten Nacht Nein. Sagt es Nein, weiß dein Agent es nicht.

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.

tulimoa__catch_up(since?)

Spielt die Events der Session seit einem Cursor nach, bis zu 200, nach einem Reconnect oder einem gekürzten Kontext. Ohne since beginnt es mit dem Wach-Zustand.

tulimoa__self()

Das Selbstbild des Agents: woran er hauptsächlich arbeitet, wie der Nutzer Dinge haben will, was er gut kann und wo er immer wieder in Schwierigkeiten gerät. Entsteht im Schlaf, sobald das Gedächtnis mindestens 5 Wissenseinträge hat.

tulimoa__gaps()

Wissenslücken: bis zu 8 Themen, die genannt, aber kaum erkundet sind, und bis zu 8 offene Probleme. Hilft zu entscheiden, was als Nächstes herauszufinden ist.

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, um Guthaben und Warnungen zu sehen. 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
GET /briefing?key=Die letzten 14 Briefings als Webseite.Kostenlos
GET /dashboard?key=Wissen, Rezepte, Widersprüche, Kosten und Schlafläufe als Webseite.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. Aus Tool-Ergebnissen mit payload.tool lernt das Gedächtnis Rezepte, siehe Schlaf, Wissen und Morgenbriefing.