Skip to main content
Glama

Synapse Layer — Trust Infrastructure for AI Agents

save_memory

Idempotent

Save a memory entry to the persistent store. Alias of save_to_synapse.

Input Schema

NameRequiredDescriptionDefault
tagsNoTags for categorization.
contentYesThe memory content to store securely.
subjectNoESCOPO1 (optional): opaque 8-128 char token ([A-Za-z0-9._:-]) that isolates memory to a single person within a shared connect-token. Omit for token-scoped behavior. Never include PII/email.
agent_idNoAgent identifier for memory isolation.
project_idNoProject ID for authorization and memory isolation. Required for Corporate context unless the token is project-bound.
visibilityNoprivate (default) or project (visible to active members of this project).
force_intentNoMANUAL OVERRIDE ONLY — use apenas quando você (humano) quer forçar explicitamente a classificação de intenção. Valores reconhecidos: preference | fact | procedural | bio | critical | operational | strategic | compliance | security | system_directive | clinical | general | ephemeral. Se não tiver certeza, NÃO preencha este campo — o sistema classifica automaticamente. Valores não reconhecidos são ignorados silenciosamente e retornados em warnings.
intent_reasonNoAuditable reason for forcing intent classification. Max 500 characters. Ignored if force_intent is absent.

Output Schema

NameRequiredDescriptionDefault
quotaNo
intentNo
statusYes
pipelineNo
memory_idYes
sanitizedNo
trust_quotientNo
privacy_appliedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • removedOutput schema / properties / id
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / intent
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / memory_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / pipeline
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / privacy_applied
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / quota
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / sanitized
      Added value: +{
      +  "type": "boolean"
      +}
    • removedOutput schema / properties / scope
      Removed value: -{
      -  "enum": [
      -    "agent",
      -    "tenant"
      -  ],
      -  "type": "string"
      -}
    • addedOutput schema / properties / status
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / stored
      Removed value: -{
      -  "type": "boolean"
      -}
    • addedOutput schema / properties / trust_quotient
      Added value: +{
      +  "type": "number"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "stored",
      -  "scope"
      -]New value: +[
      +  "memory_id",
      +  "status"
      +]
  2. Changed2 schema fields changed
    • addedInput schema / properties / project_id
      Added value: +{
      +  "description": "Project ID for authorization and memory isolation. Required for Corporate context unless the token is project-bound.",
      +  "type": "string"
      +}
    • addedInput schema / properties / visibility
      Added value: +{
      +  "description": "private (default) or project (visible to active members of this project).",
      +  "enum": [
      +    "private",
      +    "project"
      +  ],
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / subject
      Added value: +{
      +  "description": "ESCOPO1 (optional): opaque 8-128 char token ([A-Za-z0-9._:-]) that isolates memory to a single person within a shared connect-token. Omit for token-scoped behavior. Never include PII/email.",
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • changedInput schema / properties / force_intent / description
      Previous value: -"Override automatic intent classification. When set, the system skips auto-classification and uses this value directly. Accepted values: preference, fact, procedural, bio, critical, operational, strategic, compliance, security, system_directive, clinical, general, ephemeral."New value: +"MANUAL OVERRIDE ONLY — use apenas quando você (humano) quer forçar explicitamente a classificação de intenção. Valores reconhecidos: preference | fact | procedural | bio | critical | operational | strategic | compliance | security | system_directive | clinical | general | ephemeral. Se não tiver certeza, NÃO preencha este campo — o sistema classifica automaticamente. Valores não reconhecidos são ignorados silenciosamente e retornados em warnings."
    • removedInput schema / properties / force_intent / enum
      Removed value: -[
      -  "preference",
      -  "fact",
      -  "procedural",
      -  "bio",
      -  "critical",
      -  "operational",
      -  "strategic",
      -  "compliance",
      -  "security",
      -  "system_directive",
      -  "clinical",
      -  "general",
      -  "ephemeral"
      -]
  5. Changed2 schema fields changed
    • addedInput schema / properties / force_intent
      Added value: +{
      +  "description": "Override automatic intent classification. When set, the system skips auto-classification and uses this value directly. Accepted values: preference, fact, procedural, bio, critical, operational, strategic, compliance, security, system_directive, clinical, general, ephemeral.",
      +  "enum": [
      +    "preference",
      +    "fact",
      +    "procedural",
      +    "bio",
      +    "critical",
      +    "operational",
      +    "strategic",
      +    "compliance",
      +    "security",
      +    "system_directive",
      +    "clinical",
      +    "general",
      +    "ephemeral"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / intent_reason
      Added value: +{
      +  "description": "Auditable reason for forcing intent classification. Max 500 characters. Ignored if force_intent is absent.",
      +  "maxLength": 500,
      +  "type": "string"
      +}
  6. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "id": {
      +      "type": "string"
      +    },
      +    "scope": {
      +      "enum": [
      +        "agent",
      +        "tenant"
      +      ],
      +      "type": "string"
      +    },
      +    "stored": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "stored",
      +    "scope"
      +  ],
      +  "type": "object"
      +}
  7. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": true,
      -  "properties": {
      -    "intent": {
      -      "type": "string"
      -    },
      -    "memory_id": {
      -      "type": "string"
      -    },
      -    "message": {
      -      "type": "string"
      -    },
      -    "pipeline": {
      -      "additionalProperties": true,
      -      "type": "object"
      -    },
      -    "privacy_applied": {
      -      "type": "boolean"
      -    },
      -    "quota": {
      -      "additionalProperties": true,
      -      "type": "object"
      -    },
      -    "sanitized": {
      -      "type": "boolean"
      -    },
      -    "status": {
      -      "description": "'saved' on success; 'error' with a message on rejected input.",
      -      "type": "string"
      -    },
      -    "timestamp": {
      -      "type": "string"
      -    },
      -    "trust_quotient": {
      -      "type": "number"
      -    }
      -  },
      -  "required": [
      -    "status"
      -  ],
      -  "type": "object"
      -}New value: +null
  8. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "intent": {
      +      "type": "string"
      +    },
      +    "memory_id": {
      +      "type": "string"
      +    },
      +    "message": {
      +      "type": "string"
      +    },
      +    "pipeline": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "privacy_applied": {
      +      "type": "boolean"
      +    },
      +    "quota": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "sanitized": {
      +      "type": "boolean"
      +    },
      +    "status": {
      +      "description": "'saved' on success; 'error' with a message on rejected input.",
      +      "type": "string"
      +    },
      +    "timestamp": {
      +      "type": "string"
      +    },
      +    "trust_quotient": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "status"
      +  ],
      +  "type": "object"
      +}
  9. Added
  10. Removed
  11. Added

TDQS

A3.5/5.0
Behavior3/5

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

The annotations already declare that this is a write operation, not read-only, not open-world, and idempotent. The description adds that the store is persistent and that the tool is an alias, but does not add much beyond that about visibility, authorization, or return behavior.

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

Conciseness5/5

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

The description is two short sentences with the core action front-loaded and no wasted text. The alias relationship is stated immediately after the purpose.

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

Completeness3/5

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

An output schema exists and the input schema is fully described, so much of the contextual burden is covered elsewhere. Still, for an eight-parameter write tool with isolation semantics, the description is minimal and does not clarify when to use this alias versus sibling memory-save tools.

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

Parameters3/5

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

Schema description coverage is 100%, so all eight parameters are documented in the schema, including subject isolation, project_id, visibility, and force_intent. The description does not add parameter-level meaning beyond the schema, so the baseline of 3 is appropriate.

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

Purpose4/5

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

The description uses a specific verb and resource: "Save a memory entry to the persistent store." It also identifies the tool as an alias of save_to_synapse, which helps relate it to a sibling, though it does not distinguish it from store_memory.

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

Usage Guidelines3/5

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

The alias relationship to save_to_synapse gives implied usage guidance for choosing between equivalent save tools. However, there are no explicit conditions for when to use this versus store_memory or save_to_synapse, and no exclusions or prerequisites are stated.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.