Quickstart - Naive API v2

Naive is multi-tenant infrastructure for AI agents. One API key works across the SDK, CLI, and MCP. Pick your surface.

npm install @usenaive-sdk/node

import { Naive } from "@usenaive-sdk/node";

const naive = new Naive({ apiKey: process.env.NAIVE_API_KEY! });

// Solo mode — auto-scopes to your default user.
await naive.cards.create({ spending_limit_cents: 25000 });
await naive.vault.put("instantly.api_key", "key_xyz");
const { redirectUrl } = await naive.connections.connect("gmail", {
  callbackUrl: "https://myapp.com/oauth/callback",
});

// Multi-tenant — create a user, then scope with forUser(id).
const alice = await naive.users.create({ external_id: "alice_db_uuid" });
await naive.forUser(alice.id).cards.create({ spending_limit_cents: 25000 });

See the full SDK reference.

npm install -g @usenaive-sdk/cli
naive login --key nv_sk_live_...

# Solo — acts on your default user
naive cards create --limit 250
naive connections connect gmail
naive vault put instantly.api_key key_xyz

# Multi-tenant
naive users create --external-id alice
naive use <user_id>            # set the active subject
naive cards list --user alice  # or override per command

{
  "mcpServers": {
    "naive": {
      "url": "https://api.usenaive.ai/mcp/sse",
      "headers": { "Authorization": "Bearer nv_sk_live_..." }
    }
  }
}

Every tool accepts an optional user_id; omit it to act on your default user. See the MCP tools reference.

Next steps

Users — provision your end-users
AccountKits — bundle policy
Connections — 1,000+ third-party apps
Vault — per-user encrypted secrets

​Next steps

Next steps