Visão geral das 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
list_brands, get_visibility, get_visibility_trend, compare_ais
Prompts
list_prompts, list_monitored_prompts, list_segments, get_prompt_deep_dive, get_recent_responses, suggest_prompts
Concorrentes
get_competitors_overview, list_competitors
Fontes
get_top_sources, get_top_urls, find_prompts_citing_url, get_search_queries, get_channel_presence
Tráfego e site
get_site_traffic, list_brand_pages
Conteúdo e auditoria
list_brand_blog_posts, get_blog_post, suggest_articles, check_audit_status, get_page_audit_result
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_idstring (UUID)obrigatório
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.- periodenum
Janela de tempo por atalho:
today,7d,14d,30d,90d,this_monthoulast_month. O padrão é7d, com exceção de algumas tools que usam30d(indicado em cada uma). É ignorado quandostart_dateeend_datesão enviados.- start_date / end_datestring (AAAA-MM-DD)
Janela exata, com os dois dias inclusos. Vão sempre juntos. A janela pode ter no máximo 366 dias.
- llm_providerstring
Limita a consulta a uma IA:
ChatGPT,GoogleAI(o AI Mode do Google),Gemini,Grok,PerplexityouCopilot. Sem ele, os números somam todas as IAs.- segment_idstring (UUID)
Limita a consulta aos prompts de um segmento. Os ids vêm de
list_segments.- brand_prompt_idstring (UUID)
Um prompt monitorado específico. Os ids vêm de
list_promptsoulist_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.