{"uid":"cap_y8WiePwbRfyyK4O7XDCuc","slug":"agent-memory-key-value-store-c81e5b6a","name":"Agent Memory Key-Value Store","description":"126 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, checks before installing a package or citing a source, screenshots and PDF, PDF, OCR and document conversion and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/agent-memory?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"by":{"type":"number","description":"incr step, default 1"},"op":{"enum":["set","get","get_many","delete","list","search","append","incr"],"type":"string","description":"Default: set if value is given, get if key is given, else list"},"key":{"type":"string","maxLength":200},"tag":{"type":"string"},"keys":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"For get_many and delete"},"tags":{"type":"array","items":{"type":"string"},"maxItems":10},"after":{"type":"string","description":"list: continue after this key"},"limit":{"type":"integer","maximum":100},"query":{"type":"string","description":"search: words that must all appear in key or value"},"store":{"type":"string","description":"Store secret from an earlier call (mem_...). Omit on your first write to create a store"},"value":{"type":["object","array","string","number","boolean"],"description":"Any JSON value, up to 64 KB (set, append)"},"prefix":{"type":"string"},"ttl_days":{"type":"integer","default":30,"maximum":365,"minimum":1},"max_items":{"type":"integer","description":"append: keep at most this many items, default 100, max 1000"},"if_version":{"type":"integer","description":"set only if the current version matches (0 = key must not exist)"},"with_values":{"type":"boolean","description":"list: include values"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mruj6ZyLPYfS9N2W4wwVR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Persistent JSON key-value store for AI agents: create a store, then set, get, list, search, append, or atomically increment values across runs or between agents.","exampleAgentPrompt":"Remember my research results from this session — store the JSON object under the key 'research/session-42' in my agent memory store mem_abc123, with a TTL of 7 days, and return the new version number so I can do safe updates later.","exampleUseCases":[{"title":"Persist task queue across agent runs","prompt":"Append this new task object to the 'tasks/pending' key in my agent memory store mem_xyz789, keeping at most 50 items in the rolling list so the oldest ones drop off automatically."},{"title":"Share scraped data between agents","prompt":"Store this extracted product data JSON under the key 'products/item-9981' in the shared agent memory store mem_shared01 so the pricing agent can read it in its next run."},{"title":"Atomic counter for rate limiting","prompt":"Increment the counter at key 'usage/api-calls-today' by 1 in my memory store mem_lim456, and tell me the new value so I know if I've hit the daily limit."}],"resultDescription":"Returns a JSON object with a 'success' boolean and a 'data' field containing the operation result — for get/get_many: the stored value(s) and version numbers; for list: paginated key entries (optionally with values); for search: matching keys/values; for set/append/incr: the updated value and version; for the first write: the new store secret (mem_...).","failureModes":["Wrong or missing store secret returns an auth error","if_version mismatch causes a conflict error (safe concurrent update failed)","Key not found returns null or empty data","Value exceeds 64 KB size limit","Too many keys in get_many (>50) or list limit (>100) returns a validation error","TTL out of range (not 1–365 days) returns a validation error","append max_items exceeds 1000 returns a validation error","Payment failure or expired x402 token blocks the call"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to persist state between separate execution runs, share structured data with sibling agents, maintain a rolling log or task queue, or implement atomic counters — all without requiring a dedicated database account. It is ideal for lightweight, schema-free JSON storage with built-in TTL, prefix listing, full-text search across keys and values, and optimistic locking via if_version for safe concurrent writes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:36:57.272Z","isFirstParty":false,"canonicalSlug":"agent-memory-key-value-store-c81e5b6a"}