> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# consultar_contexto_relatorio_saude

> Descobre o recorte possível (operadora, período e CNPJ) antes de montar um relatório

Prepara a seção de saúde de um relatório: cruza os contratos de saúde da empresa com as operadoras, períodos e CNPJs que têm dados publicados.

É uma ferramenta de **preparação**, não de resposta final. Ela responde "o que eu consigo analisar?", para depois você pedir a análise de fato com [`relatorio_sinistralidade`](/mcp/tools/saude/relatorio-sinistralidade).

Perguntas que ela resolve antes da análise:

* Qual operadora está ativa e quais têm dados?
* Dá para separar matriz e filial?
* Qual período posso analisar?

## Parâmetros

| Parâmetro | Obrigatório | Descrição                                                                                            |
| --------- | ----------- | ---------------------------------------------------------------------------------------------------- |
| `cnpj`    | Sim         | CNPJ da empresa, com ou sem pontuação.                                                               |
| `escopo`  | Não         | `empresa` (somente o CNPJ informado) ou `grupo` (consolidado de matriz e filiais). Padrão `empresa`. |

<Warning>
  **Ausência de métricas não significa ausência de contrato.** Uma empresa pode ter contrato vigente sem dado publicado no período. E nomes divergentes de operadora exigem confirmação antes de tratar como a mesma.
</Warning>

## Exemplos de perguntas

* "O que eu consigo analisar de saúde nessa empresa?"
* "Quais operadoras e períodos estão disponíveis para esse CNPJ?"