Skip to main content
Glama

Load memory

load_memory
Read-onlyIdempotent

Loads a user's identity, preferences, facts, and recent session history from persistent storage at the start of a session so assistants can apply stored context before responding.

Instructions

Loads the user's identity, preferences, facts, and recent session history from persistent cross-session storage. Default output is compact for strict MCP clients; call search_memory for narrow questions or pass full_content=true only when the full raw payload is required. Use IMMEDIATELY at the start of every session -- before responding to the user's first message, before calling any other tool. Trigger even when the opening message looks trivial: keywords like 'remember', 'recall', 'context', 'profile', 'facts about me', 'who am I', 'last time', 'preferences', 'pick up where we left off' all signal stored context exists. Also trigger after any context reset or tool reconnect, or any time you are unsure whether context was loaded this session. Do NOT skip because the first message is simple -- personal facts change how almost every answer should be framed. Do NOT trigger for pure factual lookups (capitals, math, definitions) that require no personal context.

Input Schema

NameRequiredDescriptionDefault
liteNoWhen true, skips session summary bodies and returns compact identity, facts, and counts (default true)
full_contentNoWhen true, returns the full raw memory payload. Use sparingly; strict clients may reject large tool results.
num_sessionsNoNumber of recent session summaries to load when lite=false (1-20, default 3)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.5

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already confirm this is a safe, idempotent read, and the description adds meaningful behavior beyond that: default output is compact for strict MCP clients, full_content may be rejected by strict clients, and lite skips session summary bodies. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the core action and alternative before the extensive trigger list. The long keyword enumeration and repeated 'do not skip' warnings are useful for a critical session-start tool but make it wordier than strictly necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, but the description explains what is returned (identity, preferences, facts, session history) and how compact vs full output differs. For a zero-required-parameter read tool with rich annotations, this is complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3; the description adds useful context by explaining that full_content should be used sparingly and that the default output is compact. It does not add syntax beyond the schema, but it reinforces the practical meaning of the key flags.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (loads) and concrete resources (identity, preferences, facts, recent session history) from persistent cross-session storage. Explicitly distinguishes itself from search_memory for narrow queries and clarifies the default compact output.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides unusually explicit when-to-use guidance: immediately at session start, after context resets, when uncertain, and even when the opening message looks trivial. Also states when not to use it (pure factual lookups) and names the alternative search_memory for narrow questions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools