# Visão geral das tools (/mcp/tools)

As 28 consultas do Promptado MCP e os parâmetros que se repetem em quase todas.

A IA escolhe sozinha quais tools usar a partir da sua pergunta. Esta referência serve pra entender o que cada uma consegue responder e pra quem quer chamar o servidor direto.

Todas as tools são só leitura.

## Por assunto

[Visibilidade](/mcp/tools/visibilidade): `list_brands`, `get_visibility`, `get_visibility_trend`, `compare_ais`

[Prompts](/mcp/tools/prompts): `list_prompts`, `list_monitored_prompts`, `list_segments`, `get_prompt_deep_dive`, `get_recent_responses`, `suggest_prompts`

[Concorrentes](/mcp/tools/concorrentes): `get_competitors_overview`, `list_competitors`

[Fontes](/mcp/tools/fontes): `get_top_sources`, `get_top_urls`, `find_prompts_citing_url`, `get_search_queries`, `get_channel_presence`

[Tráfego e site](/mcp/tools/trafego): `get_site_traffic`, `list_brand_pages`

[Conteúdo e auditoria](/mcp/tools/conteudo): `list_brand_blog_posts`, `get_blog_post`, `suggest_articles`, `check_audit_status`, `get_page_audit_result`

[Google Search Console](/mcp/tools/google-search-console): `gsc_top_queries`, `gsc_top_pages`, `gsc_page_queries`, `check_url_indexed`

## Parâmetros comuns

Estes parâmetros aparecem em várias tools e funcionam sempre do mesmo jeito.

- **brand_id**: A marca consultada. Obrigatório em todas as tools, menos `list_brands`, que é justamente de onde ele vem. Uma marca fora do seu acesso é recusada.

- **period**: Janela de tempo por atalho: `today`, `7d`, `14d`, `30d`, `90d`, `this_month` ou `last_month`. O padrão é `7d`, com exceção de algumas tools que usam `30d` (indicado em cada uma). É ignorado quando `start_date` e `end_date` são enviados.

- **start_date / end_date**: Janela exata, com os dois dias inclusos. Vão sempre juntos. A janela pode ter no máximo 366 dias.

- **llm_provider**: Limita a consulta a uma IA: `ChatGPT`, `GoogleAI` (o AI Mode do Google), `Gemini`, `Grok`, `Perplexity` ou `Copilot`. Sem ele, os números somam todas as IAs.

- **segment_id**: Limita a consulta aos prompts de um segmento. Os ids vêm de `list_segments`.

- **brand_prompt_id**: Um prompt monitorado específico. Os ids vêm de `list_prompts` ou `list_monitored_prompts`.

## O período que foi lido

As tools que trabalham com período devolvem um campo `periodo_consultado` com `start`, `end`, `label` e `period`: a janela que foi realmente lida. Se a sua pergunta pediu uma janela e a resposta mostra outra, é esse campo que conta.

## Somando IAs

Quando `llm_provider` não é enviado, uma conversa por IA entra na conta. Um prompt rodado em 4 IAs vira 4 conversas. Por isso, ao comparar números de tools diferentes, use o mesmo filtro de IA (e de segmento) em todas. Senão os denominadores não batem.

## Listas

Tools que devolvem uma lista trazem os itens no campo `itens`, junto com os totais e o período consultado.