MencionAI MCP

Use el servidor MCP de MencionAI para leer visibilidad en búsquedas de IA, encolar scans y briefar borradores GEO / social / blog desde Cursor, Claude, ChatGPT, Codex, Antigravity, n8n o cualquier cliente MCP.

El servidor MCP es un adaptador fino sobre la API pública v2. Usa tu API key y los mismos scopes que la API HTTP. Las tools no hablan con la base de datos.

URLs fáciles para agentes (redirigen a este sitio):

Las páginas canónicas están en www.mencionai.com/{locale}/docs/....

MCP para agencias

Funcionalidad prevista. El MCP para agencias todavía no está implementado. El endpoint propuesto es https://mcp.mencionai.com/agency/mcp. No es una instrucción de conexión operativa. Aún no se han publicado nombres de herramientas, scopes ni ejemplos de configuración para agencias.

La propuesta de plataforma de agencias ofrece una conexión autorizada para los clientes permitidos de la agencia. El endpoint actual de cliente, https://mcp.mencionai.com/mcp, sigue limitado a una organización. Indicar otro workspace no permite que la credencial acceda a la organización de otro cliente.

Conexión y permisos previstos

El MCP para agencias utiliza un consentimiento OAuth separado para la agencia, los clientes permitidos y los permisos de lectura o escritura. Cada operación selecciona explícitamente la organización del cliente y el workspace. El servidor comprueba la membresía actual, la relación entre agencia y cliente, el acceso al workspace, los permisos de la operación y los límites del plan del cliente.

Eliminar una relación con la agencia o una membresía debe bloquear las operaciones posteriores, incluso desde una conexión MCP abierta. Las credenciales de agencia son independientes de las de cliente y de administrador de la plataforma. Un dominio white-label del portal no concede acceso al MCP ni cambia su endpoint canónico.

Los ejemplos de configuración siguientes corresponden al MCP de cliente existente, no al servicio previsto para agencias. No sustituya su URL por el endpoint propuesto hasta que se publiquen la autenticación y las herramientas para agencias.

Operaciones previstas

Área	Cobertura prevista
Clientes y acceso	Listar y crear clientes autorizados, seleccionar workspaces y gestionar las invitaciones permitidas.
Planes y facturación	Consultar el plan y la facturación de cada cliente, solicitar capacidad a ventas e iniciar solo acciones de cobro aprobadas explícitamente.
Visibilidad	Reutilizar herramientas de cliente para prompts, scans, competidores, fuentes, planes de acción, informes, auditorías de sitios y tráfico.
Blogs y contenido	Crear y configurar blogs de clientes, importar o exportar contenido, consultar el calendario, editar borradores y seguir tareas de contenido.
MAIagent	Iniciar los flujos de agente disponibles para el cliente seleccionado, seguir tareas asíncronas y conservar las comprobaciones de créditos y cuotas del cliente.
White-label	Consultar y gestionar las operaciones permitidas de registro y verificación de dominios del portal cuando estén disponibles sus APIs.

Esta es la cobertura prevista, no un catálogo ejecutable. El catálogo publicado debe identificar las operaciones implementadas y las exclusiones. El MCP de agencia reutiliza servicios de cliente. No conecta recursivamente los MCP de cada cliente ni utiliza suplantación de administrador de la plataforma.

Flujo esperado y protecciones

El flujo previsto descubre los clientes permitidos, selecciona un cliente y un workspace, realiza la operación autorizada y sigue el identificador de tarea devuelto. Crear un borrador de blog o una tarea MAIagent no equivale a publicar un artículo.

Los scans y las operaciones de agente utilizan los créditos y las cuotas del cliente seleccionado, nunca el saldo de otro cliente ni la cuenta Starter gratuita de la agencia. Las llamadas que consumen créditos deben informar de su coste. Publicar, modificar la facturación, eliminar miembros y realizar operaciones destructivas exige aprobación explícita. Reintentar un resultado incierto debe conservar la clave de idempotencia original.

Hasta su publicación, los IDs existentes mcp y whitelabel de get_doc contienen estas secciones previstas. Todavía no existen los IDs de documentación agencies o mcp-agency.

Clientes

Cliente	Doc	id `get_doc`
Cursor	Cursor	`mcp-cursor`
Claude Desktop / Claude Code	Claude	`mcp-claude`
ChatGPT	ChatGPT	`mcp-chatgpt`
Codex	Codex	`mcp-codex`
Antigravity	Antigravity	`mcp-antigravity`
n8n	n8n	`mcp-n8n`

Settings → API Keys también tiene snippets.

Flujo preferido

Para setup: list_docs y luego get_doc (api, sdk, whitelabel, ars, mcp, mcp-cursor, mcp-claude, mcp-chatgpt, mcp-codex, mcp-antigravity, mcp-n8n, llms).

Visibilidad: list_workspaces → get_visibility_overview → explain_visibility_gaps / compare_competitors. Prompts: list_prompts → analyze_prompt. Plan: analyze_action_plan luego analyze_sources. Semanal / puntuación de recomendación de IA: analyze_weekly_report / analyze_ai_recommendation_score. Borradores GEO: research_geo_practices (debes buscar en la web) luego prepare_geo_content_brief. Tras un borrador de blog, llama validate_geo_content. Scan: wait_for_ai_search_scan.

No llames tools finas (visibility_summary, visibility_mentions, visibility_competitors, visibility_coverage, visibility_citations, get_weekly_report, get_action_plan, get_ai_sources) salvo que la salida compuesta no baste. visibility_responses requiere visibility:answers:read.

Tools

Tool	Propósito
`list_docs` / `get_doc`	Guías públicas
`get_visibility_overview`	Snapshot compuesto
`compare_competitors`	Ranking de rivales
`explain_visibility_gaps`	Prompts con rival y sin marca
`wait_for_ai_search_scan`	Inicia un scan de búsqueda en IA y espera
`visibility_series`	Series diarias
`get_traffic_summary` / `get_traffic_series`	Visitas de referidos IA
`get_organization` / `list_workspaces` / `get_workspace`	Org (`covered_providers`) y workspaces
`visibility_responses`	Extractos de respuesta
`list_prompts` / `get_prompt` / `analyze_prompt` / `add_prompt` / `update_prompt`	Preguntas rastreadas. `add_prompt` crea. `update_prompt` edita el texto o activa.
`submit_feedback`	Envía una nota de producto a MencionAI. `anonymous` opcional. No lista notas.
`analyze_weekly_report` / `get_weekly_report`	Briefing semanal
`analyze_action_plan` / `get_action_plan` / `edit_action_plan_step` / `complete_action_plan_step`	Acciones de MAI (los pasos nuevos solo vienen del chat MAI)
`analyze_ai_recommendation_score` / `get_ai_recommendation_score`	Puntuación de recomendación de IA
`analyze_sources` / `get_ai_sources`	Dominios citados
`get_brand_perception`	Percepción de marca
`analyze_site`	Auditoría acotada del dominio
`identify_site_stack`	Detecta CMS, host y framework del dominio
`list_site_pages`	Todas las URL del sitemap (blog, contenido, producto), incluso un blog de 100 páginas
`list_content_hosts`	Apex, www, blog, blog de la plataforma, hosts enlazados en la homepage y labels docs/content/help con sitemap
`site_check_llms_txt` / `site_check_ai_crawler_robots` / otras tools `site_check_*`	Una comprobación pública de la homepage en cualquier dominio. No exige workspace
`get_crawl_insights` / `ingest_crawl_insights_csv`	Hits de crawler; pedir CSV o Vercel Log Drain si vacío
`get_project_settings`	Ajustes del workspace
`research_geo_practices`	Tarea de investigación (web search)
`prepare_geo_content_brief`	Brief de blog / LinkedIn / Instagram / X / Facebook
`validate_geo_content`	Valida un borrador de blog del cliente contra el contrato de citación GEO/AEO/SEO/AIO
`start_content_job`	Inicia un job de borrador para un paso de contenido del Plan de acción. Devuelve el id y el estado. No publica.
`connect_blog_domain`	CNAME de `blog.{domain}`. El cliente lo agrega en el proveedor del dominio. La dirección de la tienda sigue igual.
`connect_traffic_snippet`	Script público de seguimiento para el `<head>` del sitio. Crea una clave solo cuando `create` es true.
`create_post_with_agent`	Inicia el agente de contenido para un paso de contenido del Plan de acción. Gasta 2 créditos y ocupa el siguiente horario diario libre.
`get_blog_health`	Verificaciones del blog: dominio, SSL, publicación, acceso, posts, palabras clave, SEO, GEO, AIO, AEO, schema, tema, robots.txt, sitemap.xml y llms.txt.
`get_blog_settings`	Estilo, fuente, fuente subida, colores, logo, autor, redes, píxeles, tres CTAs, pie, categorías, etiquetas, horarios y política de publicación.
`update_blog_settings`	Cambia cualquiera de esos campos. Una fuente de la lista quita el archivo subido, salvo que `font_file_url` vaya en la misma llamada. No publica.
`set_blog_appearance`	Cambia la plantilla (magazine, editorial, index, gallery), el tema (ink, paper, signal, aurora) y la fuente. No publica. Un espacio que refleja el blog de MencionAI aplica allí la misma plantilla, los mismos colores y la misma fuente. El fondo del sitio se mantiene.
`import_blog_content`	Importa un archivo de WordPress, Blogger o RSS como borradores. El mismo origen se omite en una importación siguiente. No publica y no gasta créditos.
`export_blog_content`	Descarga los posts de este espacio en WordPress, Blogger o RSS. El archivo coincide con el importador.
`upload_blog_font`	Sube un archivo woff2, woff, ttf u otf (máx. 2MB) y lo usa en el blog.
`upload_blog_logo`	Sube un logo png, jpeg o webp (máx. 5MB).
`get_content_calendar`	Posts programados y publicados, con día, hora, estado y status.
`get_content_job`	Un job: estado, asunto, slug, agenda, secciones, fuentes, enlaces, llamadas y la imagen.
`update_content_post`	Edita un post por sección: texto, fuentes, llamada e imagen. Una imagen por artículo. No publica.
`reschedule_content_job`	Mueve un borrador no publicado a otro día y hora. Un día pasado o un horario ocupado se rechaza.
`retry_content_job`	Reanuda un job fallido o bloqueado. No vuelve a debitar créditos.
`get_blog_telemetry`	Tráfico de los posts publicados: impresiones, directo, SEO, IA, clics en el CTA, total, CTR y qué IAs visitaron.
`visibility_coverage` / `visibility_citations` / `visibility_summary` / `visibility_mentions` / `visibility_competitors`	Lectura fina
`enqueue_visibility_scan` / `get_job`	Scan manual
`start_onboarding_v2_scan` / `wait_for_onboarding_v2_report` / `get_onboarding_v2_report`	Inicia, espera y lee el scan de búsqueda en IA del onboarding

research_geo_practices devuelve consultas de búsqueda en vivo y docs oficiales por modelo para cada motor que MencionAI puede rastrear (ChatGPT, Gemini, Google AI Studio, Claude, Grok, DeepSeek, Perplexity). Los borradores para el cliente deben nombrar solo los modelos del plan. El LLM host debe buscar en la web, descargar must_fetch_urls y revisar el dominio del workspace y perfiles sociales. Luego prepare_geo_content_brief arma gaps de visibilidad, pasos GEO abiertos y el mismo contrato de citación usado en las páginas first-party de MencionAI (Fuentes, FAQ, Lectura relacionada en el dominio de la marca). Después de escribir, validate_geo_content devuelve missing_obligations y falla cerrado. Mercado por defecto: Brasil (pt-br / br). No inventes tokens de crawler para Grok o DeepSeek.

Starter cubre Gemini y ChatGPT en la copia del cliente.

Cursor

File: .cursor/mcp.json (or Cursor MCP settings).

Stdio

{
  "mcpServers": {
    "mencionai": {
      "command": "npx",
      "args": ["-y", "@mencionai/mcp"],
      "env": {
        "MENCIONAI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Hosted

{
  "mcpServers": {
    "mencionai": {
      "url": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

Claude

Claude Desktop

Abre Settings → Connectors, añade un conector personalizado y pega:

https://mcp.mencionai.com/mcp

Claude ejecuta OAuth 2.1 automáticamente. No hace falta una API key ni editar claude_desktop_config.json.

Gestiona los grants en MencionAI en Settings → Connected apps.

Claude Code

Project .mcp.json, or:

claude mcp add mencionai -- npx -y @mencionai/mcp

Set MENCIONAI_API_KEY in the MCP server environment. Hosted:

{
  "mcpServers": {
    "mencionai": {
      "url": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

ChatGPT

Instala MencionAI desde la pestaña Plugins. Deja el registro en registro dinámico.

Pestaña Plugins

Abre Plugins.
Busca MencionAI e instálalo.
Cuando se ejecute una tool, entra en www.mencionai.com y autoriza la app.
Deja el registro en registro dinámico.

Hasta que el listado público esté disponible, instala el marketplace de este repositorio. El catálogo es .agents/plugins/marketplace.json y el paquete es plugins/mencionai. Reinicia la app de escritorio de ChatGPT, abre Plugins, elige ese marketplace e instala MencionAI.

Respaldo en modo desarrollador

Úsalo cuando el listado todavía no esté en el directorio.

Abre Settings → Security and login y activa Developer mode.
Abre Plugins, elige + y pega esta URL:

https://mcp.mencionai.com/mcp

La primera vez que se ejecute una tool, entra en www.mencionai.com y autoriza la app.
Deja el registro en registro dinámico.

Administra los grants en Settings → Connected apps.

URL corta: docs.mencionai.com/mcp/chatgpt. Volver al hub MCP.

Codex

File: ~/.codex/config.toml (or project .codex/config.toml on a trusted repo).

The table name is mcp_servers, not mcpServers.

Stdio

[mcp_servers.mencionai]
command = "npx"
args = ["-y", "@mencionai/mcp"]

[mcp_servers.mencionai.env]
MENCIONAI_API_KEY = "YOUR_API_KEY"

Hosted

[mcp_servers.mencionai]
url = "https://mcp.mencionai.com/mcp"
bearer_token_env_var = "MENCIONAI_API_KEY"

Verify with codex mcp list or /mcp in the TUI.

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

Antigravity

Global file: ~/.gemini/config/mcp_config.json. Workspace file: .agents/mcp_config.json.

Stdio

{
  "mcpServers": {
    "mencionai": {
      "command": "npx",
      "args": ["-y", "@mencionai/mcp"],
      "env": {
        "MENCIONAI_API_KEY": "${MENCIONAI_API_KEY}"
      }
    }
  }
}

Hosted

Antigravity remote servers use serverUrl, not url.

{
  "mcpServers": {
    "mencionai": {
      "serverUrl": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MENCIONAI_API_KEY}"
      }
    }
  }
}

Gemini CLI leftover

Older Gemini CLI still reads mcpServers inside ~/.gemini/settings.json. Prefer the Antigravity mcp_config.json path above.

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

n8n

n8n is an HTTP MCP client. It does not spawn npx @mencionai/mcp. Do not use n8n’s MCP Server Trigger for MencionAI. That node exposes n8n as a server.

Use MCP Client Tool on an AI Agent, or the standalone MCP Client node.

Node fields (v1.2+)

Field	Value
Server Transport	HTTP Streamable (`httpStreamable`)
MCP Endpoint URL / Endpoint	`https://mcp.mencionai.com/mcp`
Authentication	Bearer Auth
Token	Settings API key (`mak_live_…` or `mak_test_…`)

Older node versions default to SSE. Hosted MencionAI MCP is Streamable HTTP. Pick HTTP Streamable.

Self-hosted n8n only needs outbound HTTPS to mcp.mencionai.com. Optional: MCP OAuth2 against the same URL (discovery via WWW-Authenticate).

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.