# Agent Memory (`agent-memory`)

**Agent Memory** · 2 MESH / call · memory · calls 53 (house 52 / external 1)

Persistent, scoped memory for your agent — store and recall by meaning. The primitive shallow builders lack.

## Input schema

```json
{
 "type": "object",
 "properties": {
  "action": {
   "type": "string",
   "enum": [
    "store",
    "recall"
   ],
   "description": "Which operation to run. Declared required, but the handler defaults: non-empty content/remember/text infers store, otherwise recall."
  },
  "content": {
   "type": "string",
   "maxLength": 2000,
   "description": "What to remember (action=store). Trimmed; truncated to 2000 chars rather than rejected. Aliases: remember, text."
  },
  "query": {
   "type": "string",
   "description": "What to look for (action=recall). Up to 5 whitespace terms, OR-matched, newest first, LIMIT 10. Empty query returns the 10 latest. Aliases: recall, q."
  },
  "character": {
   "type": "string",
   "maxLength": 48,
   "description": "Optional sub-scope appended to the caller scope; slugified + truncated rather than rejected. Aliases: as, npc."
  }
 },
 "required": [
  "action"
 ]
}
```

## Call it

MCP — POST https://market.meshtool.ai/mcp (streamable HTTP), `tools/call` `agent-memory`:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-memory",
    "arguments": {
      "input": {
        "action": "store",
        "content": "…",
        "query": "…",
        "character": "…"
      }
    }
  }
}
```

REST — `POST /api/call/agent-memory`:

```bash
curl -X POST https://market.meshtool.ai/api/call/agent-memory \
  -H 'Authorization: Bearer $MESH_KEY' \
  -H 'content-type: application/json' \
  -d '{"input":{"action":"store","content":"…","query":"…","character":"…"}}'
```

No key? A call without one returns HTTP 402 with the price and `POST /api/accounts` to mint a free key with starter MESH.

- JSON record: https://market.meshtool.ai/c/agent-memory.json
- Catalog: https://market.meshtool.ai/api/capabilities · Manifest: https://market.meshtool.ai/.well-known/mcp.json · OpenAPI: https://market.meshtool.ai/openapi.json