compras_uasg_listar

io.github.opedrosoares/mcp-compras · Verify this server

Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo. **✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool devolvia "endpoint indisponível" e a documentação atribuía o 404 a um bug de roteamento da SEGES. O diagnóstico estava errado: faltava o parâmetro obrigatório `statusUasg`, e esta API responde **404** (não 400) quando um obrigatório não vem. Enviando o parâmetro, a rota devolve 200 com ~22 mil UASGs ativas. O filtro `ativo` alimenta `statusUasg`; quando não informado, a tool assume `True` (ativas), que é o caso de uso dominante. **Paginação**: o upstream ignora `tamanho_pagina` nesta rota e devolve páginas fixas de 500 registros — `_total_paginas` reflete a paginação real do servidor, não o tamanho pedido. **`codigo_orgao` corrigido em 2026-09-07.** O filtro era enviado como `codigoOrgao`, chave que esta rota não declara: a resposta vinha com as 22 mil UASGs do país, sem aviso, como se o órgão não tivesse recorte nenhum. Agora a tool resolve o código para o CNPJ do órgão e filtra por `cnpjCpfOrgao` — órgão 26246 (UFSC) devolve 3 UASGs. Custa uma chamada extra a `/modulo-uasg/2_consultarOrgao`. Duas ressalvas, ambas tratadas aqui: **CNPJ não identifica órgão** (599 dos 11.957 órgãos ativos compartilham CNPJ com outro — as 7 unidades do CNPJ da Polícia Federal devolviam 110 UASGs, das quais só 8 do órgão pedido), então o resultado é reduzido client-side pelo `codigoOrgao` de cada UASG; e **39 órgãos não têm CNPJ próprio** (o upstream grava `"0"`), caso em que a tool devolve lista vazia com `_aviso_filtro` em vez de um recorte falso. Cache 24h.