Connection Guide - Naive API v2

SSE Transport

The Naive MCP server uses Server-Sent Events (SSE) transport. This is a standard HTTP connection that stays open for bidirectional communication.

Connecting

Get an API key

Connect SSE

Open a connection to:

GET https://api.usenaive.ai/mcp/sse
Authorization: Bearer nv_sk_live_...

The server responds with a session event containing a sessionId.

Send messages

POST https://api.usenaive.ai/mcp/messages?sessionId=<session-id>
Content-Type: application/json

Client Configuration Examples

Claude Desktop
Cursor
Custom Client

Add to claude_desktop_config.json:

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

Add to .cursor/mcp.json in your workspace:

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

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL("https://api.usenaive.ai/mcp/sse"),
  {
    requestInit: {
      headers: {
        Authorization: "Bearer nv_sk_live_...",
      },
    },
  }
);

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const result = await client.callTool("naive_web_search", {
  query: "latest AI news",
});

Session Lifecycle

Sessions are tied to the SSE connection
When connection drops, the session ends
Each new connection creates a new session
Auth is validated once at connection time

Differences from Original Naive MCP

Feature	Original (`@usenaive-sdk/node`)	v2 (Hosted)
Transport	stdio (local process)	SSE (remote)
Requires local install	Yes (`npm i -g @usenaive-sdk/node`)	No
Auth	`NAIVE_API_KEY` env var	Bearer header on SSE
Proxies through	api.usenaive.ai → Paperclip	Direct (same instance)
Latency	Two hops	Single hop

​SSE Transport

​Connecting

​Client Configuration Examples

​Session Lifecycle

​Differences from Original Naive MCP

SSE Transport

Connecting

Client Configuration Examples

Session Lifecycle

Differences from Original Naive MCP