MCP Tool: memory

Basic Information

Tool Name:	memory
Asset Name:	Memory
Description:	The user's memory — a numbered list of durable facts to keep in view. Pick the action with `command`: 'recall' renders the numbered list (you rarely need this — it is injected into your context automatically); 'remember' appends a new item; 'update' replaces item n; 'forget' removes item n. Edit by the item numbers shown in the list. Stored durably and scoped to the user.
Adapter:	memory
Asset Hash:	`0x8ab82409b1a8d6a8bcfa708e8160193c4f90fc820578b8c82671a587af4184c5`

Input

Property	Type	Description
`displayField`	string	recall only: when the path holds a map of records, the entry field to show as each line (default 'text').
`path`	string	Memory list path (default 'w/memory').
`command`*	string	Action to perform.
`noteField`	string	recall only: optional entry field appended after the line as a note.
`text`	string	Item text — for 'remember' (the new item) and 'update' (the replacement).
`n`	integer	1-based item number — for 'update' and 'forget', as shown in the numbered list.

Output

Type: object

Schema: <code>{ "description": "recall → a numbered text block, or null when empty. remember/update/forget → a small status map (e.g. {remembered|updated|forgotten: true, n, count})." }</code>

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://api.getmine.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "memory",
    "arguments": {
      "input": "your input here"
    }
  }
}

cURL Example:

curl -X POST https://api.getmine.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "memory",
      "arguments": {
        "input": "your input here"
      }
    }
  }'

Python Example:

import requests
import json

url = "https://api.getmine.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "memory",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)

JavaScript/Node.js Example:

const fetch = require('node-fetch');

const url = 'https://api.getmine.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'memory',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
	"name": "Memory",
	"description": "The user's memory — a numbered list of durable facts to keep in view. Pick the action with `command`: 'recall' renders the numbered list (you rarely need this — it is injected into your context automatically); 'remember' appends a new item; 'update' replaces item n; 'forget' removes item n. Edit by the item numbers shown in the list. Stored durably and scoped to the user.",
	"dateCreated": "2026-06-15T00:00:00Z",
	"operation": {
		"adapter": "memory:manage",
		"toolName": "memory",
		"input": {
			"type": "object",
			"properties": {
				"command": { "type": "string", "enum": ["recall", "remember", "update", "forget"], "description": "Action to perform." },
				"text": { "type": "string", "description": "Item text — for 'remember' (the new item) and 'update' (the replacement)." },
				"n": { "type": "integer", "description": "1-based item number — for 'update' and 'forget', as shown in the numbered list." },
				"path": { "type": "string", "description": "Memory list path (default 'w/memory')." },
				"displayField": { "type": "string", "description": "recall only: when the path holds a map of records, the entry field to show as each line (default 'text')." },
				"noteField": { "type": "string", "description": "recall only: optional entry field appended after the line as a note." }
			},
			"required": ["command"]
		},
		"output": {
			"description": "recall → a numbered text block, or null when empty. remember/update/forget → a small status map (e.g. {remembered|updated|forgotten: true, n, count})."
		}
	}
}

Tool Details: memory