memories

Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see Get started.

This Melso user’s long-term memories; always the authenticated person, with no container or user argument. search when you know what to look for, list when you do not, save a fact they asked you to remember (static=true for durable traits such as name), forget a fact they asked you to drop by its exact text. Each action accepts only its own fields (* required): search(query*); list(page); save(content*, static); forget(content*). Availability: Autónomo / Empresa / Agents invitation / OAuth-only. Catalog: Core (tools/list). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

Input

Agents / Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "search",
        "list",
        "save",
        "forget"
      ],
      "type": "string"
    },
    "content": {
      "description": "save: the fact, such as Prefers short replies. forget: the exact memory text from list or search.",
      "type": "string"
    },
    "page": {
      "description": "Page of recent memories. Defaults to 1.",
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "What to look up, such as espresso or preferred language.",
      "type": "string"
    },
    "static": {
      "description": "True for durable traits such as name or hometown.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Actions

The family schema combines fields for discovery. Each action accepts only its own fields below; add action when calling the family.

forget

Forget a fact this person asked you to drop. Pass the exact memory text from memories_list or memories_search. There is no container or user argument.OAuth-only.

{
  "additionalProperties": false,
  "properties": {
    "content": {
      "description": "Exact memory text to forget.",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}

list

List this Melso user’s recent long-term memories when you do not know what to search for. Always the authenticated person. There is no container or user argument.OAuth-only.

{
  "additionalProperties": false,
  "properties": {
    "page": {
      "description": "Page of recent memories. Defaults to 1.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "type": "object"
}

save

Save a fact this person asked you to remember. Permanent traits such as name can set static=true. There is no container or user argument.OAuth-only.

{
  "additionalProperties": false,
  "properties": {
    "content": {
      "description": "The fact to remember, such as Prefers short replies.",
      "type": "string"
    },
    "static": {
      "description": "True for durable traits such as name or hometown.",
      "type": "boolean"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}

Search this Melso user’s long-term memories when you know what to look for. Always the authenticated person. There is no container or user argument.OAuth-only.

{
  "additionalProperties": false,
  "properties": {
    "query": {
      "description": "What to look up, such as espresso or preferred language.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Output

Matching memories, the saved memory, or the result of forgetting a memory. Memories belong to the authenticated person. The result uses MCP content blocks; JSON payloads are encoded in text and may also appear in structuredContent. Check isError before reading a success payload. The server does not currently declare an outputSchema, so treat additional fields as extensible. Result handling.

Example

Use an OAuth access token issued for this MCP resource (a Run token for Run-only tools). Replace example identifiers with values from your own account. Write actions change data.

curl --fail-with-body https://melso.ai/api/mcp \
  -H "Authorization: Bearer $MELSO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-binary @- <<'JSON'
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "memories",
    "arguments": {
      "action": "list"
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

Input

Agents / Autónomo / Company schema

Actions

Output

Example

​Input

​Agents / Autónomo / Company schema

​Actions

​Output

​Example

Input

Agents / Autónomo / Company schema

Actions

Output

Example