MCP-Tool-Referenz

Der Server stellt die folgenden Tools bereit. Welche Tools ein Client tatsächlich anzeigt, hängt zusätzlich von der Serverkonfiguration, der Authentifizierungsart und gegebenenfalls einer Staff-Freischaltung ab.

Öffentliche Tool-Liste und Tokenbudget

tools/list liefert neun Kern-Tools: palim_resume, palim_save_context, palim_save_session, palim_search, palim_get_context, palim_add_memory, palim_get_brain, palim_delete_session und palim_help.

Die gemessene Antwort umfasst 2.516 cl100k-Token beziehungsweise 11.666 UTF-8-Byte (Stand OLE-120). Die 45-Tool-Baseline lag bei 10.207 Token / 48.004 Byte. Account- und Wartungswerkzeuge bleiben für bestehende Clients und Hooks direkt über tools/call erreichbar, werden aber nicht mehr bei jeder Verbindung in den Modellkontext geladen.

Checkpoints und Sessions

• palim_resume — Liefert den zuletzt bearbeiteten Thread als fertige Übergabe. Benötigt keine Argumente; optionale Filter sind tool_source, project, within_hours und include_messages.
• palim_save_context — Standardmäßiger proaktiver Checkpoint: aktualisiert eine kompakte Summary ohne Nachrichtenverlauf.
• palim_save_session — Speichert oder erweitert einen vollständigen Chat mit Messages, Summary und Metadaten.
• palim_list_sessions — Listet Sessions mit Filtern für Quelle, Tags, Status und Zeitraum.
• palim_browse_sessions — Liefert eine maschinenlesbare Session-Liste für UI- und Browser-Clients.
• palim_get_session — Lädt eine vollständige Session.
• palim_get_sessions — Lädt bis zu 15 Sessions in einem Aufruf.
• palim_show_session — Rendert eine Session in einer lesbaren Nachrichtenansicht.
• palim_get_summary — Lädt nur die Summary einer Session.
• palim_list_summaries — Listet Session-Summaries ohne vollständige Messages.
• palim_create_summary — Ergänzt eine Summary für eine Session, die noch keine besitzt.
• palim_update_session_metadata — Ändert Titel, Tags, Projekt, Status oder Erstellungsdatum.
• palim_update_session_references — Ergänzt oder ersetzt Quellen-URLs.
• palim_export_session — Exportiert eine Session als Markdown, JSON oder Text.
• palim_delete_session — Setzt standardmäßig Status deleted; hard_delete: true löscht dauerhaft.
• palim_find_similar — Findet ähnliche Sessions per Keyword- und Inhaltsabgleich.
• palim_get_stats — Liefert Bestands- und Aktivitätsstatistiken.

Suche und Abruf

• palim_search — Volltext- und Textsuche mit optionalen Metadatenfiltern.
• palim_search_by_date_range — Filtert Sessions nach Datum sowie optional Tags, Projekt und Tool-Quelle. Durchsucht dabei nicht zusätzlich den Nachrichteninhalt.
• palim_get_context — Sucht relevante Sessions und formatiert daraus einen kompakten Kontextblock.

Die Suche ist derzeit nicht embedding- oder vektorbasiert. Bei verschlüsselten Inhalten verwendet Palim entschlüsselten Textabgleich im Serverprozess. Exakte Titelphrasen können in der Volltextsuche schlechter funktionieren als mehrere charakteristische Begriffe, Tags oder ein Projektfilter.

Memories

• palim_add_memory — Speichert einen einzelnen Fakt, eine Entscheidung, Präferenz, Erkenntnis oder Notiz.
• palim_search_memories — Sucht Memories nach Text, Typ und Tags.
• palim_update_memory — Ändert Inhalt, Typ, Tags oder Metadaten einer Memory.
• palim_delete_memory — Löscht eine Memory dauerhaft.

Brain

• palim_get_brain — Lädt ohne Argument den Topic-Index oder mit topic ein vollständiges Topic.
• palim_export_brain — Exportiert alle Topics als Obsidian-kompatibles Markdown-Vault.
• palim_update_brain_topic — Erstellt, bearbeitet, benennt um oder löscht ein Topic.
• palim_backfill_brain — Liest bis zu 1.000 bestehende Sessions mit Summary nachträglich in das Brain ein.

Nutzerkontext, Regeln und Profil

• palim_set_user_context — Setzt einen nutzereigenen Kontextblock, wenn User Modeling in der Umgebung aktiviert ist.
• palim_get_user_context — Liest diesen Kontextblock.
• palim_add_user_rule — Erstellt eine dauerhafte Arbeits- oder Verhaltensregel.
• palim_list_user_rules — Listet die eigenen Regeln.
• palim_update_user_rule — Ändert Inhalt, Aktivierung, Tags oder Reihenfolge einer Regel.
• palim_delete_user_rule — Löscht eine Regel.
• palim_get_user_profile — Liest das abgeleitete User Profile. In Produktion derzeit nur für freigeschaltete Staff-Accounts.
• palim_update_user_profile — Ändert Consent, Refinement und Profilfelder. In Produktion derzeit nur für freigeschaltete Staff-Accounts.

Account, Verbindung und Wartung

• palim_register — Registriert einen Account und gibt einen neuen API-Key aus. Für normale Hosted-Nutzung ist die Setup-Seite vorgesehen.
• palim_login — Meldet einen bestehenden Account an und erzeugt einen neuen API-Key.
• palim_logout — Löscht standardmäßig alle API-Keys und versucht OAuth-Sessions zu widerrufen.
• palim_create_connection_url — Erzeugt im HTTP-Modus eine URL mit Connection Token. Maximal fünf aktive Tokens pro Account.
• palim_help — Zeigt eine kategorisierte Übersicht der Palim-Tools.
• palim_migrate_encryption — Migriert ältere Klartext-Inhalte. Standardmäßig nur Vorschau mit dry_run: true; kein normaler Endnutzer-Workflow.

Beta und Limits

Palim befindet sich derzeit in der Beta und bietet eine kostenlose Version; bezahlte Pläne sind noch nicht aktiv. Eine kostenlose Version bleibt auch nach Einführung bezahlter Pläne verfügbar. Es gibt aktuell keine veröffentlichte Speicherquote pro Plan. Einzelne Tools haben jedoch technische Aufruflimits, unter anderem:

• palim_get_sessions: höchstens 15 Session-IDs pro Aufruf
• palim_list_sessions: höchstens 100 Ergebnisse
• palim_list_summaries: höchstens 200 Ergebnisse
• palim_backfill_brain: höchstens 1.000 gescannte Sessions
• Connection URLs: höchstens fünf aktive Tokens pro Account

Änderungen an zukünftigen Preisen, Speicherquoten oder Planlimits werden vor Aktivierung bezahlter Pläne veröffentlicht.