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.
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
Register at POST /v1/auth/register or use an existing key.
Connect SSE
Open a connection to:GET https://api.usenaive.ai/mcp/sse
Authorization: Bearer nv_sk_live_...
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) | v2 (Hosted) |
|---|
| Transport | stdio (local process) | SSE (remote) |
| Requires local install | Yes (npm i -g @usenaive/sdk) | 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 |
