@agentaeo/mcp-server

Servidor MCP (Model Context Protocol) para AgentAEO: ejecuta auditorías AEO (Answer Engine Optimization) en ChatGPT, Perplexity, Claude y Google AI.

Inicio rápido (30 segundos)

Paso 1 — Obtén tu clave API en agentaeo.com/agents

Paso 2 — Añádela a la configuración de tu host MCP (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "agentaeo": {
      "command": "npx",
      "args": ["-y", "@agentaeo/mcp-server"],
      "env": {
        "AGENTAEO_API_KEY": "your_key_here"
      }
    }
  }
}

Paso 3 — Pregúntale a tu agente:

Run a free AEO audit for example.com with keyword "AI search visibility"

Cómo funciona la clave API con agentes de IA

El agente nunca visita agentaeo.com para obtener una clave. Tú (el operador) obtienes la clave una vez y la configuras en tu archivo de configuración del host MCP. Cada agente de IA que se ejecuta a través de ese host hereda la clave de forma silenciosa desde el entorno; el agente nunca la ve en el chat ni la maneja directamente.

You (one time)
  ├─ 1. Get API key from agentaeo.com/agents
  ├─ 2. Set AGENTAEO_API_KEY in MCP host config
  │
MCP Host (Claude Desktop / Cursor)
  ├─ 3. Starts MCP server process with env var injected
  │
@agentaeo/mcp-server
  ├─ 4. Reads AGENTAEO_API_KEY from environment
  ├─ 5. Exposes 5 tools to the agent
  │
AI Agent
  └─ 6. Calls tools by name — never sees or touches the key

Mantén tu clave privada. Nunca la subas a git ni la pegues en el chat.

Configura tu host MCP

Claude Desktop

Archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agentaeo": {
      "command": "npx",
      "args": ["-y", "@agentaeo/mcp-server"],
      "env": {
        "AGENTAEO_API_KEY": "your_key_here"
      }
    }
  }
}

Cierra completamente Claude Desktop (Cmd+Q) y vuelve a abrirlo después de editar. Comprueba Settings → Developer → Local MCP servers para ver un estado en verde.

Cursor IDE

Global (~/.cursor/mcp.json):

{
  "mcpServers": {
    "agentaeo": {
      "command": "npx",
      "args": ["-y", "@agentaeo/mcp-server"],
      "env": {
        "AGENTAEO_API_KEY": "your_key_here"
      }
    }
  }
}

Solo para el proyecto (.cursor/mcp.json en la raíz del repositorio): mismo formato; solo surte efecto para ese proyecto.

Glama Inspector

En el inspector MCP alojado de Glama, establece la variable de entorno AGENTAEO_API_KEY en la configuración de Secrets / Environment de tu instancia antes de conectar. Sin ella, cualquier herramienta que llame a la API de AgentAEO devolverá un error de autenticación.

Instalación global + variable de entorno

npm install -g @agentaeo/mcp-server
export AGENTAEO_API_KEY=your_key_here
agentaeo-mcp-server

Herramientas

Flujos típicos

Auditoría gratuita (vista previa):

run_aeo_audit → check_aeo_audit_status (poll every 10s) → preview report

Auditoría completa + paquete de contenido (pago):

run_aeo_audit → check_aeo_audit_status (poll until is_complete)
  → generate_aeo_content_suite → check_aeo_content_suite_status (poll every 30s)
  → download_aeo_content_suite_zip

Variables de entorno opcionales

Recursos

El servidor expone un recurso estático en agentaeo://workflow: una guía en Markdown que cubre la secuencia de herramientas recomendada (auditoría → consulta → paquete de contenido → consulta → descarga). Léela con cualquier cliente MCP que admita recursos.

Solución de problemas

AGENTAEO_API_KEY is required but not set Falta la variable de entorno. Añádela al bloque env de la configuración de tu host MCP (consulta Configuración arriba). Vuelve a ejecutar run_aeo_audit después.

npx @agentaeo/mcp-server → command not found Añade la bandera --yes: npx --yes @agentaeo/mcp-server. O instálalo globalmente: npm install -g @agentaeo/mcp-server.

Auditoría atascada en processing durante más de 10 minutos Llama a check_aeo_audit_status con el auditId. Si el status es failed, inicia una nueva auditoría. La vista previa gratuita suele tardar entre 3 y 5 minutos; el informe completo de pago entre 15 y 20 minutos.

Claude Desktop muestra el servidor MCP como desconectado Cierra completamente (Cmd+Q en Mac, no solo cerrar la ventana) y vuelve a abrir. Comprueba Settings → Developer → Local MCP servers.

nvm / node no encontrado Reemplaza "command": "npx" con la ruta completa: "/Users/tuusuario/.nvm/versions/node/v22.x.x/bin/npx".

Requisitos

• Node.js 18+

• Clave API de AgentAEO de agentaeo.com/agents

Desarrollo

git clone https://github.com/agentaeo/agentaeo-mcp-server
cd agentaeo-mcp-server
npm install
npm run build      # produces dist/index.js
node dist/index.js # test locally (set AGENTAEO_API_KEY first)

Publicar (requiere npm login y acceso a la organización @agentaeo):

npm publish --access public

Licencia

MIT — AIMetica Solutions LLP