Agent memory, list keys: what a namespace holds

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

List up to 100 keys saved in your namespace, optionally only those starting with a prefix, with their size, save time and expiry; pass the returned cursor for the next page. Values are not included (read them with /memory/get). 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 see what an agent has saved.

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…

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.
prefixstringOnly keys that start with this text
cursorstringThe cursor from the previous page of this list

Request

Over HTTP, with a card key from /credits:

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

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/memory/list?namespace=demo-agent-memory-7f3c9a21&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

{
  "keys": [
    {
      "key": "user-preferences",
      "updatedAt": "2026-10-25T15:00:00.000Z",
      "expiresAt": "2026-11-24T15:00:00.000Z",
      "size": 34
    }
  ],
  "count": 1,
  "cursor": null
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is memory_list, and the first 25 successful calls are free:

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

Related tools