{"uid":"cap_HKI5hVvYnyTeNDX1LcDr0","slug":"staging-toolkit-dev-fa4bb1b1","name":"Toolkit Memory Add","description":"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.","url":"https://staging.toolkit.dev/api/tool/memory/add-memory","method":"POST","headers":{},"bodySchema":{"type":"object","required":["content"],"properties":{"content":{"type":"string","description":"The content to store in memory"}}},"responseSchema":{"type":"object","required":["success","content"],"properties":{"content":{"type":"string","required":true},"success":{"type":"boolean","required":true}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xF3dHb2FJO9NZuxpAv-rM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a new memory about the user — their preferences, personal details, or anything they've asked to be remembered — for future retrieval in conversations.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:32:37.304Z","isFirstParty":false}