Loading ToolBench
MCP server for sales analytics and business intelligence, providing tools for product recommendations, order tracking, payment summaries, delivery status, and financial reporting
VendasIA provides 10 well-scoped read-only tools with consistent naming (verb_noun pattern: top_produtos, receita_por_periodo, etc.) and descriptions that explain WHEN to use each tool. However, critical gaps reduce quality: (1) Input schemas are visible but lack formal enum constraints for status/date parameters, descriptions mention formats but schemas don't enforce them; (2) Output schemas are completely undocumented, LLMs cannot predict response structure or plan downstream calls; (3) Parameter descriptions are present but minimal (avg ~40 chars vs baseline 72 chars); (4) No error handling guidance, tools return generic error messages without recovery hints; (5) No pagination support despite tools returning lists (top_produtos, ticket_medio_por_cliente, etc.). All tools are READ_ONLY, reducing risk, but lack of structured output documentation and missing enums for constrained inputs are significant gaps for production use.
Retorna produtos com estoque abaixo do mínimo informado. Use quando o usuário perguntar sobre: - estoque baixo - produtos em falta - necessidade de reposição - alertas de estoque
Retorna o histórico completo de rastreamento de uma entrega. Use quando o usuário perguntar sobre: - onde está determinado pedido ou entrega - histórico de movimentação de uma entrega - última atualização de rastreio - status detalhado de uma entrega específica
Retorna quantidade e valor total de pedidos agrupados por status. Use quando o usuário perguntar sobre: - pedidos pendentes, pagos ou cancelados - situação geral dos pedidos Não requer parâmetros.
Retorna dados cadastrais e histórico de pedidos de um cliente. Use quando o usuário perguntar sobre: - quem é determinado cliente - histórico de compras de um cliente - pedidos de um cliente específico - perfil completo de um cliente
Retorna a receita de vendas agrupada por dia em um período. Use quando o usuário perguntar sobre: - faturamento por período - receita mensal ou diária - desempenho financeiro As datas devem estar no formato YYYY-MM-DD.
Output schemas completely undocumented. No tool documents what fields it returns, forcing LLMs to guess response structure and preventing downstream tool chaining.
Date parameters (receita_por_periodo) lack format enforcement. Description mentions YYYY-MM-DD but schema has no pattern constraint, LLMs may pass invalid dates.
status_entregas accepts free-form string for status parameter. Description lists valid values (Pendente, Em_separacao, etc.) but schema lacks enum constraint, LLMs may hallucinate invalid statuses.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Retorna produtos recomendados com base em um produto base. Usa métricas de market basket analysis: suporte, confiança e lift. Use quando o usuário perguntar sobre: - o que recomendar para clientes que compraram X - produtos frequentemente comprados juntos - cross-sell e upsell - recomendações inteligentes de produtos
Retorna todos os pagamentos registrados com forma, parcelas e valor. Use quando o usuário perguntar sobre: - pagamentos realizados - formas de pagamento mais usadas - pagamentos de um pedido específico - volume financeiro de pagamentos
Retorna entregas filtradas por status ou lista todas as entregas. Use quando o usuário perguntar sobre: - entregas pendentes, em trânsito ou entregues - quantas entregas estão atrasadas ou extraviadas - visão geral do status de entregas - entregas de um pedido específico Status disponíveis: Pendente, Em_separacao, Enviado, Em_transito, Entregue, Devolvido, Extraviado
Retorna os top 10 clientes com maior ticket médio de compra. Use quando o usuário perguntar sobre: - melhores clientes - clientes que mais gastam - ticket médio por cliente - clientes premium Não requer parâmetros.
Retorna os produtos mais vendidos em quantidade. Use quando o usuário perguntar sobre: - produtos mais vendidos - ranking de vendas - produtos populares - performance de produtos
No pagination support. Tools returning lists (top_produtos, ticket_medio_por_cliente, recomendacoes_produto) lack limit/offset/cursor parameters and total count in responses, large result sets will blow context windows.
Error handling returns generic messages without recovery guidance. BaseTool.erroResult() produces 'Erro ao executar {toolName}: {message}', no hint on whether to retry, what went wrong, or how to fix it.