# Toolkit Memory Add

> Toolkit Memory Add is a paid API for AI agents from staging.toolkit.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Stores a new memory about the user — their preferences, personal details, or anything they've asked to be remembered — for future retrieval in conversations.

## Facts

- Endpoint: POST https://staging.toolkit.dev/api/tool/memory/add-memory
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/staging-toolkit-dev-fa4bb1b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HKI5hVvYnyTeNDX1LcDr0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability staging-toolkit-dev-fa4bb1b1 -d '<json body>'
```

Example prompt: Remember that my name is Sarah, I prefer concise bullet-point responses, and I'm based in Austin, Texas — I want you to keep this in mind for all future conversations.

## When to prefer this

Use this endpoint whenever a user explicitly asks you to remember something, or whenever they share personal information, preferences, or context that could be useful in future interactions. Prefer this over any local in-context note-taking when persistence across sessions is needed.

## Known failure modes

- Empty or missing memory content returns a 400 error
- Payment of $0.01 USDC not provided or rejected causes a 402 response
- Memory content too long or malformed triggers a validation error
- Server unavailable on staging environment returns 5xx

## How this service works

Add a new memory. This method is called every time the user informs anything about themselves, their preferences, or anything that has any relevant information which can be useful in the future conversation. This can also be called when the user asks you to remember something.

## Output

A confirmation that the memory has been stored, along with an identifier or acknowledgment of the saved memory record that can later be retrieved via the search-memory endpoint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "content"
 ],
 "properties": {
  "content": {
   "type": "string",
   "description": "The content to store in memory"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "content"
 ],
 "properties": {
  "content": {
   "type": "string",
   "required": true
  },
  "success": {
   "type": "boolean",
   "required": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/staging-toolkit-dev-fa4bb1b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from staging.toolkit.dev](https://www.zero.xyz/host/staging.toolkit.dev/llms.txt)