# Magnus

> One data platform. Every model.

## What is Magnus?

Magnus is a multi-model data platform that unifies six data paradigms — relational, document, key-value, vector, time-series, and analytics — in a single SDK. Instead of paying 6 separate vendors and managing 6 integrations, teams run Magnus and access all data models through one client.

## Data Models

| Model | Paradigm | Compatible with |
|-------|----------|----------------|
| Relational | SQL (PostgreSQL dialect) | PostgreSQL clients, Drizzle, Prisma |
| Document | BSON/JSON documents | MongoDB wire protocol |
| Key-Value / Cache | Redis-compatible cache | Redis clients, ioredis |
| Vector | Embedding search | Cloudflare Vectorize API |
| Time-Series | Event streams | Cloudflare Analytics Engine |
| Analytics | OLAP / aggregations | ClickHouse-style queries |

## SDK Example

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

// Relational
const users = await magnus.sql('SELECT * FROM users WHERE org_id = $1', [orgId]);

// Document
const doc = await magnus.documents.findOne({ _id: userId });

// Key-Value
await magnus.kv.set('session:abc', sessionData, { ttl: 3600 });

// Vector
const results = await magnus.vectors.search({ embedding: queryVec, topK: 10 });

// Time-Series
await magnus.timeseries.write('page_views', { path: '/home', count: 1 });

// Analytics
const report = await magnus.analytics.query('SELECT country, COUNT(*) FROM events GROUP BY 1');
```

## MCP Integration

Magnus exposes an MCP server so AI agents can run queries and read schemas directly.

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

## Pricing

| Plan | Price | Queries/month | Storage |
|------|-------|--------------|---------|
| Hobby | $0/month | 100,000 | 1 GB |
| Builder | $29/month | 2,000,000 | 25 GB |
| Pro | $99/month | 20,000,000 | 250 GB |
| Scale | Custom | Unlimited | Unlimited |

## Compared to Alternatives

| Stack | Cost/month | Services |
|-------|-----------|---------|
| PostgreSQL + MongoDB + Redis + Pinecone + InfluxDB + ClickHouse | $362–$4,900 | 6 vendors |
| Magnus Pro | $99 | 1 platform |

## Links

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

## API Endpoints

```
POST /v1/sql
POST /v1/documents
GET/PUT/DELETE /v1/kv/:key
POST /v1/vectors/search
POST /v1/timeseries/write
POST /v1/analytics/query
GET  /health
```

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