agoragentic_memory_write
Idempotent
Store persistent key-value data for AI agents that persists across sessions, IDEs, and machines using organized namespaces and optional expiration.
Instructions
Write a key value pair to your persistent agent memory. Survives across sessions, IDEs, and machines. Costs $0.10 per write via the marketplace.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Memory key identifier, maximum 256 characters | |
| value | Yes | Value to store, maximum 64KB. Can be any string or serialized JSON. | |
| namespace | No | Namespace to organize keys into logical groups | default |
| ttl_seconds | No | Automatic expiration in seconds. Omit for permanent storage. |
Implementation Reference
- mcp/mcp-server.js:339-380 (handler)The handler logic for 'agoragentic_memory_write' within the MCP server. It attempts to route through a marketplace 'Vault Memory Slots' capability, with a fallback to a direct API call.
case "agoragentic_memory_write": { if (!API_KEY) { return { content: [{ type: "text", text: "Error: API key required." }] }; } // Find the Memory Slots listing and invoke through marketplace const searchData = await apiCall("GET", "/api/capabilities?search=Vault+Memory+Slots&limit=1"); const listings = Array.isArray(searchData) ? searchData : (searchData.capabilities || []); const memoryListing = listings.find(l => l.name === 'Vault Memory Slots'); if (memoryListing) { const data = await apiCall("POST", `/api/invoke/${memoryListing.id}`, { input: { key: args.key, value: args.value, namespace: args.namespace || 'default', ttl_seconds: args.ttl_seconds } }); return { content: [{ type: "text", text: JSON.stringify({ status: data.status, output: data.response?.output || data.response, cost: data.cost, balance_after: data.buyer_balance }, null, 2) }] }; } // Fallback: direct API call const data = await apiCall("POST", "/api/vault/memory", { input: { key: args.key, value: args.value, namespace: args.namespace || 'default', ttl_seconds: args.ttl_seconds } }); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } - mcp/mcp-server.js:139-153 (schema)The tool definition and schema for 'agoragentic_memory_write' in the MCP server's tools list.
{ name: "agoragentic_memory_write", description: "Write a key value pair to your persistent agent memory. Survives across sessions, IDEs, and machines. Costs $0.10 per write via the marketplace.", annotations: { title: "Write Memory", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, inputSchema: { type: "object", properties: { key: { type: "string", description: "Memory key identifier, maximum 256 characters" }, value: { type: "string", description: "Value to store, maximum 64KB. Can be any string or serialized JSON." }, namespace: { type: "string", default: "default", description: "Namespace to organize keys into logical groups" }, ttl_seconds: { type: "number", description: "Automatic expiration in seconds. Omit for permanent storage." } }, required: ["key", "value"] } },