--- name: usar-ferramentas-minvest description: Pesquise mercados com fontes web citadas e calcule preço, margem, caixa, expansão, diluição, preparação para investimento e valuation nas ferramentas gratuitas MInvest; peça consentimento para pesquisa e explique limites. --- # Ferramentas gratuitas da MInvest Use `minvest-free-tools` para pesquisa de mercado com fontes públicas e cálculos financeiros iniciais, sem login e sem acessar dados de uma conta. ## Pesquisa de mercado - Para perguntas sobre tamanho, demanda, concorrentes, tendências ou oportunidades, use `pesquisar_mercado` para levantar fontes públicas atuais. Não confunda a pesquisa web com a calculadora TAM/SAM/SOM. - No dimensionamento TAM/SAM/SOM, peça ou preserve o campo opcional `horizonYears` quando conhecido. Sem horizonte, a parcela SOM não tem interpretação temporal. Mesmo com horizonte, o SOM é oportunidade anualizada no horizonte final, não receita acumulada, trajetória de crescimento ou previsão de vendas. Compare 2 a 4 conjuntos de premissas via `comparar_cenarios`; fontes dos percentuais SAM/TAM e SOM/SAM podem ser informadas como referências autodeclaradas, não verificadas. - Se a decisão estiver clara na conversa, preencha `decisionQuestion` sem perguntar de novo. Se o escopo estiver amplo demais e uma decisão mudaria materialmente a pesquisa, faça uma única pergunta curta; caso contrário, pesquise o tema geral. - Antes de chamar, explique que tema, região e os campos opcionais de público/decisão serão enviados à OpenAI para busca web e peça consentimento explícito. Passe `consentToOpenAIWebSearch: true` somente após confirmação; sem confirmação, não chame. - Informe que a chamada usa `store=false` para não guardar o estado da resposta, mas a configuração padrão da OpenAI pode manter logs de segurança por até 30 dias; ofereça a política de dados quando pertinente. - Envie somente tema, recorte de público e decisão em termos gerais. Nunca envie dados pessoais, informações de cliente, documentos, credenciais, segredos comerciais ou URLs privadas. Se a pessoa incluir algo identificável/confidencial, peça uma versão genérica. - Prefira `markdownAnswer` para manter citações inline clicáveis; se o cliente não renderizar Markdown, use `citationMarkers` e a lista `citations` para vincular os trechos. Separe fatos encontrados de inferências e preserve a data/região. Não invente TAM/SAM/SOM, preços, crescimento ou participação; valores quantitativos exigem fonte e período. - Informe que é uma pesquisa inicial e que estimativas de terceiros podem ser modeladas. Mostre lacunas e proponha uma validação primária pertinente, como entrevistas ou dados de venda. - A ferramenta limita o uso a três pesquisas por dia por IP. Respeite `retryAfterSeconds`; não repita automaticamente pesquisas que falharem. 1. Escolha a ferramenta que corresponde à pergunta: preço/margem, equilíbrio, capital de giro, fôlego de caixa, expansão, diluição, checklist ou valuation. 2. Primeiro use fatos que o usuário forneceu. Envie à ferramenta os valores conhecidos, mesmo que o conjunto esteja incompleto: ela retorna `status: needs_input`, preserva os valores e lista somente o que falta. Pergunte esses campos juntos, sem repetir perguntas já respondidas; nunca complete lacunas por conta própria nem use zero como marcador de desconhecido. 3. Para checklist, marque como concluído, em andamento ou pendente somente o que o usuário confirmar. Use `inProgressItems` quando o trabalho já começou mas ainda falta concluir; não o trate como pendência nem como conclusão. Só itens concluídos contam na autoavaliação; em andamento, pendentes e desconhecidos permanecem no denominador. `completionMetricStatus: self_reported_not_verified` identifica o percentual como autodeclarado; `no_status_reported` significa que nenhum status foi informado. Não o chame de percentual confirmado, auditoria ou prontidão. Para cada concluído, convide a informar opcionalmente um localizador genérico em `completedEvidenceReferences` (período, sistema ou título genérico); nunca solicite nem envie arquivo, nome, dado pessoal, link privado ou conteúdo confidencial. Uma referência é autodeclarada, não aberta nem verificada. O endpoint recusa alguns padrões óbvios, como URLs, e-mails, telefones e formatos comuns de credencial; isso não detecta todo dado confidencial, então mantenha o localizador genérico. Apresente `selfReportedCompletionPct` como autoavaliação, `completedEvidenceReferenceCoveragePct` e `evidenceReferencedCompletionPct` como cobertura de localizadores, sem chamar nenhum deles de prontidão. Todos os itens têm peso igual. Use `notApplicableItems` apenas quando o próprio usuário confirmar que um item está fora de escopo e informe uma justificativa breve em `notApplicableReasons` para cada um; não classifique como fora de escopo apenas por parecer prematuro. Itens sem status continuam no denominador e não são pendências. Se não houver status, apresente todos como não confirmados. Use `nextActions` apenas para pendências confirmadas, `inProgressActions` para continuar trabalho já iniciado, `confirmationsToResolve` para descobrir status e `evidenceReferencesToRequest` para oferecer a inclusão de localizadores ausentes. Percentuais não representam chance de investimento. 4. Para valuation, identifique o modelo e informe que a faixa é heurística e indicativa, sem comparáveis verificados. Mantenha a confiança como baixa: lucro e recorrência são autodeclarados e não substituem auditoria nem validação de múltiplos. SaaS e outros modelos recorrentes usam ARR (receita dos últimos 12 meses × percentual recorrente); serviços e comércio lucrativos usam EBITDA anual; demais modelos usam receita anual. Marketplace deve informar receita líquida/take rate, nunca volume bruto transacionado, e não precisa do percentual de recorrência. Explique a base exibida em `multipleBasis` e `multipleBaseValue`, a fórmula retornada em `multipleFormula`, o múltiplo-base, o fator de qualidade, o valor operacional antes da dívida e o equity central após dívida líquida. `methods` lista somente o cálculo executado; deixe claro que DCF, comparáveis, cohorts, ativos e marcos não foram calculados. Mostre também quais entradas foram coletadas para contexto, mas não alteraram aquele ramo. Os limites 0,72/1,38 são uma sensibilidade fixa, não intervalo estatístico. Sem base positiva, não apresente faixa como valuation zero. Siga a lista `needs_input` do MCP e nunca apresente um valor técnico neutro como informado pelo usuário. 5. Apresente os números, a fórmula, as premissas, a principal leitura e as limitações em linguagem simples. 6. Diferencie simulação de recomendação, laudo ou promessa de resultado. Não chame um cenário de viável só por ter VPL positivo. 7. Antes de chamar qualquer ferramenta de cálculo, informe que os valores numéricos serão enviados ao endpoint da MInvest para processamento. Antes de usar um atalho MCP (`prompts/get`), informe também que o objetivo e o contexto fornecidos serão enviados ao endpoint MInvest para montar a orientação; envie só contexto empresarial genérico e omita o argumento `contexto` quando não for necessário. A função não grava os inputs em banco de negócio nem os registra em log explícito; ainda assim, a chamada trafega pela infraestrutura Supabase e pelo provedor do agente, cujas próprias políticas de retenção se aplicam. Não envie nomes, contatos, documentos, URLs privadas, credenciais ou dados confidenciais de clientes. 8. Se uma chamada retornar `isError: true`, não conclua automaticamente que as premissas estão erradas. Classifique pelo `structuredContent.status`: `invalid_input` permite corrigir apenas os campos indicados; `tool_error` significa falha interna, sem resultado, e não deve gerar nova pergunta sobre os valores nem nova tentativa; `temporarily_unavailable` e `rate_limited` seguem as regras de espera do item 21. Se o status não estiver disponível ou for desconhecido, preserve as premissas e informe que o cálculo não foi concluído; não recalcule manualmente. 9. No fôlego de caixa, saldo inicial zero ou negativo significa ausência de reserva, mesmo se entradas mensais cobrirem as saídas; destaque isso e peça conferência do saldo bancário e das datas de vencimentos e recebimentos. Consumo mensal negativo significa geração líquida; mostre apenas os cenários que o usuário informou, sem chamar geração de consumo. Estresse de entradas e redução de saídas são opcionais; nunca presuma percentuais. Quando um cenário ficar abaixo de um mês, preserve a leitura equivalente em dias. Deixe claro que um fluxo mensal não prevê o dia exato de falta de caixa e que fôlego ilimitado nas premissas não garante liquidez. 10. Na viabilidade de expansão, informe as entradas mensais em regime e o limite necessário para VPL zero com as rampas selecionadas. Rampa linear zero significa regime integral desde o mês 1; os paybacks são medidos no fechamento de cada mês, e não há atraso inicial ou marcos irregulares. Se `valueStatus: not_reached_within_horizon`, explique que o investimento não foi recuperado até o último mês analisado; não transforme `null` em zero nem compare como se o payback fosse inexistente em qualquer prazo. Um VPL que arredonda para zero centavos é neutro, sem folga relevante; não o apresente como retorno positivo. 11. Na diluição, exija pre-money e aporte positivo para calcular post-money, participação do investidor e diluição proporcional geral; aporte zero não representa uma rodada. Pergunte a participação de um sócio apenas se o usuário quiser os efeitos individuais; não bloqueie a simulação geral se esse dado faltar. Diferencie a participação post-money do investidor, a retenção relativa dos sócios atuais e a perda do sócio informado em pontos percentuais. Esclareça que uma perda de 12 p.p. não significa diluição relativa de 12%; no aporte proporcional, cada sócio atual retém a mesma fração da participação anterior. Avise que option pool, SAFEs, conversíveis, venda secundária e direitos especiais não entram no modelo. 12. Em preço e margem, peça primeiro custo variável por unidade, taxas e margem desejada. O preço praticado é opcional e habilita a análise da margem atual; custos fixos e vendas mensais esperadas são opcionais como par e habilitam o rateio. Se só um campo de rateio for informado, pergunte apenas o outro; se ambos forem omitidos, calcule a referência sem rateio sem bloquear a resposta. Diferencie contribuição antes e depois do rateio; explique que o volume é uma premissa e que o cálculo não estima demanda, mix, descontos ou disposição a pagar. Preços de referência são arredondados para cima e têm piso de R$ 0,01; se o custo total for zero, explique que esse piso só representa o menor preço positivo em centavos e não recomenda um preço comercial. Se `valueStatus: no_break_even_with_nonpositive_contribution`, explique que contribuição nula ou negativa não cobre custos fixos por volume; não apresente `null` como zero ou como erro técnico. Se `valueStatus: no_fixed_costs_to_cover`, diga que zero unidades cobre apenas os custos fixos informados como zero e não comprova lucro ou sustentabilidade nem inclui despesas ausentes. Se `valueStatus: zero_fixed_costs_nonpositive_contribution`, destaque que cada venda tem contribuição nula ou negativa apesar de os custos fixos estarem em zero; zero unidades/faturamento cobre apenas despesas fixas nulas. Em `comparar_cenarios`, `absoluteChangeStatus: nonpositive_contribution` significa que pelo menos um cenário não deve ser tratado como vantagem econômica numérica. Se o volume de cobertura exceder a faixa de precisão, explique o limite e peça conferência das escalas; não invente um volume. 13. Em capital de giro, exija receita faturada a prazo, prazo de recebimento, caixa livre e reserva mínima. CMV mensal + dias de estoque são um bloco opcional; compras realmente a prazo + prazo médio de pagamento são outro. Se vier apenas um campo do bloco, pergunte somente o par ausente; não infira compras a partir do CMV. Blocos omitidos não são tratados como zero ou inexistentes: leia `calculationScope` para mostrar componentes incluídos, campos opcionais não informados e fatores fora do modelo; isso também vale por cenário em `comparar_cenarios`. Apresente a cobertura parcial e confirme se o usuário deseja incluir os componentes omitidos antes de tratar a necessidade como necessidade total de financiamento. Explique a decomposição dos componentes enviados, a reserva e o caixa livre, com mês simplificado de 30 dias; não distribua entradas e saídas por data. 14. No ponto de equilíbrio, se `valueStatus: no_break_even_with_nonpositive_contribution`, apresente a contribuição unitária calculada e explique que unidades e faturamento de equilíbrio estão indisponíveis: cada venda não cobre os próprios custos variáveis, mesmo com custos fixos zerados. Não trate `null` como zero. Peça revisão de preço, taxas e custo antes de comparar volumes. Se a ferramenta recusar um volume fora da faixa de precisão, não estime por conta própria; peça conferência de escala e valores. 15. Ao apresentar resultados MCP, use o texto `formatted` retornado para cada métrica junto com o valor, a fórmula e as limitações. Não recalcule resultados especiais nem trate prazo fora da faixa numérica como ausência de consumo; peça revisão das premissas quando a própria ferramenta sinalizar isso. 16. Ao comparar fôlego de caixa, não calcule diferenças numéricas se algum cenário não tiver limite nas premissas ou exceder a faixa representável. Apresente o aviso retornado e compare apenas os fluxos mensais que forem quantificáveis. 17. Em `comparar_cenarios`, confira `baselineValueStatus`, `valueStatus` e `analysisNotRun` em cada métrica. Se uma análise opcional não foi executada, informe isso como indisponível; só compare diferenças quando a métrica tiver sido calculada dos dois lados. `no_revenue_basis` significa que não há base para aquela faixa de valuation; mostre `formatted` e não converta `null` em zero. Quando uma métrica não foi executada em qualquer lado, o MCP marca `analysis_not_run` e omite os deltas absoluto e relativo. Se o estado for não comparável (por exemplo, `nonpositive_contribution`), deltas absoluto e relativo ficam indisponíveis; não os reconstrua a partir de valores técnicos. 18. Em métricas de fôlego no MCP, `value: null` acompanhado de `valueStatus: unbounded_under_assumptions` significa que as premissas não projetam consumo líquido; `valueStatus: exceeds_numeric_range` significa que o prazo excedeu a faixa numérica. Não trate `null` como zero nem tente reconstruir um número a partir do sentinela. Apresente `formatted`, o estado retornado e os fluxos mensais. 19. Se uma chamada retornar `isError: true` com `structuredContent.status: invalid_input`, use `code`, `field` ou `fields`, `constraint`, `minimum`, `maximum` e `integer` quando disponíveis para corrigir somente as premissas incompatíveis. Em comparações, use `scenarioName` para ajustar apenas a alternativa indicada. Preserve as premissas válidas; `status: tool_error` indica que o cálculo não foi concluído e não deve ser apresentado como resultado. 20. Quando o retorno tiver `status: needs_input` e `code: missing_required_inputs`, faça uma única pergunta concisa cobrindo os itens de `missingInputs`; preserve `providedInputs` e variantes por cenário. `calculated: false` significa que nenhum resultado foi produzido. Depois da resposta, repita a chamada com as premissas preservadas e os novos valores confirmados. 21. Se `structuredContent.status` for `rate_limited`, não tente novamente antes de `retryAfterSeconds`; preserve a chamada e as premissas confirmadas, e informe que nenhum cálculo foi feito (`calculated: false`). Se for `temporarily_unavailable`, aguarde brevemente e tente no máximo uma vez; sem recuperação, informe a indisponibilidade sem apresentar resultado. 22. Métricas monetárias são retornadas em centavos e resultados que excedem a precisão segura são recusados com `precision_limit`; não recalcule nem reduza a escala silenciosamente. Peça confirmação dos valores e unidades quando aparecer esse limite. 23. No valuation, os campos monetários numéricos e seus formatos usam BRL com precisão de centavos; preserve os valores recebidos em vez de arredondar a faixa para reais inteiros. 24. Na comparação de cenários, `absoluteChangeStatus: precision_limit` significa que a diferença monetária não pôde ser representada com segurança; mostre a mensagem retornada e peça conferência das unidades e escalas, sem recalcular o delta nem derivar uma variação relativa de delta indisponível. 25. No valuation, pergunte primeiro o modelo e depois somente os campos em `missingInputs`. Não peça lucro nem margem EBITDA para SaaS, marketplace ou deep tech. Para serviços e comércio, confirme lucro operacional e só solicite margem EBITDA quando ela definir o ramo; apresente `notUsedInputs` como campos fora do cálculo, sem tratá-los como premissas informadas. 26. Se a dívida líquida superar um limite da faixa operacional e o equity exibido ficar em zero, explique o aviso retornado e identifique quais limites foram truncados pelo piso. Zero não significa valor de liquidação nem confirma insolvência; não recalcule a faixa nem trate o modelo como conciliação de todos os passivos. 27. Em respostas de calculadoras, se `optionalAnalysesNotRun` listar análises, deixe claro que o resultado cobre apenas as premissas informadas e mostre os campos necessários para cada análise omitida. Em `comparar_cenarios`, faça isso por alternativa. Pergunte esses campos somente quando forem relevantes para a decisão; não transforme opcionais em requisitos nem descreva a análise omitida como zero ou conclusão completa. ## Comparar alternativas - Quando a pessoa estiver decidindo entre premissas, use `comparar_cenarios` com 2 a 4 cenários da mesma calculadora, inclusive dimensionamento de mercado e valuation indicativo. Nomeie a referência primeiro e as alternativas depois. - Mude apenas as premissas que diferenciam as alternativas; mantenha as demais iguais e explícitas. Envie ao comparador os valores conhecidos de cada cenário. Se retornar `status: needs_input`, pergunte somente os campos listados e associados a cada alternativa; preserve os valores informados e não calcule até completar todas. - Explique a variação absoluta e, quando aplicável, a variação relativa frente ao primeiro cenário. Para métricas percentuais, não trate a variação relativa como pontos percentuais. - A ferramenta compara resultados matemáticos; não escolhe a alternativa. Indique quais premissas precisam ser verificadas antes da decisão. - No valuation, compare faixa inferior/superior e múltiplo, mas mantenha modelo, método e confiança associados a cada cenário. Receita zero significa “sem base para faixa”, nunca valor zero. - Ao concluir uma calculadora operacional, inclua `suggestedNextStep` como validação específica das premissas da ferramenta. Não transforme essa checagem nem a estimativa em decisão automática.