Installation

Northsun (formerly Mnemix) meets your agent where it lives. There are three surfaces, and most teams use more than one:

1. CLI — authenticate, look up callers, run recall demos, and inspect API-key status from your terminal.
2. Hosted MCP — connect an MCP-compatible agent without running a local Northsun process.
3. Raw HTTP — use the platform HTTP client for the frozen caller-memory contract while the npm SDK is brought into contract parity.

Get a key

Northsun keys are issued by hand today, not by automated self-serve signup. That is a deliberate control while onboarding runs at design-partner scale — not a missing feature.

Two ways to ask, both real:

• Submit the early-access form. Its own confirmation states the current commitment: we reach out within 24 hours with a working key.
• Email hello@mnemix.ai directly if you'd rather skip the form.

Either path ends the same way — a sk_live_ key. There's no separate activation step after that: the key works as soon as you have it, against every example on this page.

Prerequisites

• Node.js 20.12+ for the CLI (the SDK alone works on Node 18+).
• A Northsun API key (see "Get a key" above). Hobby is $0; paid tiers are Contact sales. Your tenant is derived from the key — there's nothing else to configure.

Set it once in your shell:

export MNEMIX_API_KEY="sk_live_…"

1. CLI

npm install -g @mnemix-ai/cli@0.2.0
mnemix login          # paste your key when prompted

Verify your credentials resolve:

mnemix whoami
# → key:    sk_live_…xxxx
#   base:   https://mcp.mnemix.ai
#   source: env
#   key valid ✓

Available commands: demo (offline sample), login, recall <phone>, caller <phone>, whoami. Try a live recall:

mnemix recall +15551234567

2. MCP server (recommended for agents)

Northsun speaks MCP natively — the transport is built into the API host at https://mcp.mnemix.ai/mcp, so there is no local process to install. The separate @mnemix-ai/mcp-server package exists in the source repository but is not currently published on npm; use the hosted transport for public setup.

Host migration: the canonical platform host is moving to mcp.northsun.ai. During the transition mcp.mnemix.ai continues to serve the full surface unchanged — existing integrations keep working, no action required. When the successor host is generally available, responses from this host will carry a Deprecation header (RFC 9745) and a Link rel="successor-version" header pointing at the corresponding mcp.northsun.ai URL; a retirement date, if one is ever set, will be announced in advance with a Sunset header (RFC 8594). No cutoff is scheduled.

Configure Claude Code (or any MCP client)

Point your client at the hosted HTTP transport. The "type": "http" discriminator is required for an HTTP MCP server entry:

{
  "mcpServers": {
    "mnemix": {
      "type": "http",
      "url": "https://mcp.mnemix.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${MNEMIX_API_KEY}"
      }
    }
  }
}

MNEMIX_API_KEY is required — the same key as the REST API. Restart your client and the mnemix tools appear.

3. TypeScript

Use native fetch for the frozen public REST contract:

const response = await fetch("https://mcp.mnemix.ai/v1/recall_and_enrich", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MNEMIX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+15551234567",
    trigger: "answered",
    session_id: "call_abc123",
  }),
});

if (!response.ok) throw new Error(`Northsun request failed: ${response.status}`);
const recall = await response.json();

@mnemix-ai/client@0.2.2 is the current published release and its recallAndEnrich / callsEnd / getCaller methods now map directly onto the three frozen routes above (0.2.0 predates this and should not be used for a new integration). See TypeScript for a small typed HTTP wrapper if you'd rather not add the dependency.

Integration-kit source for Bland and Vapi lives in the repository and is published on npm. See Vapi or Bland for the exact install command.

Endpoints at a glance

Surface	Base URL
Everything — REST v1 + MCP transport	https://mcp.mnemix.ai (MCP at /mcp)

One host. The frozen public v1 surface is POST /v1/recall_and_enrich, POST /v1/calls/end, and GET /v1/caller/{phone_number}.

Verify your install

mnemix whoami           # key valid ✓
mnemix recall +15551234567

If the recall card renders, continue to the Quickstart. For language-specific setup, see TypeScript or Python over HTTP.