agentmem

Simple memory API for AI agents. Store, retrieve, delete. Pay with USDC or Stripe.

npm install agentmem

Quick Start

const { AgentMem } = require('agentmem');

// Get your API key at https://agentmem.io
const mem = new AgentMem('am_live_xxxxx');

// Store
await mem.put('user:preferences', { theme: 'dark', language: 'en' });

// Retrieve
const prefs = await mem.get('user:preferences');
console.log(prefs); // { theme: 'dark', language: 'en' }

// Delete
await mem.delete('user:preferences');

Try Without Signing Up

const { AgentMem } = require('agentmem');

// 25 free API calls, no signup required
const mem = new AgentMem(AgentMem.DEMO_KEY);

await mem.put('test', { hello: 'world' });
const data = await mem.get('test');

API

new AgentMem(apiKey, options?)

Create a client.

• apiKey - Your API key from agentmem.io
• options.baseUrl - Override API URL (default: https://api.agentmem.io)

mem.put(key, value)

Store a value.

await mem.put('user:session', { lastSeen: Date.now() });

mem.get(key)

Retrieve a value.

const session = await mem.get('user:session');

mem.delete(key)

Delete a value.

await mem.delete('user:session');

mem.bootstrap()

Get all context on startup. Call this when your agent wakes up.

const context = await mem.bootstrap();
console.log(context.memories); // Array of { key, size, updated }

mem.keys(options?)

List all keys.

const { keys } = await mem.keys({ prefix: 'user:', limit: 100 });

mem.export()

Export all memories as JSON.

const backup = await mem.export();
fs.writeFileSync('backup.json', JSON.stringify(backup));

mem.bulkDelete(prefix)

Delete multiple keys by prefix.

await mem.bulkDelete('temp:'); // Delete all temp:* keys
await mem.bulkDelete('*');     // Delete everything

mem.status()

Check account status.

const status = await mem.status();
console.log(status.storage.used_pct); // Storage usage percentage

Error Handling

try {
  await mem.get('nonexistent');
} catch (err) {
  console.log(err.status);  // 404
  console.log(err.code);    // 'not_found'
  console.log(err.hint);    // 'Use PUT /v1/memory/:key to create...'
  console.log(err.docs);    // 'https://agentmem.io/#how-it-works'
}

Pricing

• Free tier: 10,000 keys, 1,000 API calls/month
• Pro: $5/month, 1M keys, 100K calls
• Pay-per-use: $0.0002/write, $0.0001/read (USDC on Base)

Get your API key at agentmem.io.

Links

• Documentation
• API Reference
• x402 Protocol (for crypto payments)

License

MIT