How much does it cost to use the API?

Read operations are free. Write operations that run analyses, content generation or execution planning consume credits according to the operation shown in the dashboard before confirmation.

Do I need an account?

Yes. Create your account at naia.today. MCP clients with OAuth support connect with universal login (sign in and approve in the browser, no API key to copy). You can also generate an API key at /dashboard/settings/api for headless automations.

Model Context Protocol

Run naia from
the agent you
already use.

naia speaks MCP. Connect Claude Code, Cursor, Codex, Windsurf, VS Code, Replit or Lovable to today.naia/platform and ship GEO analysis, execution plans and humanized content without leaving the conversation.

Get API key Install in 30 seconds GitHub

Tested withClaude CodeCursorCodexWindsurfVS CodeReplitLovableMCP Registrynpm

What a call looks like

The same JSON-RPC every client speaks.

One server, one protocol. Ask the assistant to list tools, prepare a brand setup, then kick off an analysis. The server returns IDs the assistant can poll.

Request

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "autopilot_start_analysis",
    "arguments": {
      "brandId": "abc123",
      "models": ["gemini", "chatgpt"]
    }
  }
}

Response

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "runId": "run_xyz",
    "status": "pending",
    "creditsReserved": 8,
    "pollWith": "autopilot_get_run_status"
  }
}

Six rhythms, one server

Who runs naia from their editor.

Marketing teams

Brief the assistant, watch it draft a quarter of humanized GEO content with the plan attached.

autopilot_create_execution_plan

Newsroom and editorial

Schedule analyses across ChatGPT, Gemini, Claude and Perplexity. Read the diff in your editor.

autopilot_start_analysis

E-commerce

Audit category coverage in AI search, generate landings where citations drop.

autopilot_supermemory_scan

Agency and studio

Switch brand setups, pause an agent for one client, queue a manual run for another.

autopilot_list_brands

Brand custodian

Persist tone, banned phrases and product positioning. The assistant pulls them before every run.

autopilot_memory_create

Devtools and SaaS

Call the same MCP tools from your backend through JSON-RPC. Ship AI visibility inside your app.

JSON-RPC 2.0

The 19 tools

Every tool the assistant can call.

See source

autopilot_list_brands
List Autopilot brands available to the API key
free
autopilot_prepare_brand_setup
Generate the brand setup and approval document before any run
free
autopilot_start_analysis
Start an approved Enterprise GEO analysis
credits
autopilot_get_run_status
Poll an Autopilot run until it completes
free
autopilot_get_report
Read report, visibility and technical audit data
free
autopilot_export_report
Export a finished report as CSV, Excel or PDF
free
autopilot_create_execution_plan
Generate a GEO execution plan with phases and tasks
10 credits
autopilot_get_execution_plan
Read plan, phases and task progress
free
autopilot_generate_content
Generate humanized GEO content with brand voice
50 credits
autopilot_get_content
Read generated content status and draft
free
autopilot_update_content
Edit saved content draft, briefing, title, status or collection
free
autopilot_run_technical_audit
Run technical GEO audit on the brand site
free
autopilot_memory_list
List brand memories used by every generation
free
autopilot_memory_create
Create or update a brand memory entry
free
autopilot_supermemory_scan
Create a SuperMemoria scan over the brand domain
free
autopilot_supermemory_search
Search SuperMemoria nodes by topic
free
autopilot_get_credits
Read credits and per-operation cost estimates
free

Install in 30 seconds

Pick your client, paste the snippet.

Remote HTTP for clients that support it, npm stdio for command-based clients. Clients with MCP OAuth support (Claude Code, claude.ai, Cursor, VS Code, ChatGPT) connect with universal login: add the URL with no headers and approve in the browser, no API key to copy. Sessions last up to 180 days and can be revoked anytime in the dashboard. The same server is also listed in the official MCP Registry as today.naia/platform.

bash

# Universal login (OAuth): your browser opens to sign in and approve
claude mcp add --transport http naia \
  https://naia.today/api/v1/mcp

# Alternative with API key (headless automations)
claude mcp add --transport http naia \
  https://naia.today/api/v1/mcp \
  --header "Authorization: Bearer naia_YOUR_KEY"

How it works

Four moves, from key to first run.

Connect with your account

Add the server URL and your client opens the browser to sign in and approve (OAuth). Prefer headless automation? Generate an API key in /dashboard/settings/api.

Connect the client

Paste the snippet from the install tab. The assistant picks up 19 tools automatically.

Prepare and approve

Ask the assistant to prepare the brand setup. Approve the document. No surprise charges.

Run and ship

Trigger analyses, draft execution plans, generate humanized content. Polling stays in chat.

Also available

REST API for backend integrations.

The MCP server is the primary surface. The same operations are also available as REST endpoints when you embed naia in your own product.

OpenAPI spec MCP descriptor

POST/api/v1/analyses
Trigger a GEO analysis run
POST/api/v1/content
Generate humanized content (50 credits)
POST/api/v1/execution-plans
Generate an execution plan (10 credits)
GET/api/v1/businesses
List businesses your key can read
GET/api/v1/credits
Read current balance and cost preview
POST/api/v1/mcp
JSON-RPC entry point used by every MCP client

FAQ

Four questions before you connect.

The assistant calls naia tools from the conversation, with structured arguments and consistent brand memory. You stay in the editor, you keep the audit trail, the assistant does the orchestration.

No. Read tools execute. Paid tools require an approval document first (autopilot_prepare_brand_setup), then explicit go-ahead. Costs are shown before confirmation.

Any HTTP MCP client. Tested with Claude Code, Cursor, Codex, Windsurf, VS Code, Replit and Lovable. The npm stdio proxy covers command-based clients.

Not anymore. Clients with MCP OAuth support connect with universal login: the server replies 401, the client discovers the OAuth endpoints, opens the browser, you sign in and approve. The session lasts up to 180 days via refresh token and can be revoked anytime in the dashboard. API keys remain available for headless automations.

Yes. The same operations are available as REST endpoints under /api/v1, registered in the OpenAPI specification. Use REST when you embed naia in your own backend.

Your editor.
Your brand voice.
Our GEO engine.

Get API key See pricing

Run naia fromthe agent youalready use.