memory

Store a memory permanently. Namespaced to YOUR paying wallet — your wallet is your private memory store. Semantic-indexed for later search. Optional supersedes=[ids] marks prior memories in your namespace as superseded by this one (excluded from search, still visible in export with their superseded_by id) — a Zep-style update-in-place without ever losing history. Paid: $0.001 per write via x402 (payment in _meta['x402/payment']).

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The memory text (max 8000 chars)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "supersedes": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "ids of prior memories (same namespace) that this write supersedes"
    }
  },
  "required": [
    "content"
  ]
}

Semantic search over YOUR stored memories (payer-wallet namespace). Returns top-k by embedding similarity. Paid: $0.002 per search via x402.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "k": {
      "type": "integer",
      "description": "max results (default 5, cap 20)"
    }
  },
  "required": [
    "query"
  ]
}

Export memories in YOUR payer-wallet namespace (up to 1000/call, newest first; use offset to page through namespaces >1000). Your data is yours. Includes superseded_by so history is exportable. Paid: $0.01 via x402.

{
  "type": "object",
  "properties": {
    "offset": {
      "type": "integer",
      "description": "row offset for paging past the first 1000 (default 0)"
    }
  }
}

Bulk-write memories into YOUR namespace (max 200/call, content <=8k chars each). Accepts the exact shape memory_export emits, so a whole namespace can move in with one paid call. Embeds best-effort; missing embeddings are backfilled hourly. Paid: $0.01 flat via x402.

{
  "type": "object",
  "properties": {
    "memories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ts": {
            "type": "number"
          }
        },
        "required": [
          "content"
        ]
      },
      "description": "up to 200 items"
    }
  },
  "required": [
    "memories"
  ]
}

Delete memories by id from YOUR namespace (or a namespace you hold a write/rw grant for). Max 100 ids per call. Paid: $0.001 per call via x402.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "memory ids to delete (max 100)"
    }
  },
  "required": [
    "ids"
  ]
}

FREE (no payment): store a memory in YOUR namespace, proven by an EIP-191 personal_sign instead of an x402 payment. wallet_auth = base64 JSON {address,ts,signature} where signature = personal_sign of 'borismem-free:<address>:<ts>' (ts within 600s). Writes to the SAME namespace paid calls use. Capped at 1000 writes / rolling 30 days per wallet; over cap returns an error pointing to the paid tier.

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The memory text (max 8000 chars)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "wallet_auth": {
      "type": "string",
      "description": "base64 JSON {address,ts,signature} -- see description"
    }
  },
  "required": [
    "content",
    "wallet_auth"
  ]
}

FREE (no payment): semantic search over YOUR namespace, proven by an EIP-191 personal_sign. Same wallet_auth scheme as memory_write_free. Capped at 500 searches / rolling 30 days per wallet.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "k": {
      "type": "integer",
      "description": "max results (default 5, cap 20)"
    },
    "wallet_auth": {
      "type": "string",
      "description": "base64 JSON {address,ts,signature}"
    }
  },
  "required": [
    "query",
    "wallet_auth"
  ]
}

FREE: count + last-write timestamp for any wallet namespace. Content is never returned on the free tier.

{
  "type": "object",
  "properties": {
    "namespace": {
      "type": "string",
      "description": "wallet address"
    }
  },
  "required": [
    "namespace"
  ]
}