> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstanswer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas MCP

> Referência das 16 ferramentas do servidor MCP First Answer para analisar a visibilidade da sua marca nas IAs.

O servidor MCP First Answer expõe **16 ferramentas somente leitura** que o assistente pode chamar para explorar marcas, prompts, concorrentes e fontes citadas. Use esta página como mapa do que cada ferramenta faz e como elas se encaixam.

<Note>
  **Comece aqui:** chame `list_brands` primeiro para obter os valores de `brand_id`. Quase todas as outras ferramentas exigem um `brand_id`.
</Note>

## Marcas

| Ferramenta    | Função                                                                                                                           |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `list_brands` | Lista as marcas dos seus workspaces (paginado). **Ponto de entrada** — use o `id` retornado como `brand_id` nas demais chamadas. |
| `get_brand`   | Detalhes completos de uma marca (descrição, destaques, site, país, idioma).                                                      |

## Grupos

| Ferramenta    | Função                                                                                                                                             |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_groups` | Lista **grupos** de prompts (categorias) da marca. Use o `group_id` para filtrar `get_dashboard`, `list_monitored_prompts` e `list_cited_sources`. |

## Dashboard

| Ferramenta      | Função                                                                                                                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_dashboard` | Métricas agregadas no período: contagem de prompts, taxas de menção, sentimento, concorrentes, **brands\_ranking**, prompts com melhor e pior desempenho. Filtros opcionais: `group_id`, `ai_model`. |

## Prompts monitorados

| Ferramenta                            | Função                                                                                                                                            |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_monitored_prompts`              | Lista prompts monitorados com estatísticas resumidas (menções, taxa de menção, sentimento, posições). Exige `brand_id`, `start_date`, `end_date`. |
| `get_monitored_prompt`                | Análise detalhada de **um** prompt: métricas e série **diária** da sua marca vs concorrentes.                                                     |
| `get_monitored_prompt_responses`      | **Texto integral** das respostas da IA (markdown/texto), menções, sentimento, citações e consultas de busca por resposta.                         |
| `get_monitored_prompt_citations`      | Domínios e URLs citados **naquele prompt**.                                                                                                       |
| `get_monitored_prompt_search_queries` | Consultas de busca que a IA executou ao responder aquele prompt.                                                                                  |

## Concorrentes

| Ferramenta                   | Função                                                                   |
| ---------------------------- | ------------------------------------------------------------------------ |
| `list_monitored_competitors` | Lista concorrentes acompanhados junto da marca (ids, nomes, descrições). |
| `get_monitored_competitor`   | Detalhe de um concorrente (`monitored_competitor_id`).                   |

## Fontes citadas

| Ferramenta                             | Função                                                                                                                       |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `list_cited_sources`                   | Lista **domínios** citados em todos os prompts da marca (impacto, contagens, modelos de IA). Opcional: `search`, `group_id`. |
| `list_cited_urls`                      | Ranking plano de **URLs** em todos os domínios; opcional: `search`, `monitored_prompt_id`.                                   |
| `get_cited_source_urls`                | URLs dentro de **um** domínio; precisa de `domain_id` de `list_cited_sources`.                                               |
| `get_cited_source_related_prompts`     | Quais prompts citam determinado **domínio**.                                                                                 |
| `get_cited_source_url_related_prompts` | Quais prompts citam uma **URL** específica (`domain_id` + `url_id`).                                                         |

**Fluxo típico:** `list_cited_sources` → `get_cited_source_urls` → `get_cited_source_url_related_prompts`.

## Parâmetros comuns

<Tip>
  * **Datas:** use `start_date` e `end_date` no formato **`AAAA-MM-DD`** quando forem obrigatórias.
  * **`ai_model` (opcional):** `chat_gpt`, `perplexity`, `bing_copilot`, `google_ai`, `gemini`, `grok`, `google_ai_mode`.
  * **Paginação:** ferramentas de lista aceitam `page` (padrão `1`) e `per_page` (padrão `100`, máx. `100`). Peça páginas seguintes quando houver mais resultados.
</Tip>

## Veja também

* [Introdução](/pt/mcp/introduction) — configurar Cursor, Claude e outros clientes MCP.