Skip to main content

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.

​
CLI First

# Install and register
npm install -g @usenaive-sdk/cli
naive register --name "My Agent" --email owner@example.com --password securepassword123

# First primitive call
naive search "latest AI agent frameworks"

​
Give This to Any AI Agent

Paste the following prompt into any AI agent (Claude, ChatGPT, Cursor, etc.) and it will set up Naive autonomously: 
I want you to follow https://api.usenaive.ai/skill.md and setup naive
That’s it. The agent will read the skill manifest, register an account, and start using primitives.

​
Manual Setup

If you prefer to set things up yourself, this walks through creating an agent account, getting an API key, and making your first API call. Five minutes, end to end.
1

Register your agent

Create an account with an email and password. You’ll get back an API key immediately.
curl -X POST https://api.usenaive.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Research Agent",
    "email": "owner@example.com",
    "password": "securepassword123",
    "company_name": "Acme Corp"
  }'
Response:
{
  "api_key": "nv_sk_live_abc123...",
  "agent_id": "uuid",
  "company_id": "uuid",
  "company_name": "Acme Corp",
  "domain": "acme-corp.usenaive.ai",
  "domain_status": "pending_dns",
  "hint": "Key saved. System domain auto-provisioned (pending_dns until verified). Check GET /v1/domains."
}
Copy your API key immediately — it’s only shown once.
2

Check your identity

Verify everything is wired up correctly:
curl https://api.usenaive.ai/v1/identity \
  -H "Authorization: Bearer nv_sk_live_abc123..."
This shows your agent profile, company, email inboxes, domains, and credit balance.
3

Make your first call

curl -X POST https://api.usenaive.ai/v1/search \
  -H "Authorization: Bearer nv_sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{ "query": "latest AI agent frameworks 2026" }'
Response:
{
  "results": [
    { "title": "Top AI Frameworks 2026", "url": "https://...", "snippet": "..." }
  ],
  "credits_used": 1,
  "credits_remaining": 99
}

​
Using the CLI

# Install
npm install -g @usenaive-sdk/cli

# Register (saves key automatically)
naive register --name "My Agent" --email owner@example.com --password mypassword123

# Verify connectivity
naive status

# Your first search
naive search "latest AI agent frameworks"

​
Using MCP (Claude Desktop / Cursor)

Connect via SSE — no local installation required: 
{
  "mcpServers": {
    "naive": {
      "url": "https://api.usenaive.ai/mcp/sse",
      "headers": {
        "Authorization": "Bearer nv_sk_live_..."
      }
    }
  }
}
The MCP server is hosted — the agent runtime connects directly over SSE. No local server, no ports, just the API key.

​
Agent Discovery

Any agent can fetch https://api.usenaive.ai/skill.md to discover all capabilities and onboard autonomously. Point your agent there and it will know how to register, authenticate, and use every primitive.

​
What’s Available

Once connected, your agent has access to all Phase 1 primitives:
Try thisWhat happens
Search the webPOST /v1/search — real-time web results
Send an emailPOST /v1/email/send — from your provisioned inbox
Generate imagesPOST /v1/images/generate — using FLUX/Recraft models
Generate videoPOST /v1/video/generate — using Kling/Minimax models
Deep researchPOST /v1/search/research — multi-source synthesis

​
Next Steps

Authentication

Key format, linking existing accounts, company selection

Credits

How billing works — sync vs async, dynamic pricing

Email

Create inboxes and send identity-aware emails

Images

Generate AI images or search free stock photos