> ## 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. # Introduction > Naïve gives every AI agent its own governed real-world agent profile — verified identity, a spend-capped card, comms, and a runtime, per tenant. **Naïve gives every AI agent its own real-world agent profile:** a verified business identity (KYC/EIN/formation), a spend-capped card, an inbox and phone number, and (optionally) a place to run — provisioned **per end-user**, governed on every action, and **instantly revocable**. The defensible unit is the **bundle**: identity + money + comms + runtime as one per-tenant agent profile, governed together. Stripe will give an agent a card tied to a user's wallet; Naïve gives *each of your customers' agents its own incorporated entity, its own inbox and number, its own card, and its own runtime — as one governed unit, a million times over.* ## Works with the runtime you already use Naïve is **runtime-agnostic**. Provision an agent profile, pull its governed tools, and run the agent inside Vercel Eve, AWS Bedrock AgentCore, a LangGraph loop, your own harness — or Naïve's hosted containers. Those frameworks give an agent durability and a sandbox; none of them give it a legal identity, a card, or registered comms. Naïve is the regulated agent profile they call, and governance (spend caps, approvals, audit, revoke) holds no matter where the agent runs. ## CLI First ```bash theme={"theme":"css-variables"} # Install CLI npm install -g @usenaive-sdk/cli # Register, scaffold a template, and provision an agent profile naive register --name "My Agent" --email owner@example.com --password securepassword123 naive init # scaffold naive.config.ts (agentProfile template) naive up # register the template naive agent profiles provision support --user ``` ## What's Different * **The full per-tenant agent profile bundle** — its own legal entity + comms + money + runtime, governed as one. Not just a card attached to someone's wallet. * **The governance gateway** — every regulated action (a charge, a send, a refund) routes through a policy proxy: spend caps, approvals, audit, and one-click revoke at the tool-call boundary, across the whole agent profile. * **Per-tenant comms** — phone numbers, A2P/10DLC registration, custom-domain email with isolated sending reputation. * **Self-service onboarding** — agents can register, link accounts, and mint API keys without human intervention. * **Identity-aware** — every primitive knows what resources the agent profile has ("what inboxes do I own?"). * **MCP-native** — hosted MCP server runs alongside REST on the same instance. * **Agent-discoverable** — `GET /skill.md` returns everything an agent needs to get started. ## Three Ways to Connect Standard HTTP with `Authorization: Bearer nv_sk_...` SSE transport at `/mcp/sse` — works with Claude Desktop, Cursor, etc. `naive` command for terminal workflows and agentic use ## Orchestration (optional) Naïve can also host and coordinate agents directly — a persistent CEO gateway that decomposes objectives into tasks and dispatches them to AI employees. This is **controlled autonomy**: humans stay on the exceptions via approvals and audit, not "no humans in the loop." It's optional — most teams adopt Naïve for the regulated agent profile bundle first and bring their own runtime. | Feature | What it does | CLI | | ------------------ | ------------------------------------------------------------------------------------------------ | ------------------ | | **CEO Agent** | Persistent gateway that interprets prompts, proposes teams, creates tasks, dispatches to workers | `naive ceo` | | **Tasks (Kanban)** | Unit of work — create, assign, complete, block; embedded dispatcher auto-spawns workers | `naive tasks` | | **Objectives** | Strategic goals (weeks-to-months) that decompose into tasks | `naive objectives` | | **Employees** | AI workforce — hire, fire, configure agents with roles and skills | `naive employees` | | **Cron Jobs** | Scheduled recurring prompts via Hermes gateway Jobs API | `naive cron` | | **Memory** | Persistent context owned by Hermes, mirrored to the managed database | `naive memory` | ## Available Primitives | Primitive | What it does | Cost | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | **Apps** | Managed web apps — managed Next.js hosting with optional managed backend, full platform API access via scoped proxies | Free | | **Database** | Managed Postgres on a fullstack app — SQL, REST CRUD, migrations (for your project or your users') | Free | | **Storage** | File storage buckets & objects on a fullstack app's managed backend | Free | | **Edge Functions** | List, deploy & invoke serverless edge functions on a fullstack app | Free | | **Auth** | End-user authentication & admin user management on a fullstack app | Free | | **Domains** | System domain auto-provisioning, custom domain (BYOD), DNS verification, agent DNS record editing | Free | | **Email** | Create inboxes, send/receive emails (identity-aware) | 10 credits/send | | **Search** | Web search, URL extraction, deep research with citations | 10-80 credits | | **LLM** | OpenRouter-backed chat completions across 300+ models (drop-in OpenRouter wrapper) | Dynamic (per-token) | | **Images** | Generate AI images (FLUX, SD 3.5, Recraft), stock photos | Dynamic | | **Video** | Generate AI video (Kling, Minimax, Wan) | Dynamic | | **Social** | Post to 10+ platforms via Naive's social infrastructure — connect, post, schedule, analytics | 10 credits/publish | | **SEO** | Keyword research, backlinks, competitor analysis | Dynamic | | **App Data** | App rankings, reviews, metadata from Google Play and App Store | Dynamic | | **Travel** | Hotel and place discovery via Google Hotels and TripAdvisor search | Dynamic | | **Reviews** | Reputation and review intelligence from Google, Trustpilot, TripAdvisor, and social signals | Dynamic | | **AEO** | AI search optimization — LLM responses, mentions, AI keyword volume | Dynamic | | **E-commerce** | Product listings, pricing, sellers from Google Shopping and Amazon | Dynamic | | **Cards** | Virtual cards for agent spending, funding, and assignment workflows | Dynamic | | **Phone** | Provision US phone numbers and send/receive SMS via Surge (carrier-registered 10DLC) | Metered (provision + monthly rental + per-SMS) | | **Trading** | Link a brokerage account (OAuth) and trade stocks, options & crypto — account, positions, orders, market data | Free (passthrough) | | **Verification** | Identity verification (KYC) for founders | Free | | **Formation** | LLC company formation — submit, track, download documents | \$249 (hosted checkout) | | **Jobs** | Unified async tracking for all long-running operations | Free | | **Customer Billing** | Per-tenant plans, subscriptions & metered usage quotas for *your* end-customers (plan → Account Kit + quota) | Free | | **Webhooks** | Per-tenant outbound event subscriptions — signed, retried delivery of `email.received` / `sms.received` / `approval.resolved` | Free | | **Billing** | Your own Naive plan ($49-149/mo), credit top-ups ($10-100), domain purchases | — | ## Architecture ```mermaid theme={"theme":"css-variables"} flowchart TB Agent["AI Agent"] -->|"Bearer nv_sk_..."| REST["/v1/* REST API"] Agent -->|"SSE + Bearer"| MCP["/mcp/sse MCP Server"] CLI["naive CLI"] -->|"Bearer nv_sk_..."| REST Studio["Studio UI"] -->|"Session Cookie"| REST REST --> DB[(Managed Postgres)] REST --> MediaGen["Image/Video Generation"] REST --> EmailSvc["Email Service"] REST --> SearchSvc["Search / SEO / Data"] REST --> SocialSvc["Social Platform APIs"] REST --> Payments["Payments"] REST -->|"Push-Through"| Sidecar["Container Sidecar :3100"] Sidecar --> Gateway["Hermes CEO Gateway :8642"] Gateway -->|"Embedded Dispatcher"| Workers["Employee Workers"] Gateway -->|"nv_sk_* token"| Proxy["/v1/proxy/* LLM Proxy"] Proxy --> LLM["Anthropic / OpenAI / Google"] Sidecar -->|"Mirror kanban + memory"| DB subgraph Container["Company Container"] Sidecar Gateway Workers end ``` ## What's Available Once connected, your agent has access to all available MCP tools and a full REST API. Here are some things to try: | Try this | What happens | | ------------------------------------------ | ---------------------------------------------------- | | "Search the web for AI frameworks" | Calls `naive_web_search` — real-time web results | | "Create an email inbox for outreach" | Calls `naive_create_inbox` on your company domain | | "Generate a logo for my product" | Calls `naive_generate_images` using FLUX models | | "Create a product demo video" | Calls `naive_generate_video` using Kling models | | "Research the competitive landscape" | Calls `naive_research` for multi-step synthesis | | "Find keyword opportunities for our blog" | Calls `naive_seo_execute` — keyword data | | "Check our competitor's backlink profile" | Calls `naive_seo_execute` — backlink analysis | | "What does ChatGPT say about our product?" | Calls `naive_aeo_execute` — LLM response tracking | | "Compare headphone prices on Amazon" | Calls `naive_ecommerce_execute_async` — product data | | "Get reviews for our app on Google Play" | Calls `naive_app_data_execute_async` — app reviews | ## Next Steps Register and make your first API call in 2 minutes Set up your AI workforce with CEO, employees, and kanban API key format, auth flow, and error handling Sync vs async billing, dynamic model pricing