naia MCP Server

Autopilot MCP server for Generative Engine Optimization (GEO). Use it to prepare a brand setup, approve the analysis prompts, run GEO analysis, read reports, build execution plans and generate reviewed content from an MCP-compatible AI tool.

The recommended connection is the remote Streamable HTTP server:

https://naia.today/api/v1/mcp

The npm package also works as a stdio proxy for clients that cannot connect to remote HTTP MCP servers directly.

Official Registry name:

today.naia/platform

Get an API key

1. Create an account at https://naia.today
2. Open Dashboard > Settings > API
3. Create an API key with read and write scopes
4. Send it as Authorization: Bearer naia_your_key

Quick install

Codex

export NAIA_API_KEY=naia_your_key
codex mcp add naia --url https://naia.today/api/v1/mcp --bearer-token-env-var NAIA_API_KEY
codex mcp list

Codex stores this in ~/.codex/config.toml:

[mcp_servers.naia]
url = "https://naia.today/api/v1/mcp"
bearer_token_env_var = "NAIA_API_KEY"

Claude Code

claude mcp add --transport http naia https://naia.today/api/v1/mcp \
  --header "Authorization: Bearer naia_your_key"

Cursor

Create ~/.cursor/mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "naia": {
      "url": "https://naia.today/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer naia_your_key"
      }
    }
  }
}

VS Code

Create .vscode/mcp.json:

{
  "servers": {
    "naia": {
      "type": "http",
      "url": "https://naia.today/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer naia_your_key"
      }
    }
  }
}

Local stdio via npm

Use this when the MCP client only supports command-based servers:

{
  "mcpServers": {
    "naia": {
      "command": "npx",
      "args": ["-y", "naia-mcp-server"],
      "env": {
        "NAIA_API_KEY": "naia_your_key"
      }
    }
  }
}

You can also run the proxy directly:

NAIA_API_KEY=naia_your_key npx -y naia-mcp-server

The proxy reads NAIA_API_KEY or NAIA_MCP_API_KEY, forwards JSON-RPC to the remote server, and keeps the raw key out of project files.

Available tools

All public tools are Autopilot tools and share the same product path used in the naia dashboard.

| Tool | Purpose | | --- | --- | | autopilot_list_brands | List Autopilot brands, latest run, and SuperMemoria status | | autopilot_prepare_brand_setup | Prepare brand setup and generate the Markdown prompt approval document | | autopilot_start_analysis | Start an Enterprise GEO analysis after explicit approval | | autopilot_get_run_status | Poll an Autopilot run | | autopilot_get_report | Read report, GEO analysis, visibility, technical audit, and next steps | | autopilot_export_report | Export report as CSV, XLSX, or PDF | | autopilot_create_execution_plan | Generate a GEO execution plan from a completed report | | autopilot_get_execution_plan | Read execution plan, phases, and tasks | | autopilot_generate_content | Generate humanized GEO content with memories and brand context | | autopilot_get_content | Read generated content status and draft | | autopilot_run_technical_audit | Run technical audit for MCP, agents.json, llms.txt, robots, sitemap, and citability signals | | autopilot_memory_list | List brand memories and SuperMemoria summary | | autopilot_memory_create | Create objective, keyword, note, email route, or image configuration memory | | autopilot_supermemory_scan | Create a SuperMemoria scan | | autopilot_supermemory_search | Search active SuperMemoria nodes | | autopilot_agent_list | List squads, agents, and latest runs | | autopilot_agent_toggle | Activate or pause an existing agent | | autopilot_agent_run_now | Enqueue a manual agent run | | autopilot_get_credits | Read credit balance and Autopilot cost estimates |

Required analysis flow

1. Call autopilot_get_credits
2. Call autopilot_prepare_brand_setup with websiteUrl
3. Ask the user to choose topics when topicOptions is returned
4. Call autopilot_prepare_brand_setup again with selectedTopics
5. Ask the user to approve the returned Markdown approvalDocument
6. Call autopilot_start_analysis with approved=true, selectedTopics, and approvedPrompts
7. Poll with autopilot_get_run_status or configure a webhook callback

Long running operations return IDs quickly and continue in the naia backend.

Registry metadata

This package includes server.json for the official MCP Registry. It declares both:

• Remote Streamable HTTP server at https://naia.today/api/v1/mcp
• npm stdio package naia-mcp-server
• Registry name today.naia/platform
• Current npm version 1.0.2
• Current registry metadata version 1.0.3

Links

• Documentation: https://naia.today/developers
• OpenAPI: https://naia.today/api/v1/openapi.json
• llms.txt: https://naia.today/llms.txt
• MCP descriptor: https://naia.today/.well-known/mcp.json
• MCP server card: https://naia.today/.well-known/mcp/server-card.json

License

Proprietary. Usage is subject to the naia Terms of Service.