naia GEO Autopilot

Execute análises de visibilidade em IA, consulte relatórios GEO, gere e edite conteúdo e crie planos de execução pela Naia.

View on naia.todayTry this MCPSponsored

Hosted MCP Server

npx add-mcp 'https://naia.today/api/v1/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

API, MCP e npm para GEO em ferramentas de IA | naia

Source: https://naia.today/developers

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 with Claude Code· Cursor· Codex· Windsurf· VS Code· Replit· Lovable· MCP Registry· npm·

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

jsonCopy

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

Response

jsonCopy

{
  "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 the default ChatGPT, Gemini and Perplexity analysis matrix. Add scoped coverage when the project requires it.

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

40 featured tools

Autopilot and naia Index in one MCP.

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. It applies the approved list as the brand's prompt set, so on a brand with a paid analysis a different list is refused unless replaceExistingPrompts=true; to only update a report use autopilot_refresh_report. Prompt cost: 10 credits per prompt on the first analysis of a brand with each engine charged once; on a brand that already completed a paid analysis, 3 credits per prompt plus each engine's credits on every prompt (prompt x engine), with coordination and visibility charged once

    credits

  • autopilot_refresh_report

    Refresh the report of an already analyzed brand reusing its current prompts, like the dashboard Update button; call without confirmed to get the plan and cost, then with confirmed=true. Never changes prompts, topics, competitors or engines. When the prompts run (forced, or the weekly window expired) each prompt runs on each engine and costs 3 credits plus each engine's credits per prompt (prompt x engine), with coordination and visibility once, for example 20 prompts on ChatGPT and Gemini cost 20 x (3 + 5 + 2) + 1 + 3 = 204 credits; when it reuses the week's responses no prompt runs and only the engines once, coordination and visibility are charged (11 credits in the same example)

    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_content_covers

    Generate or redo cover images (16:9 by default) for content and published Pages posts, with a numbered pick list and preview before charging

    free

  • autopilot_run_technical_audit

    Run technical GEO audit on the brand site

    free

  • autopilot_diagnose_published

    Diagnose citability of published posts across AI engines

    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, per-operation cost estimates and the pricingRules field with the prompt billing rule

    free

  • autopilot_get_traffic_report

    Read the Traffic group: Search Console, GA (AI referral sessions), Social, PageSpeed and Off-Site Presence, with freshness and summaries

    free

  • autopilot_refresh_traffic_report

    Refresh the Traffic group from the brand's connected accounts; PageSpeed only when requested

    PageSpeed 10 credits

  • autopilot_get_suggestions

    Proactive, ready-to-run suggestions for the brand: Google trends of the week, AI questions where the brand is missing, repurposing to YouTube, LinkedIn and Reddit, naia Page and weekly agents

    free

  • autopilot_automation_create

    Create a brand agent: a saved prompt naia runs on a schedule, optionally within a period (startsAt, endsAt); dryRun previews schedule, next runs, budget and email

    free

  • autopilot_automation_update

    Edit an agent: prompt, schedule, period, budget, email or pause and resume

    free

  • autopilot_automation_list

    List the brand's agents with schedule, period, state, last run and real run count

    free

  • autopilot_automation_run_now

    Run an agent now; the run charges credits up to the agent budget

    free

  • autopilot_automation_delete

    Delete an agent and its run history, after a preview and confirmed=true

    free

  • autopilot_create_artifact

    Create the brand's naia Pages content site, already active; failed creations are not charged and retries are free

    10 credits

  • autopilot_get_artifact_config

    Read the naia Page domain state, the two DNS records to create and, once live, the main site checklist with ready-to-paste snippets

    free

  • autopilot_verify_artifact_domain

    Verify the custom domain now and issue the certificate; naia also checks every 15 minutes and emails the owner when it goes live

    free

  • naia_index_list_categories

    List public naia Index categories and publication status

    free

  • naia_index_get_rankings

    Read a category ranking with visibility points, share of voice (shareOfVoice, derived, valid only within the category and round), engine positions and leader history

    free

  • naia_index_get_history

    Read monthly brand history and compare another brand

    free

  • naia_index_compare_categories

    Compare leaders or the same brand across categories

    free

  • naia_index_compare_periods

    Compare monthly evolution for category leaders

    free

  • naia_index_get_overall_ranking

    Read the overall Brazil ranking across current categories

    free

  • naia_index_get_methodology

    Read the structured public methodology: scoring, share of voice definition, measurement principle, practical tie rule and cadence

    free

  • naia_index_list_studies

    List measured and published naia Index studies

    free

  • naia_index_get_study

    Read a published study snapshot by slug

    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.

Claude CodeCursorCodexWindsurfVS Codenpm stdioReplitLovablecURL

bashCopy

# 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.

01

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.

02

Connect the client

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

03

Prepare and approve

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

04

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/public/ai-readiness/embed

    Generate or read an AI Readiness report for an allowlisted partner domain

  • 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/businesses/{id}/traffic

    Read Search Console, GA, Social, PageSpeed and Off-Site Presence for a brand

  • POST``/api/v1/businesses/{id}/traffic/refresh

    Refresh the Traffic group (free by default; PageSpeed 10 credits when requested)

  • GET``/api/v1/credits

    Read current balance and cost preview

  • POST``/api/v1/mcp

    JSON-RPC entry point used by every MCP client

Partner embed

AI Readiness with a scoped API key.

Create a key with the AI Readiness scope in the dashboard, store it in the partner backend, and call naia from a server route. Never put the key in browser JavaScript, HTML, localStorage, query strings or public environment variables.

The partner domain must also be allowlisted by naia. Use HTTPS origins such as https://partner.com and https://www.partner.com.

tsCopy

// Partner backend route. Keep NAIA_API_KEY in server secrets.
export async function POST() {
  const response = await fetch("https://naia.today/api/public/ai-readiness/embed", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.NAIA_API_KEY}`,
      "Content-Type": "application/json",
      "Accept": "application/json"
    },
    body: JSON.stringify({ domain: "partner.com" })
  });

  return new Response(await response.text(), {
    status: response.status,
    headers: { "Content-Type": "application/json" }
  });
}

jsCopy

// Browser code calls your own backend, never naia directly with a key.
const response = await fetch("/api/naia-ai-readiness", { method: "POST" });
const payload = await response.json();

FAQ

Four questions before you connect.

Why MCP instead of curl?

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.

Do paid tools run automatically?

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

Which clients are supported today?

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

Do I need to copy an API key?

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.

Is there a REST API too?

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