README.md
Generative Engine Optimization (GEO) platform for AI visibility.
Naia MCP Server
Generative Engine Optimization (GEO) platform — analyze and optimize brand visibility across AI engines.
Naia provides an MCP server that lets AI assistants interact with the full GEO platform: run analyses across ChatGPT, Gemini, Claude and Perplexity, generate optimized content, and manage execution plans.
Quick Install
Claude Code
claude mcp add naia-api --transport http --url https://naia.today/api/v1/mcp --header "Authorization: Bearer YOUR_API_KEY"
Cursor
Create .cursor/mcp.json:
{
"mcpServers": {
"naia": {
"url": "https://naia.today/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
VS Code
Add to settings.json:
{
"mcp": {
"servers": {
"naia": {
"type": "http",
"url": "https://naia.today/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}
Windsurf
Create .windsurf/mcp.json:
{
"mcpServers": {
"naia": {
"url": "https://naia.today/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Replit / Lovable
Configure as MCP HTTP server:
- URL:
https://naia.today/api/v1/mcp - Header:
Authorization: Bearer YOUR_API_KEY
Get Your API Key
- Create an account at naia.today
- Go to Dashboard > Settings > API
- Create a new API key with the scopes you need
Available Tools
| Tool | Description | Credits |
|---|---|---|
list_businesses |
List your businesses/brands | Free |
get_business |
Get business details | Free |
create_business |
Create a new business | Free |
trigger_analysis |
Run GEO analysis | Variable |
get_analysis |
Get analysis results (poll until completed) | Free |
get_recommendations |
Get optimization recommendations | Free |
list_content |
List generated content | Free |
get_content |
Get content with full draft | Free |
create_content |
Generate AI-optimized content | 5 credits |
approve_content |
Toggle content approval | Free |
get_credits |
Check credit balance | Free |
list_execution_plans |
List execution plans | Free |
get_execution_plan |
Get plan with phases and tasks | Free |
create_execution_plan |
Generate strategic plan | 5 credits |
generate_task_content |
Generate content for a task | 5 credits |
update_task_status |
Update task status | Free |
get_queries |
Get search queries | Free |
update_queries |
Update search queries | Free |
Example Usage
After configuring the MCP server, you can ask your AI assistant:
- "List my businesses on Naia"
- "Run a GEO analysis for my business across ChatGPT and Gemini"
- "Check the results of my latest analysis"
- "Generate a blog post about AI visibility optimization"
- "Create an execution plan based on the analysis recommendations"
- "What is my current credit balance?"
REST API
The same functionality is available via REST API at https://naia.today/api/v1/.
Full documentation: naia.today/developers
Authentication
All requests require an API key in the Authorization header:
Authorization: Bearer naia_YOUR_API_KEY
Scopes
read— GET requests (list, get, search)write— POST, PUT, PATCH (create, update, generate)admin— DELETE + key/webhook management
Rate Limits
200 requests per minute per API key (configurable).
Links
License
Proprietary. Usage subject to Terms of Service.
Tools (18)
list_businessesList your businesses/brandsget_businessGet business detailscreate_businessCreate a new businesstrigger_analysisRun GEO analysisget_analysisGet analysis results (poll until completed)get_recommendationsGet optimization recommendationslist_contentList generated contentget_contentGet content with full draftcreate_contentGenerate AI-optimized contentapprove_contentToggle content approvalget_creditsCheck credit balancelist_execution_plansList execution plansget_execution_planGet plan with phases and taskscreate_execution_planGenerate strategic plangenerate_task_contentGenerate content for a taskupdate_task_statusUpdate task statusget_queriesGet search queriesupdate_queriesUpdate search queriesEnvironment Variables
AuthorizationrequiredBearer token for API authenticationConfiguration
claude_desktop_config.json
{"mcpServers": {"naia": {"url": "https://naia.today/api/v1/mcp", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}Try it
→List my businesses on Naia
→Run a GEO analysis for my business across ChatGPT and Gemini
→Generate a blog post about AI visibility optimization
→Create an execution plan based on the analysis recommendations
→What is my current credit balance?