v0.2.0 do MCP brasileiro de licitações — agora com agregação temporal e comparação de períodos

Tudo bem? Há 3 dias liberei o primeiro MCP brasileiro pra licitações públicas (Lei 14.133/PNCP) e tive a chance de
receber feedback excelente da comunidade aqui no TabNews — virou o canal hero do lançamento (44% do tráfego veio daqui
nas primeiras 48h, valeu demais).

Aproveitei pra puxar duas releases nesses 3 dias:

v0.1.3 — fix de um bug 422 que o @rldourado reportou em <24h: o PNCP rejeita janelas
de data > 365 dias com mensagem genérica HTTP 422, e a tool não propagava o body do erro. Reproduzi, corrigi, fechei a
issue em <4h. Validação client-side agora + descrição da tool documenta o limite.

v0.2.0 — Fase 7 do roadmap, transforma o servidor de "lookup transacional" em "analítico". Duas tools novas que
respondem perguntas que antes eram inviáveis:

• aggregate_licitacoes_por_periodo — série temporal de contagem (e opcionalmente valor) sobre janela de até 5 anos, com
  bucketing por dia/semana/mês/ano. Filtros: modalidade, UF, município, CNPJ, esfera de governo.
• compare_periodos — compara dois períodos lado a lado e retorna delta absoluto + percentual.

Caso de uso real

Pergunta que motivou: "Houve antecipação de licitações em junho/2024 (pré-vedação eleitoral) comparada a 2025?". A
vedação do Art. 73, VI, "a" da Lei 9.504/97 cria, em tese, uma corrida de empenho 30-60 dias antes. Antes dessa versão,
responder isso exigia paginar dezenas de milhares de registros (32.921 só de Pregão Eletrônico em jun/2024). Inviável.

Agora, um único call:

{
  "periodoA": {"label": "Jun/2024 eleitoral", "dataInicial": "20240601", "dataFinal": "20240630"},
  "periodoB": {"label": "Jun/2025 controle",  "dataInicial": "20250601", "dataFinal": "20250630"},
  "modalidades": [6, 8, 9]
}

Resultado validado contra PNCP ao vivo: Jun/2024 = 112.505 publicações | Jun/2025 = 115.436 | +2,6% em 2025.

Ou seja, nenhuma antecipação mensurável em junho do ano eleitoral quando se compara com o ano de controle pós-Lei 14.133
plena. O sinal "explosão de 2023 vs 2024" que apareceria em contagem é confundido pela adoção do PNCP (que só virou
obrigatório em 30/12/2023).

Limitação que ainda precisa ser endereçada

A análise por contagem é sinal fraco — antecipação política se manifesta em valor empenhado, não em número de editais. O
modo valorEstimadoTotal + valorHomologadoTotal existe mas força paginação completa (cap em 50 páginas × 200 buckets). E o
 filtro por esfera municipal (que seria o sinal mais limpo, já que a eleição era municipal) também força o caminho lento.

Quem quiser brincar com isso ou puxar TCEs estaduais (que têm execução orçamentária, não só publicação), abri 3 good 
first issues (https://github.com/Licinexus/licinexus-mcp/labels/good%20first%20issue) — uma delas é justamente um adapter
 pro TCE-SP.

- Repo: https://github.com/Licinexus/licinexus-mcp
- npm: npx -y @licinexusbr/mcp
- MIT, sem auth, sem cadastro

Feedback é bem-vindo.