Persistent Agent Memory

Memory storage and retrieval powered by Coral Bricks. Store facts, preferences, and context; retrieve them later by meaning. All memories are stored in the default collection.

Use when: (1) remembering facts or preferences for later, (2) recalling stored memories by topic or intent, (3) forgetting/removing memories matching a query.

NOT for: web search, file system search, or code search — use other tools for those.

Setup

Set your API key (get one at https://coralbricks.ai):

CODEBLOCK0

Requests are sent to the Coral Bricks Memory API at https://search-api.coralbricks.ai.

Tools

coral_store — Store a memory

Store text with optional metadata for later retrieval by meaning.

CODEBLOCK1

• - text (required): Content to remember
• INLINECODE2 (optional): JSON string of metadata, e.g. INLINECODE3

Output: JSON with status (e.g. {"status": "success"}).

Example:

CODEBLOCK2

coral_retrieve — Retrieve memories by meaning

Retrieve stored memories by semantic similarity. Returns matching content ranked by relevance.

CODEBLOCK3

• - query (required): Natural language query describing what to recall
• INLINECODE7 (optional, default 10): Number of results to return

Output: JSON with results array, each containing text and score.

Example:

CODEBLOCK4

coraldeletematching — Forget memories by query

Remove memories that match a semantic query. Specify what to forget by meaning.

CODEBLOCK5

• - query (required): Natural language query describing memories to remove

Output: JSON confirming the operation completed.

Example:

CODEBLOCK6

Privacy

Privacy Policy

Notes

• - All memories are stored in the default collection; collections are not exposed to the agent
• All text is embedded into 1024-dimensional vectors for semantic matching
• Results are ranked by cosine similarity (higher score = more relevant)
• Stored memories persist across sessions
• The metadata field is free-form JSON; use it to tag memories for easier filtering
• For more details and examples, see Persistent Agent Memory for AI Agents

Indexing delay (store then retrieve)

In rare cases, memories can take up to 1 second to become retrievable right after storage.