> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first Naïve call — SDK, CLI, or MCP.

Three surfaces, one API key. The SDK embeds Naïve in your multi-tenant app; the CLI
and MCP act on your default user out of the box.

<Tabs>
  <Tab title="SDK">
    ```bash install theme={"theme":"css-variables"}
    npm install @usenaive-sdk/node
    ```

    <div className="naive-section-label">Solo mode</div>

    ```ts agent.ts theme={"theme":"css-variables"}
    import { Naive } from "@usenaive-sdk/node";

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

    // Solo mode — every call 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",
    });
    ```

    <div className="naive-section-label">Multi-tenant mode</div>

    ```ts signup.ts theme={"theme":"css-variables"}
    // Multi-tenant — create a user, then scope with forUser(id).
    const alice = await naive.users.create({
      external_id: "alice_db_uuid",
      email: "alice@example.com",
    });

    const client = naive.forUser(alice.id);
    await client.cards.create({ spending_limit_cents: 25000 });
    await client.connections.connect("gmail", { callbackUrl });
    const session = await client.session(); // per-user MCP session
    ```

    See the full [SDK reference](/docs/sdk/overview).
  </Tab>

  <Tab title="CLI">
    ```bash bash theme={"theme":"css-variables"}
    npm install -g @usenaive-sdk/cli
    naive login --key nv_sk_live_...

    # Solo mode — 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 --email alice@example.com
    naive use <user_id>           # set the active user
    naive cards list --user alice # or override per command
    ```
  </Tab>

  <Tab title="MCP">
    ```json mcp.json theme={"theme":"css-variables"}
    {
      "mcpServers": {
        "naive": {
          "url": "https://api.usenaive.ai/mcp/sse",
          "headers": { "Authorization": "Bearer nv_sk_live_..." }
        }
      }
    }
    ```

    Hosted MCP — your agent connects over SSE. Every tool accepts an optional
    `user_id`; omit it to act on your default user. See the [MCP tools reference](/docs/mcp/tools).
  </Tab>
</Tabs>

## Start from a template

Hand a pre-built blueprint to your coding agent. Paste the prompt below — it reads
[skill.md](https://usenaive.ai/skill.md) for full setup context — then pick a template to apply.

```txt agent prompt theme={"theme":"css-variables"}
Read https://usenaive.ai/skill.md and use it to set up Naïve in my project.
```

<div className="naive-section-label">Autonomous companies</div>

| Template                 | Description                                                             | Status |
| ------------------------ | ----------------------------------------------------------------------- | ------ |
| **AI media channel**     | Faceless content brand that researches, produces, posts, and monetizes. | Soon   |
| **AI automation agency** | Delivers client work autonomously, bills, and reports.                  | Soon   |
| **AI trading assistant** | Connects to a brokerage; drafts trades the user reviews and approves.   | Soon   |

<div className="naive-section-label">Multi-tenant apps</div>

| Template                           | Description                                                           | Status                                                    |
| ---------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------- |
| **AI SEO platform for SMBs**       | Each customer gets an agent that signs up, researches, and publishes. | [GitHub](https://github.com/usenaive/ai-seo-geo-platform) |
| **AI outbound agent for SaaS**     | Per-tenant domains, inboxes, and sequencer accounts.                  | Soon                                                      |
| **AI voice agent for dealerships** | Each location provisioned, scoped, and billed on its own.             | Soon                                                      |

## Next steps

* [Agent Profiles](/docs/getting-started/agent-profiles) — the governed real-world bundle
* [Users](/docs/getting-started/users) — provision your end-users
* [Account Kits](/docs/getting-started/account-kits) — bundle policy
* [Connections](/docs/getting-started/connections) — 1,000+ third-party apps
* [Vault](/docs/getting-started/vault) — per-user encrypted secrets
* [Governance gateway](/docs/architecture/governance-gateway) — caps, approvals, audit, revoke