El producto como un conjunto de tools.

El servidor MCP permite a un agente — Claude, un IDE, cualquier cosa que hable el Model Context Protocol — leer tus informes y gestionar prompts, temas, tags y marcas mediante tools tipadas.

Apunta un cliente al endpoint y envía la misma clave de proyecto. Una config genérica de cliente:

{
  "mcpServers": {
    "be-mentioned": {
      "type": "http",
      "url": "https://app.bementioned.ai/mcp",
      "headers": { "X-API-Key": "bm_your_key_here" }
    }
  }
}

Autenticación y alcance

La clave es el alcance: ninguna tool recibe un id de proyecto, y un token de sesión no se acepta — esta superficie es solo programática. Una clave ausente o desconocida responde 401 antes de debitar nada.

Las lecturas requieren la flag mcp; las tools de escritura requieren además mcp_write. Los grupos de función — actions, shopping, agent analytics, deliverables — requieren además su propia flag, exactamente igual que por REST.

El roster de tools

Las tools de informes reciben los mismos request bodies que los endpoints REST del capítulo anterior, sin cambios.

Informes

Las familias de informes, una tool por familia, más los lectores de respuesta única y fuente única.

get_overview · get_brand_report · get_timeseries · get_matrix · get_rankings · get_prompt_report · get_domain_report · get_url_report · get_chats · get_chat · get_url_content

Listados

Los rosters del proyecto: prompts, temas, tags, marcas, el catálogo global de marcas, fan-out queries, motores y mercados.

list_prompts · list_topics · list_tags · list_brands · list_global_brands · list_search_queries · list_model_channels · get_markets

Escrituras de prompt

Crear, editar, activar, archivar y borrar prompts en lotes todo-o-nada. La activación debita la cuota una vez; las recolecciones diarias nunca debitan. Requiere mcp_write.

create_prompts · update_prompt · activate_prompts · archive_prompts · unarchive_prompts · delete_prompts

Escrituras de taxonomía y marca

Temas, tags, marcas, sugerencias de competidor y el catálogo global. Requiere mcp_write.

create_topic · update_topic · delete_topic · create_tag · update_tag · delete_tag · create_brand · update_brand · delete_brand · accept_competitor_suggestion · reject_competitor_suggestion · create_global_brand

Overrides de clasificación

Overrides humanos de tipo de dominio y de página — la única superficie sin espejo REST. Requiere mcp_write.

assign_domain_classification · unassign_domain_classification · assign_url_classification · unassign_url_classification

Actions

Leer el board de Actions y mover una card por sus estados. Requiere la flag actions.

get_actions · set_action_state

Shopping

Los informes de shopping y el catálogo de productos, lecturas y escrituras. Requiere la flag shopping.

get_shopping_summary · get_shopping_trend · get_shopping_attributes · list_shopping_demand · list_shopping_performance · list_shopping_queries · list_products · list_merchants · list_categories · create_product · update_product · delete_product

Agent analytics

El registro de crawlers, las visitas de agentes y las auditorías de crawlability. Requiere la flag agent_analytics.

list_bots · get_agent_visits · get_crawlability

Deliverables

La versión más reciente de cada deliverable en una card de Actions. Requiere la flag deliverables.

get_deliverables

Errores y límites

Se aplica el mismo bucket de 200 por minuto por proyecto, respondiendo 429 con Retry-After. Dentro de una tool, los fallos aparecen como tool errors con la forma status:detail — por ejemplo 404:chat not found, o 403:plan_flag_missing:mcp_write.