Agent memory, save: key value store for agents
Save a value (up to 8,000 characters of text or JSON) under a key in your own namespace, so an agent can remember facts, preferences or task state between runs. Overwrites an existing key; expires after 1 to 30 days (default 30). Values are kept until they expire (at most 30 days) or are deleted; reads anywhere may lag a write made elsewhere by up to a minute. Use to persist what an agent learned for a later call to memory_get.
Inputs
| Name | Type | Description |
|---|---|---|
namespace (required) | string | Your namespace: a secret of 16 to 128 letters, digits, - or _ that you choose and reuse. Anyone who knows it can read and write it, so treat it like a password; send it in a POST body to keep it out of URLs. |
key (required) | string | The key, up to 200 characters |
value (required) | string | The text or JSON to save, up to 8,000 characters |
days | string | Days to keep it, 1 to 30 (default 30) |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/memory/set?namespace=demo-agent-memory-7f3c9a21&key=user-preferences&value=%7B%22language%22%3A%22en%22%2C%22units%22%3A%22metric%22%7D"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/memory/set?namespace=demo-agent-memory-7f3c9a21&key=user-preferences&value=%7B%22language%22%3A%22en%22%2C%22units%22%3A%22metric%22%7D&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.
Example result
{
"key": "user-preferences",
"saved": true,
"updatedAt": "2026-10-25T15:00:00.000Z",
"expiresAt": "2026-11-24T15:00:00.000Z",
"size": 34
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is memory_set, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp