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/....

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` / `add_action_plan_step` / `edit_action_plan_step` / `complete_action_plan_step`	Checklist GEO
`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
`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.