O produto como um conjunto de tools.

O servidor MCP deixa um agente — Claude, uma IDE, qualquer coisa que fale o Model Context Protocol — ler seus relatórios e gerenciar prompts, tópicos, tags e marcas por tools tipadas.

Aponte um cliente para o endpoint e envie a mesma chave de projeto. Uma config genérica de cliente:

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

Autenticação e escopo

A chave é o escopo: nenhuma tool recebe id de projeto, e token de sessão não é aceito — esta superfície é só programática. Chave ausente ou desconhecida responde 401 antes de qualquer débito.

Leituras exigem a flag mcp; tools de escrita exigem também mcp_write. Os grupos de feature — actions, shopping, agent analytics, deliverables — exigem além disso a própria flag, exatamente como no REST.

O roster de tools

As tools de relatório recebem os mesmos request bodies dos endpoints REST do capítulo anterior, sem mudança.

Relatórios

As famílias de relatório, uma tool por família, mais os leitores de resposta única e fonte ú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

Listagens

Os rosters do projeto: prompts, tópicos, tags, marcas, o catálogo global de marcas, fan-out queries, motores e mercados.

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

Escritas de prompt

Criar, editar, ativar, arquivar e apagar prompts em lotes tudo-ou-nada. A ativação debita a cota uma vez; as coletas diárias nunca debitam. Exige mcp_write.

create_prompts · update_prompt · activate_prompts · archive_prompts · unarchive_prompts · delete_prompts

Escritas de taxonomia e marca

Tópicos, tags, marcas, sugestões de concorrente e o catálogo global. Exige 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 classificação

Overrides humanos de tipo de domínio e de página — a única superfície sem espelho REST. Exige mcp_write.

assign_domain_classification · unassign_domain_classification · assign_url_classification · unassign_url_classification

Actions

Ler o board de Actions e mover um card pelos seus estados. Exige a flag actions.

get_actions · set_action_state

Shopping

Os relatórios de shopping e o catálogo de produtos, leituras e escritas. Exige a 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

O registro de crawlers, as visitas de agentes e as auditorias de crawlability. Exige a flag agent_analytics.

list_bots · get_agent_visits · get_crawlability

Deliverables

A versão mais recente de cada deliverable em um card de Actions. Exige a flag deliverables.

get_deliverables

Erros e limites

O mesmo bucket de 200 por minuto por projeto se aplica, respondendo 429 com Retry-After. Dentro de uma tool, falhas aparecem como tool errors na forma status:detail — por exemplo 404:chat not found, ou 403:plan_flag_missing:mcp_write.