Cittati

Get Catalog Model

Ponto de entrada principal para o MCP. Retorna resumo do catalogo curado, incluindo fatos, dimensoes, bridges, medidas e relacoes. - read_first: summary.dataset_role_counts, summary.fact_datasets, summary.bridge_datasets, summary.dimension_datasets - prefer_curated_relationships: True

List Datasets

Lista os datasets disponiveis.

Get Catalog Schema

Obtem schema consolidado de todos os datasets.

Get Catalog Relationships

Obtem possiveis relacoes entre datasets por colunas compartilhadas.

Find Company Candidates

Busca empresas por nome para resolver filtros textuais antes de executar uma consulta analitica.

Find Line Candidates

Busca linhas por numero ou descricao, com opcional recorte por empresa.

Get Dataset Schema

Obtem o schema de um dataset.

Get Dataset Capabilities

Retorna as capacidades analiticas do dataset, incluindo filtros padrao de data, empresa e linha, o intervalo real de datas disponiveis (date_range.min/max) e o limite de linhas retornadas por requisicao (row_limits). - call_before_reporting_data_issues: Sempre chame esta ferramenta antes de concluir que faltam dados recentes ou que o dataset 'nao atualiza'. Compare a data de hoje com date_range.max: os dados sao atualizados uma vez por dia (ver refresh.frequency/expected_availability no catalog

Sample Dataset

Retorna uma amostra PARCIAL de linhas de um dataset, limitada a max_response_rows (tipicamente 1000, ver policy em get_mcp_configuration). NAO usar para contar, deduplicar ou agregar valores (ex.: contar quantos distintos existem) - o resultado sera incompleto sempre que o dataset tiver mais linhas que o limite. Para contagens exatas sobre o dataset inteiro use count_dataset_rows (total de linhas) ou get_column_stats (distintos, nulos, min/max); para agregacoes com quebra por dimensao use run_an

Count Dataset Rows

Conta o total de linhas de um dataset.

Get Column Stats

Calcula estatisticas EXATAS de uma coluna sobre o dataset inteiro, sem amostragem nem limite de linhas: total de linhas, nulos, valores distintos (distinct_values) e min/max. Preferir esta tool a sample_dataset sempre que a pergunta for do tipo 'quantos valores distintos existem' - sample_dataset traz no maximo max_response_rows linhas e pode subcontar.

Get Column Values

Retorna frequencia dos valores mais comuns de uma coluna.

Count Rows By Data

Agrega contagem de linhas por dia (coluna de data truncada) quando existir no dataset. Use order=desc para ver os dias mais recentes primeiro; o limit define quantos dias distintos sao retornados, nao o total de linhas.

Validate Analytic Query

Valida uma consulta no formato SQL-shaped (select/where/group_by/having/order_by/joins) antes da execucao, sem ler dados.

Run Analytic Query

Executa uma consulta analitica no formato SQL-shaped: select (colunas/agregacoes/metricas), where (filtro com and/or/not), group_by (derivado automaticamente se omitido), having, order_by e joins com outros datasets do mesmo projeto. Somente leitura. - no_required_date_filter: Nenhum dataset exige filtro de data (required_filters). Isso significa que uma agregacao (sum/count/avg/...) sem filtro de data no 'where' processa o HISTORICO INTEIRO do dataset, nao apenas um periodo recente - 'limit' e

Get Mcp Configuration

Returns the loaded MCP configuration summary.