# Memonic

> AI agent memory infrastructure. One API for all memory types.

## What is Memonic?

Memonic is a managed memory platform for AI agents. It replaces the need to assemble separate vector databases (Pinecone), relational stores (Supabase/PostgreSQL), caches (Redis/Upstash), and ETL pipelines — providing all five memory types through a single SDK and API.

## Memory Types

| Type | What it stores | Use case |
|------|---------------|----------|
| Session | Conversation turns, active context | In-flight agent state, chat history |
| Episodic | Time-stamped event records | Agent history, what happened when |
| Semantic | Embedding-indexed facts | Similarity recall, concept search |
| Persistent state | Long-lived key-value facts | User preferences, account data |
| Temporal | Time-aware, auto-expiring entries | Reminders, ephemeral context |

## API Primitives

```typescript
import { memonic } from '@memonic/client';

// Store any memory type
await memory.store({ type: 'semantic', content: 'User prefers dark mode', tags: ['preferences'] });

// Recall by similarity or filter
const memories = await memory.recall({ query: 'user preferences', limit: 10 });

// Time-travel: replay agent history
const snapshot = await memory.rewind({ agentId: 'agent-123', timestamp: '2025-01-01T00:00:00Z' });

// Ingest documents / knowledge bases
await memory.ingest({ source: 'https://docs.myapp.com/sitemap.xml', namespace: 'product-docs' });
```

## MCP Integration

Memonic exposes a Model Context Protocol (MCP) server so any MCP-compatible agent runtime (Claude, GPT-4, Gemini) can access memory directly.

```json
{
  "mcpServers": {
    "memonic": {
      "command": "npx",
      "args": ["-y", "@memonic/mcp"],
      "env": { "MEMONIC_API_KEY": "your-key" }
    }
  }
}
```

## Pricing

| Plan | Price | Memory Entries | API Calls |
|------|-------|---------------|-----------|
| Hobby | $0/month | 10,000 | 50,000/month |
| Builder | $29/month | 500,000 | 2M/month |
| Pro | $99/month | 5,000,000 | 20M/month |
| Scale | Custom | Unlimited | Unlimited |

## Compared to Alternatives

| Stack | Cost | Components |
|-------|------|-----------|
| Pinecone + Supabase + Redis + ETL | $2,000–$15,000/month | 4+ services |
| Memonic Pro | $99/month | 1 API |

## Links

- Website: https://memonic-website.finhub.workers.dev
- Dashboard: https://memonic-dashboard.finhub.workers.dev
- API Base URL: https://memonic.finhub.workers.dev
- Docs: https://memonic-website.finhub.workers.dev/docs
- NPM: @memonic/client, @memonic/mcp

## API Endpoints

```
POST /v1/memory/store
POST /v1/memory/recall
POST /v1/memory/rewind
POST /v1/memory/ingest
GET  /health
```

Authentication: `Authorization: Bearer <api-key>` on all requests.