Agent memory, recall: read a saved value

$0.002 per call · failed calls are never charged · no account or API key needed

Read the value saved under a key in your namespace with /memory/set, with when it was saved and when it expires. A key that was never saved or has expired is a 404 and is not charged. 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 recall what an agent saved in an earlier run.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Try it with your own inputs

Your namespace: a secret of 16 to 128 letters, digits, - or _ that you choose and reuse. Anyone who knows it can…
The key, up to 200 characters

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
namespace (required)stringYour 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)stringThe key, up to 200 characters

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/memory/get?namespace=demo-agent-memory-7f3c9a21&key=user-preferences"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/memory/get?namespace=demo-agent-memory-7f3c9a21&key=user-preferences&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",
  "value": "{\"language\":\"en\",\"units\":\"metric\"}",
  "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_get, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools