Viomba MCP
O Viomba MCP expõe o conjunto de inteligência de anúncios com tecnologia de IA da Viomba como ferramentas MCP.
Documentação
Viomba MCP
O Viomba MCP traz previsão de atenção humana de alta precisão, geração criativa otimizada para atenção (para display e redes sociais) e análise de atenção em vídeo para o seu fluxo de trabalho com IA. Dê ao seu assistente um criativo, uma URL ou um vídeo — e receba dados de inteligência de desempenho de atenção específicos do contexto de mídia, mapas de calor e saídas pontuadas sem sair do seu cliente.
Construído com dados reais de rastreamento ocular
As previsões de atenção do Viomba são alimentadas por modelos neurais fundamentais treinados com uma década de dados de fixação ocular por infravermelho Tobii, coletados de forma consistente de usuários reais em ambientes reais de navegação em diversos mercados. Isso significa que as métricas de visualização e tempo de visualização refletem fixações genuínas no nível do anúncio no posicionamento — não proxies aproximados de visibilidade. A diferença importa: o infravermelho Tobii separa fixações verdadeiras de sacadas no nível da medição, e é por isso que os números do Viomba frequentemente diferem de outras ferramentas baseadas em proxies de atenção.
Ferramentas
Atenção e Análise
| Ferramenta | Descrição |
|---|---|
viomba_creative_prediction | Prever KPIs de atenção (percentual de visualização, tempo de visualização) para um anúncio display |
viomba_heatmap_prediction | Prever mapa de calor de gaze para um anúncio display |
viomba_ad_slicer | Dividir um criativo de anúncio em capturas de tela PNG com tempo |
Criativo
| Ferramenta | Descrição |
|---|---|
viomba_generate_creative | Iniciar um trabalho de geração de criativo de anúncio |
viomba_refine_creative | Iterar sobre um criativo gerado anteriormente |
viomba_check_generation | Consultar o status e recuperar resultados |
viomba_get_creative | Buscar um criativo gerado com HTML completo |
viomba_list_generations | Listar suas solicitações de geração de criativo |
viomba_cancel_generation | Cancelar um trabalho criativo pendente ou em execução |
viomba_generate_site_map | Gerar um mapa de site ponderado por atenção para um conjunto de domínios |
Vídeo
| Ferramenta | Descrição |
|---|---|
viomba_analyze_video | Analisar um vídeo quanto a atenção, eventos de áudio/vídeo e pontuação de sincronização AVS |
viomba_focus_prediction | Prever mapas de calor de atenção visual para um anúncio em vídeo |
viomba_request_upload | Obter uma URL de upload única no navegador para compartilhar um arquivo de vídeo local |
viomba_check_upload | Consultar a conclusão do upload; retorna um token utilizável como videoUrl |
Meta Marketing API
Conecte uma credencial Meta no painel do Viomba e, em seguida, gerencie sua biblioteca de anúncios real a partir do MCP.
| Ferramenta | Descrição |
|---|---|
viomba_list_meta_credentials | Listar credenciais Meta conectadas à sua conta Viomba |
viomba_set_meta_credential | Ativar uma credencial para esta sessão MCP |
viomba_list_meta_ad_accounts | Listar contas de anúncios Meta acessíveis à credencial ativa |
viomba_list_meta_ad_creatives | Listar criativos de anúncios dentro de uma conta de anúncios Meta |
viomba_get_meta_creative_prediction | Acionar ou consultar a previsão de atenção para um criativo de anúncio Meta |
Uso e Conta
| Ferramenta | Descrição |
|---|---|
viomba_my_usage | Estatísticas de uso e saldo de créditos para o seu cliente conectado |
viomba_history | Histórico paginado de chamadas de ferramentas |
viomba_request_detail | Inspecionar uma única chamada de ferramenta histórica (solicitação + resultado) |
viomba_tool_breakdown | Contagens de chamadas por ferramenta e latência |
viomba_fetch_image | Buscar um anexo de imagem retornado por uma chamada de ferramenta anterior |
Primeiros Passos
Adicione a URL do servidor ao seu cliente MCP e conecte-se — é isso. O fluxo OAuth é executado automaticamente na primeira conexão. Se você ainda não tem uma conta, será orientado durante o registro no momento do login.
Claude Desktop — abra Configurações → Conectores → Adicionar conector e cole
https://mcp.viomba.com/mcp. O prompt de login abre no seu navegador automaticamente.
Cursor / VS Code — adicione a URL nas configurações do servidor MCP e conecte-se. O prompt de login abre no seu navegador automaticamente.
n8n — adicione um nó MCP com a URL https://mcp.viomba.com/mcp e selecione
OAuth como o tipo de credencial.
Após o login, a conexão está ativa e seus créditos são vinculados automaticamente.
Token manual (avançado)
Se o seu cliente não suporta OAuth ou você precisa de um token de longa duração para automação, você pode emitir um Token de Acesso Persistente (PAT) no dashboard e passá-lo como um cabeçalho Bearer:
{
"mcpServers": {
"viomba": {
"type": "streamable-http",
"url": "https://mcp.viomba.com/mcp",
"headers": {
"Authorization": "Bearer <your-token>"
}
}
}
}
Clientes Compatíveis
- Claude Desktop
- Cursor
- VS Code (Copilot MCP)
- n8n
- Qualquer cliente que suporte transporte HTTP Streamable MCP (especificação 2025-11-25)
Preços
O uso é baseado em créditos — cada chamada de ferramenta deduz créditos da sua conta Viomba. Consulte viomba.com/pricing para tarifas.