MCP tool reference

The server provides the tools below. Which tools a client actually displays also depends on server configuration, authentication method, and, where applicable, staff access.

Checkpoints and sessions

• palim_save_context — Default proactive checkpoint: updates a compact summary without a message transcript.
• palim_save_session — Stores or extends a complete chat with messages, summary, and metadata.
• palim_list_sessions — Lists sessions with filters for source, tags, status, and date range.
• palim_browse_sessions — Returns a machine-readable session list for UI and browser clients.
• palim_get_session — Loads one complete session.
• palim_get_sessions — Loads up to 15 sessions in one call.
• palim_show_session — Renders a session as a readable message view.
• palim_get_summary — Loads only a session summary.
• palim_list_summaries — Lists session summaries without complete messages.
• palim_create_summary — Adds a summary to a session that does not have one yet.
• palim_update_session_metadata — Changes title, tags, project, status, or creation date.
• palim_update_session_references — Adds or replaces source URLs.
• palim_export_session — Exports a session as Markdown, JSON, or text.
• palim_delete_session — Sets status deleted by default; hard_delete: true deletes permanently.
• palim_find_similar — Finds similar sessions using keyword and content matching.
• palim_get_stats — Returns inventory and activity statistics.

Search and retrieval

• palim_search — Full-text and text search with optional metadata filters.
• palim_search_by_date_range — Filters sessions by date and optional tags, project, and tool source. It does not additionally search message content.
• palim_get_context — Finds relevant sessions and formats them into a compact context block.

Search is not currently embedding- or vector-based. For encrypted content, Palim performs decrypted text matching inside the server process. Exact title phrases can work less reliably in full-text search than several characteristic terms, tags, or a project filter.

Memories

• palim_add_memory — Stores one fact, decision, preference, insight, or note.
• palim_search_memories — Searches memories by text, type, and tags.
• palim_update_memory — Changes a memory's content, type, tags, or metadata.
• palim_delete_memory — Permanently deletes a memory.

Brain

• palim_get_brain — Loads the topic index without arguments, or a complete topic with topic.
• palim_export_brain — Exports every topic as an Obsidian-compatible Markdown vault.
• palim_update_brain_topic — Creates, edits, renames, or deletes a topic.
• palim_backfill_brain — Catches up as many as 1,000 existing sessions that have a summary.

User context, rules, and profile

• palim_set_user_context — Sets a user-owned context block when user modeling is enabled in the environment.
• palim_get_user_context — Reads that context block.
• palim_add_user_rule — Creates a durable workflow or behavior rule.
• palim_list_user_rules — Lists the user's rules.
• palim_update_user_rule — Changes a rule's content, activation, tags, or order.
• palim_delete_user_rule — Deletes a rule.
• palim_get_user_profile — Reads the inferred user profile. Currently limited to approved staff accounts in production.
• palim_update_user_profile — Changes consent, refinement, and profile fields. Currently limited to approved staff accounts in production.

Account, connection, and maintenance

• palim_register — Registers an account and returns a new API key. Normal hosted usage should use the setup page.
• palim_login — Signs in to an existing account and creates a new API key.
• palim_logout — Deletes all API keys by default and attempts to revoke OAuth sessions.
• palim_create_connection_url — Creates a URL containing a connection token in HTTP mode. Maximum five active tokens per account.
• palim_help — Shows a categorized overview of Palim tools.
• palim_migrate_encryption — Migrates legacy plaintext content. Defaults to preview with dry_run: true; not a normal end-user workflow.

Beta and limits

Palim is currently a free beta; paid plans are not active yet. There is no published per-plan storage quota today. Individual tools do have technical per-call limits, including:

• palim_get_sessions: at most 15 session IDs per call
• palim_list_sessions: at most 100 results
• palim_list_summaries: at most 200 results
• palim_backfill_brain: at most 1,000 scanned sessions
• connection URLs: at most five active tokens per account

Future pricing, storage quotas, or plan limits will be published before paid plans are activated.