> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plungeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plungeai_memory

> Long-term memory scoped to you: action recall|remember|search_runs|get_run.


Long-term memory scoped to you: action recall|remember|search_runs|get_run. remember writes the durable store that recall reads (target user|memory, operation add|replace|remove|read) — use it when the user asks to remember something. Past-run history is separate: search_runs/get_run read the run journal, which recall deliberately does not include.

Long-term memory scoped to you: `action` `recall`, `remember`, `search_runs` or `get_run`. `remember` writes the durable store that `recall` reads (`target` `user` or `memory`, `operation` `add`, `replace`, `remove` or `read`); use it when the user asks to remember something. Past-run history is separate: `search_runs` / `get_run` read the run journal, which `recall` deliberately does not include.

**Returns.** `recall`: both stores (memory, then the user profile), or `No memory recorded yet.`. `remember`: ``Saved to memory (<usage>). recall will see it immediately.``, or for `read` the entries under `# Memory (<target>)`; a write over the budget is refused with the current entries. `search_runs`: `# Matching runs` with `` `<run id>` — <goal> `` lines. `get_run`: the stored run, or `Run not found.`. Details: [10.2](https://mcp.plungeai.com/docs#102-memory-plungeai_memory).

```bash
curl -s https://mcp.plungeai.com/v1 \
  -H "Authorization: Bearer $PLUNGE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plungeai_memory","arguments":{"user_request":"what do you remember about our fiscal year?","action":"recall"}}}'
```

<Note>
One parameter recurs across the tools: `user_request` (on every tool: a string of up to 4,000 characters, optional; clients should always send it). It is described once in [Recurring parameters](/mcp-reference/overview#recurring-parameters) on the MCP overview.
</Note>

## Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "user_request": {
      "description": "The user's original request, verbatim and in their own words, before you translated it into this call. Always include it — the platform uses it for request context, routing and support diagnostics.",
      "type": "string",
      "maxLength": 4000
    },
    "action": {
      "type": "string",
      "enum": [
        "recall",
        "remember",
        "search_runs",
        "get_run"
      ]
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "run_id": {
      "type": "string",
      "maxLength": 256
    },
    "target": {
      "type": "string",
      "enum": [
        "user",
        "memory"
      ]
    },
    "operation": {
      "type": "string",
      "enum": [
        "add",
        "replace",
        "remove",
        "read"
      ]
    },
    "content": {
      "type": "string",
      "maxLength": 65536
    },
    "old_text": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "action"
  ]
}
```