compras_pesquisar_preco_material

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

Pesquisa preços praticados em compras de material (CATMAT) pelo governo. Endpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`. Para visão consolidada estatística (média/mediana no padrão IN 65/2021), use a tool composta `compras_pesquisar_precos_para_etp`. Cada item da resposta traz `precoUnitario`, `quantidade`, `dataCompra`, `niFornecedor`/`nomeFornecedor` e a UASG compradora — é **esta** a tool que devolve valor unitário para material. A `compras_detalhar_preco_material` NÃO devolve preço (ver a docstring dela). **⚠️ Quebra upstream corrigida em 2026-08-05**: entre ~2026-07 e 2026-08-05 esta tool respondia "Recurso nao encontrado" (HTTP 404). A SEGES trocou a assinatura de query da rota sem versionar: o parâmetro `codigoItemCatalogo` foi substituído pelo par `tipo` (enum `codigoItemCatalogo` | `codigoPdm`) + `codigo`. Como a API responde **404** — e não 400 — a parâmetros obrigatórios ausentes, a quebra se disfarçou de "rota removida". A rota nunca saiu do swagger oficial. Corrigido na v0.3.13; a assinatura de `compras_pesquisar_preco_servico` (rota 3) não mudou. Se voltar a devolver 404, a tool não levanta exception: devolve `_erro_upstream` com diagnóstico e alternativas. Cache 10 min.