Naia API

Integrate GEO analysis, content generation and execution plans into any tool. Full REST API + MCP server for native integration with AI tools.

Get API Key Configure MCP

Claude CodeCursorVS CodeWindsurfReplitLovable

Quick Start

Three steps to get started

Generate your API key

Go to dashboard settings and create an access key.

Open settings

Make your first call

Use the example below to list your businesses.

See examples

Explore the endpoints

Browse the full endpoint reference and integrate into your workflow.

See reference

curl -s https://naia.today/api/v1/businesses \
  -H "Authorization: Bearer naia_YOUR_KEY" | jq

Security

Authentication

Bearer Token

All requests require an API token in the Authorization header. Tokens follow the format naia_...

curl https://naia.today/api/v1/businesses \
  -H "Authorization: Bearer naia_YOUR_KEY"

read scope

GET requests. Read businesses, analyses, content.

write scope

POST, PUT, PATCH requests. Create and update resources.

admin scope

DELETE requests + webhook and key management.

Rate limit: 200 requests per minute per key. Configurable per API key.

Reference

Endpoints

Base URL: https://naia.today

Method	Path	Description
GET	`/api/v1/businesses`	List businesses
POST	`/api/v1/businesses`	Create business
GET	`/api/v1/businesses/:id`	Business detail
PUT	`/api/v1/businesses/:id`	Update business
DELETE	`/api/v1/businesses/:id`	Delete business
POST	`/api/v1/businesses/:id/enrich`	AI enrichment
GET	`/api/v1/businesses/:id/queries`	List search queries
PUT	`/api/v1/businesses/:id/queries`	Update search queries

Examples

Requests and responses

Trigger GEO analysis

curl -X POST https://naia.today/api/v1/analyses \
  -H "Authorization: Bearer naia_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": "abc123",
    "models": ["gemini", "chatgpt"]
  }'

{
  "analysisId": "analysis_xyz",
  "status": "pending",
  "creditsReserved": 8,
  "pollUrl": "/api/v1/analyses/analysis_xyz"
}

Generate content

curl -X POST https://naia.today/api/v1/content \
  -H "Authorization: Bearer naia_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": "abc123",
    "templateSlug": "blog-post",
    "topic": "How to improve your brand visibility in AI engines"
  }'

{
  "id": "content_789",
  "status": "pending",
  "creditsCharged": 5,
  "pollUrl": "/api/v1/content/content_789"
}

Analysis results

// GET /api/v1/analyses/analysis_xyz
{
  "id": "analysis_xyz",
  "status": "completed",
  "geoScore": 72,
  "scoreBreakdown": {
    "visibility": 85,
    "citations": 60,
    "position": 78,
    "sentiment": 90,
    "consistency": 65,
    "riskScore": 42,
    "authority": 70,
    "schema": 55,
    "sources": 80
  },
  "engines": ["gemini", "chatgpt"],
  "completedAt": "2026-03-19T14:30:00Z"
}

AI Integration

MCP Server

The Naia MCP server enables native integration with AI tools. JSON-RPC 2.0 protocol with API key authentication via the Authorization header.

Server URL

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

Quick install

Copy the configuration for your editor and start using it in seconds.

Claude Code

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

Cursor

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

Windsurf

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

VS Code

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

Replit

URL: https://naia.today/api/v1/mcp
Header: Authorization: Bearer YOUR_KEY
Type: MCP HTTP Server

Lovable

URL: https://naia.today/api/v1/mcp
Header: Authorization: Bearer YOUR_KEY
Type: MCP HTTP Server

Detailed configuration by tool

Claude Code

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

Cursor (.cursor/mcp.json)

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

Windsurf (.windsurf/mcp.json)

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

VS Code (settings.json)

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

Replit / Lovable

Configure as MCP HTTP server with the URL https://naia.today/api/v1/mcp and authorization header Authorization: Bearer naia_YOUR_KEY.

cURL (raw JSON-RPC)

curl -X POST https://naia.today/api/v1/mcp \
  -H "Authorization: Bearer naia_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Available tools (20)

list_businesses

List registered businesses

get_business

Get business details

create_business

Create a new business (auto-enriches data, requires confirmation)

preview_business

Alias for create_business

confirm_create_business

Confirm business creation after preview

trigger_analysis

Trigger GEO analysis

get_analysis

Get analysis status and results

get_recommendations

Get optimization recommendations

list_content

List generated content

get_content

Get full content with draft

create_content

Generate new content

approve_content

Approve or unapprove content

get_credits

Get credit balance

list_execution_plans

List execution plans

get_execution_plan

Get plan details

create_execution_plan

Generate execution plan

generate_task_content

Generate content for a task

update_task_status

Update task status

get_queries

Get search queries

update_queries

Update search queries

Workflow

How to use

Four steps to integrate Naia into your workflow.

Create an API key

Go to /dashboard/settings/api and generate an access key with the scopes you need.

Configure MCP in your editor

Copy the configuration above for Claude Code, Cursor, VS Code or any compatible editor.

Ask the assistant: "List my businesses on Naia"

The assistant uses MCP to call list_businesses automatically.

Explore analyses, content and plans

Trigger GEO analyses, generate optimized content and track execution plans directly from your chat.

Pricing

Credits

Operation	Cost
GEO Analysis	Variable (per model)
Execution Plan	5 credits
Content (per piece)	5 credits
AI Enrichment	Free
Read (GET)	Free

Support

Frequently asked questions

You get 20 free credits when you sign up. After that, you can purchase additional credit packs based on your plan. All read operations (GET) are free.

Yes. Create your account at naia.today and generate an API key from the dashboard settings at /dashboard/settings/api.

Any version of Claude Code with HTTP MCP support. The server follows the JSON-RPC 2.0 standard protocol.

Yes. The default rate limit is 200 requests per minute per key, and it can be configured per key.

Set up webhooks at /dashboard/settings/api. Available events: analysis.completed, analysis.failed, content.completed, and more.

Yes. Full CRUD for businesses with team access support. Each member accesses businesses according to their role (owner, editor, viewer).