naia-mcp-server

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

• Create an account at https://naia.today
• Open Dashboard > Settings > API
• Create an API key with read and write scopes
• 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

• Call autopilot_get_credits
• Call autopilot_prepare_brand_setup with websiteUrl
• Ask the user to choose topics when topicOptions is returned
• Call autopilot_prepare_brand_setup again with selectedTopics
• Ask the user to approve the returned Markdown approvalDocument
• Call autopilot_start_analysis with approved=true, selectedTopics, and approvedPrompts
• 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.