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, 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 | | 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-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 / ARS: analyze_weekly_report / analyze_ars. Borradores GEO: research_geo_practices (debes buscar en la web) luego prepare_geo_content_brief. Scan: wait_for_visibility_scan.

No llames tools finas (get_visibility_summary, get_visibility_mentions, get_visibility_competitors, get_visibility_coverage, get_visibility_citations, get_weekly_report, get_action_plan, get_ai_sources) salvo que la salida compuesta no baste. get_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_visibility_scan | Encolar + esperar scan | | get_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 | | get_visibility_responses | Extractos de respuesta | | list_prompts / get_prompt / analyze_prompt | Preguntas rastreadas | | analyze_weekly_report / get_weekly_report | Briefing semanal | | analyze_action_plan / get_action_plan / update_action_plan | Checklist GEO | | analyze_ars / get_ars | ARS | | analyze_sources / get_ai_sources | Dominios citados | | get_brand_perception | Percepción de marca | | analyze_site | Auditoría acotada del dominio | | 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 | | get_visibility_coverage | Lectura fina de cobertura | | enqueue_visibility_scan / get_job | Scan manual | | start_onboarding_v2_scan / wait_for_onboarding_v2_report / get_onboarding_v2_report | Onboarding v2 |

Starter cubre Gemini y ChatGPT. Mercado por defecto: Brasil (pt-br / br).

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

File: claude_desktop_config.json.

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

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.

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.