MCP Compras.gov.br
This server turns Brazil's Compras.gov.br public procurement ecosystem into MCP tools for planning, price research, supplier due diligence, contract management, and data analysis.
Catalogs: search/list CATMAT and CATSER items, groups, and classes; get item details.
Price research: aggregate practiced prices following IN SEGES/ME 65/2021 (median, mean, IQR outlier discarding) for ETPs/TRs.
Procurement planning: query PGC/PCA plans, list contracting data per modality/period, and compare periods/trends.
ARPs (price registration records): list, consult, check balances, adhesions, participating units, and search by object.
Contracting/procurement: search Lei 14.133 and legacy procurements, RDC, dispensas, and list contract detailswith items/results.
Contracts: list/consult federal contracts, plus Comprasnet sub-records → aditivos, faturas, ocorrências, responsáveis, empenhos, publicações, cronograma, garantias.
Suppliers: full supplier profile (cadastro + Receita CNPJ data + sanctions + impediments), sanctions checks (CEIS/CNEP/CEPIM/CEAF/leniência), and contract/item lookups.
PNCP: search cross-federation contracts, atas, PCAs, modalidades, orgão units, and contract items/results.
Organizations: list/search/consult UASGs and órgãos, with local search workaround.
Indicators & analytics: API usage indicators, time-series and period-comparison aggregation.
Support aux: healthcheck/diagnostico, version info, reference resources (modalidades, esferas, glossário), and discovery tools for prompts/resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Compras.gov.br check sanctions for CNPJ 12.345.678/0001-99"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Compras.gov.br
MCP server that brings together in a single package the public APIs of the Compras.gov.br ecosystem, aimed at analysts and technicians in the areas of procurement planning and contract execution.
Supports the preparation of:
Preliminary Technical Studies (ETP)
Terms of Reference (TR)
Price research in the IN SEGES/ME 65/2021 standard
Checking supplier sanctions (CEIS, CNEP, CEAF)
Analysis of price registration minutes (ARP) for adherence (piggybacking)
Inter-agency benchmarking via the National Public Procurement Portal (PNCP)
Covered APIs (v1)
API | Base URL | Authentication |
Dados Abertos Compras |
| public |
PNCP — National Portal |
| public |
Transparency Portal (CGU) |
| free key |
Comprasnet Contracts |
| public (routes |
⚠️ Operational notice
Family
/modulo-uasg/*dead on Dados Abertos upstream: confirmed via direct probe in 2026-05 —1_consultarUasg,2_consultarOrgaoand CSV variants return HTTP 404 ("Resource not found") despite being listed in the official swagger. SEGES server bug with no possible fix via MCP. The 5 affected tools (compras_uasg_listar/_consultar/_buscar+compras_orgao_listar/_consultar) detect the 404 and return an educational payload with alternatives:compras_pncp_orgao_unidades(cnpj)to resolve units by CNPJ (stable, may take 10-30s), orcompras_contrato_comprasnet_por_uasg(uasg)to list UGs with active contracts.UASG filter in
/modulo-legado/*: auctions and bids have a confirmed Hibernate bug upstream — the swagger documentsco_uasg/uasgbut the attribute does not exist in the view model. The parameters were removed from the toolscompras_legado_pregoes_listarandcompras_legado_licitacoes_listar; to filter by UASG, do it client-side on the return.Transparency Portal (CGU): the CGU server is protected by AWS WAF "Human Verification" that can block API calls even with a valid key (HTTP 405 + HTML page). When this occurs, all tools
compras_sancao_*+ the compositecompras_checar_sancoes_fornecedor* the sanction branches incompras_perfil_fornecedor_completowill return an error. It is an upstream problem — there is no fix on the MCP side.Comprasnet
/api/contrato/ug/{uasg}: the endpoint does not support pagination and returns the complete list in a single response (may exceed 1 MB). The toolcompras_contrato_comprasnet_por_uasgapplies client-side slicing with full payload cache to avoid flooding the LLM.CATMAT broken textual search: the
descricaofilter (and variantsnome,termo,q) of/modulo-material/4_consultarItemMaterialreturns the entire CATMAT universe (~340k items). Use structural filters viacompras_catmat_listar_grupos→_listar_classes→_buscarwithcodigo_grupo/codigo_classe. The tool emits_aviso_filtrowhen it detects the entire universe.
Related MCP server: licinexus-mcp
Installation
Desktop Extension (.mcpb) — recommended for Claude Desktop
python build_mcpb.py # gera dist/compras.mcpb
open dist/compras.mcpb # Claude Desktop instalaLocal (development)
uv sync
uv run compras-mcpRemote (Railway via Docker)
railway login && railway link
railway add redis # cache compartilhado
railway variables --set "TRANSPARENCIA_API_KEY=..."
railway up
railway domain # https://mcp-compras.up.railway.app/mcpConfiguration
Free registration of the Transparency key: https://api.portaldatransparencia.gov.br/api-de-dados/cadastrar-email
See .env.example for all configurable variables (timeouts, cache TTLs, base URLs).
Tools (85 total)
Grouped by functional domain:
Domain | Tools | Coverage |
Composite (agent) | 5 |
|
Catalog (CATMAT/CATSER) | 7 | Groups/classes/items, textual search |
Price research | 4 | Material/service, detail by purchase |
Planning (PGC + PCA) | 8 | PGC SISG, PCA PNCP (federal + states + municipalities) |
Price Registration Minutes | 8 | List, balance, adherences, participating units, PNCP |
Procurements (14.133 + legacy) | 12 | Law 14.133, Law 8.666, RDC, waivers |
Contracts | 12 | Open Data + Comprasnet (guarantees, invoices, occurrences, tax auditors, commitments, schedule) |
Suppliers | 4 | Registration, impediments, contracts by item |
Sanctions (Transparency/CGU) | 5 | CEIS, CNEP, CEAF, CEPIM, leniency agreements |
PNCP | 9 | Procurements (publication, proposal, update), contracts, modalities |
Organizations | 6 | UASG (list/consult/search), agencies, PNCP units |
Indicators | 2 | Consolidated, by period |
Diagnostics | 1 |
|
The complete list is in manifest.json or via tools/list in the MCP Inspector.
Typical flows
ETP for acquiring ergonomic chairs:
compras_catmat_buscarwithtermo="cadeira ergonomica"→ getcodigo_item_catalogocompras_pesquisar_precos_para_etp(composite) withtipo="material"→ median/mean/stddev + IQR discardcompras_pgc_por_catalogoto see what other agencies planned to buycompras_arp_listarwithapenas_vigentes=True→ active minutes for possible adherence
Supplier analysis before homologation:
compras_perfil_fornecedor_completo(composite) with the CNPJ — one call returns registration + sanctions + active contracts
Inventory of contracts to renew:
compras_contratos_listar_por_fim_vigenciawithdata_fim_vigencianearFor each relevant contract:
compras_contrato_historico_aditivos,compras_contrato_ocorrencias
Internal patterns
Standard envelope of the
listar_*tools:{resultado, _pagina_atual, _total_paginas, _total_registros, _proxima_pagina, _cache_hit, _latency_ms}.SSoT of descriptions: parameter descriptions live in
src/compras_mcp/schemas.py; tools read via_helpers.desc(Model, "campo"). Test intests/test_server.pydetects drift.LGPD: CPFs masked as
123.***.***-45; adjust withINCLUIR_CPF_COMPLETO=true. Affected tools include_aviso_lgpdin the payload.Cache: TTL+LRU in memory (default) or Redis when
REDIS_URLis set. Each domain has its prefix (CATALOGO, PRECOS, ATAS, etc.) — adjustable viaCACHE_<PREFIX>_TTLandCACHE_<PREFIX>_MAX_SIZE.Dates: 3 formats per API (
YYYY-MM-DD,yyyyMMdd,YYYY-MM-DD HH:mm:ss) transparently converted byformat_date(value, flavor).Framework: FastMCP 2.x. Transport detected by
PORT— present → HTTP on0.0.0.0:$PORT, absent → stdio.
Status
v0.2.0 — 85 tools registered and ready for end-to-end testing with Claude Desktop and Railway.
Available Tools
100 toolscompras_aggregate_contratacoes_por_periodoARead-onlyIdempotentInspect
Série temporal de contratações no PNCP por bucket.
Modo count (recomendado para tendência): 1 chamada por bucket
lendo apenas totalRegistros. Janelas grandes (até 5 anos) são viáveis.
Modo valor_*: varre todas as páginas de cada bucket para somar.
Mais lento; limita-se a MAX_PAGES_PER_BUCKET=25 páginas (× 500 itens =
12.500 registros máx por bucket). Sinaliza truncado=true quando bate
o teto.
Concurrency interna: 4 calls simultâneas. Cache 30 min.
Inputs: data_final (required), data_inicial (required), codigo_modalidade (required), uf, +3 more. Returns: object
compras_arp_adesoes_itemARead-onlyIdempotentInspect
Lista adesões (caronas) já realizadas a uma ARP.
Endpoint Dados Abertos /modulo-arp/5_consultarAdesoesItem. Mostra
quem aderiu e com que quantidade — indica nível de demanda e quanto
ainda resta no limite legal de adesões.
Cache 15 min.
Inputs: numero_ata (required), numero_item (required), unidade_gerenciadora (required), pagina, +1 more. Returns: object
compras_arp_buscar_por_objetoARead-onlyIdempotentInspect
Busca ARPs vigentes cujo objeto contém uma palavra-chave.
Resolve a limitação do endpoint /modulo-arp/1.2_consultarARP_FimVigencia,
que não aceita filtro por texto: pagina internamente até max_paginas_varridas
e filtra client-side por presença de palavra_chave (case-insensitive,
com normalização de acentos). Curto-circuita quando atinge max_resultados.
O servidor faz o trabalho que antes era pedido ao LLM — sem isso, o
roteiro oportunidades_carona_arp esbarrava em 169k ARPs vigentes e
339 páginas. Achado da bateria A v0.3.5.
Limitação conhecida: o schema upstream de ARP não traz UF no
item — só nomeOrgao e nomeUnidadeGerenciadora. Para filtrar por
UF, cruze os matches com compras_uasg_consultar usando
codigoUnidadeGerenciadora e compare unidade.uf. Não tentamos esse
cruzamento aqui para manter a tool barata e previsível.
Output: { "resultado": [], "total_examinadas": int, "matches": int, "paginas_varridas": int, "curto_circuitou": bool, "_filtro_objeto": {...} }
Cache 15 min por (palavra_chave + janela + caps).
Inputs: palavra_chave (required), data_vigencia_final_max (required), data_vigencia_final_min (required), max_resultados, +1 more. Returns: object
compras_arp_consultarARead-onlyIdempotentInspect
Consulta uma ARP específica pelo identificador PNCP.
Endpoint Dados Abertos /modulo-arp/1.1_consultarARP_Id. Devolve o
cabeçalho completo da ata (vigência, modalidade, gerenciadora, valores).
Quando o numero_controle_pncp_ata vem no formato de compra (sem
o sufixo -NNNNNN que numera a ata), a tool detecta e devolve
diagnóstico explícito em vez de propagar encontrada=false silencioso.
Cache 15 min.
Inputs: numero_controle_pncp_ata (required). Returns: object
compras_arp_itens_listarARead-onlyIdempotentInspect
Lista itens de ARPs na janela de vigência informada.
Endpoint Dados Abertos /modulo-arp/2_consultarARPItem. O upstream
exige dataVigenciaInicialMin/Max (janela ≤365 dias). Use filtros
opcionais para localizar atas com um item específico.
Cache 15 min.
Inputs: data_vigencia_inicial_max (required), data_vigencia_inicial_min (required), pagina, tipo_item, +4 more. Returns: object
compras_arp_listarARead-onlyIdempotentInspect
Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.
Endpoint Dados Abertos /modulo-arp/1_consultarARP. O upstream exige
janela dataVigenciaInicialMin/Max (≤ 365 dias). Para listar atas
próximas do vencimento, use compras_arp_por_fim_vigencia.
Cache 15 min.
Inputs: data_vigencia_inicial_max (required), data_vigencia_inicial_min (required), pagina, tamanho_pagina, +3 more. Returns: object
compras_arp_por_fim_vigenciaARead-onlyIdempotentInspect
Lista ARPs cuja vigência termina dentro do intervalo informado.
Endpoint Dados Abertos /modulo-arp/1.2_consultarARP_FimVigencia.
Permite ao gestor identificar atas próximas do vencimento.
Cache 15 min.
Inputs: data_vigencia_final_max (required), data_vigencia_final_min (required), pagina, tamanho_pagina, +1 more. Returns: object
compras_arp_saldo_itemARead-onlyIdempotentInspect
Devolve o saldo (quantidade ainda disponível) por item da ARP.
Endpoint Dados Abertos /modulo-arp/4_consultarEmpenhosSaldoItem.
Crítico para adesão: a ata pode estar vigente mas com saldo
zerado. Sem saldo, não há como aderir.
Estrutura do payload: o upstream retorna 1 linha por
(numeroItem, unidade, tipo) — onde tipo pode ser GERENCIADORA,
PARTICIPANTE etc. O mesmo numeroItem aparece várias vezes quando
há múltiplas unidades alocadas (carona ou rateio). Não é
duplicação — são alocações distintas dentro da mesma ata.
Para evitar confusão (achado bateria A v0.3.5), além do resultado
cru, anexamos resumo_por_item: dicionário agregando por
numeroItem com soma das quantidades registradas/empenhadas e
saldo total — pronto para decisão de adesão.
Cache 15 min (saldo muda ao longo do dia).
Inputs: numero_ata (required), unidade_gerenciadora (required), pagina, tamanho_pagina. Returns: object
compras_arp_unidades_itemARead-onlyIdempotentInspect
Lista UGs participantes (potenciais caronas) de um item da ARP.
Endpoint Dados Abertos /modulo-arp/3_consultarUnidadesItem. Determina
quais unidades podem usar a ata como carona (adesão).
Cache 15 min.
Inputs: numero_ata (required), numero_item (required), unidade_gerenciadora (required), pagina, +1 more. Returns: object
compras_buscar_contratacoes_similaresARead-onlyIdempotentInspect
Federa Dados Abertos + PNCP buscando contratações similares.
Composição: consulta os itens de contratações 14.133 no Dados Abertos
(/modulo-contratacoes/2_, filtrando por codItemCatalogo e só itens com
resultado) + publicações PNCP do período, deduplica pelo número de controle
PNCP e devolve os max_resultados mais recentes. Insumo para mapear
benchmarks de outros órgãos.
O recorte por CATMAT/CATSER vale para a perna Dados Abertos. A perna PNCP é
best-effort por modalidade e não aceita filtro por item de catálogo — por
isso amostra_dados_abertos e amostra_pncp vêm separadas no payload.
Atenção latência: chama o PNCP em 3 modalidades (Pregão, Dispensa, Concorrência) em paralelo. Cada chamada PNCP costuma levar 30-60s — o tempo total da composta tende a 60-90s quando o cache está frio. Com Redis configurado as chamadas seguintes voltam em <1s.
Inputs: uf, codigo_catmat, codigo_catser, periodo_meses, +1 more. Returns: object
compras_catmat_buscarARead-onlyIdempotentInspect
Busca itens CATMAT.
⚠️ Não existe busca por substring nesta API. O contrato do
/modulo-material/4_consultarItemMaterial oferece descricaoItem, que é
match exato: descricaoItem='CADEIRA' devolve zero registros, embora o
catálogo tenha milhares de itens começando por "CADEIRA ESCRITÓRIO...".
Não é um filtro degradado — é um filtro de igualdade, e o termo livre que o
usuário digita quase nunca casa com a descrição inteira do item.
Por isso o termo não é enviado ao upstream: mandá-lo faria a chamada
retornar o universo inteiro (~340 mil itens) sem nenhum aviso. Ele é usado
para ordenar e marcar os resultados do recorte estrutural, e a filtragem
real vem de codigo_grupo, codigo_classe e codigo_pdm.
Workflow recomendado:
compras_catmat_listar_grupos()→ escolher o grupo (ex.: 71=Mobiliários).compras_catmat_listar_classes(codigo_grupo=71)→ a classe (ex.: 7110).compras_catmat_listar_pdms(codigo_classe=7110)→ o PDM do material.compras_catmat_buscar(termo='cadeira', codigo_pdm=...).
Esta tool emite _aviso_filtro no payload quando o recorte informado é
largo demais para ser útil.
Cache 24h por (termo + filtros + página).
Inputs: termo (required), pagina, codigo_pdm, codigo_grupo, +2 more. Returns: object
compras_catmat_consultarARead-onlyIdempotentInspect
Consulta detalhes de um item CATMAT específico pelo código.
Devolve nome do item, PDM, grupo, classe, características, NCM e unidades de fornecimento. Útil para confirmar o código antes de fazer pesquisa de preços ou listar contratações similares.
Cache de 24h.
Inputs: codigo_item (required). Returns: object
compras_catmat_listar_classesARead-onlyIdempotentInspect
Lista as classes do CATMAT, opcionalmente filtradas por grupo.
Classes são o segundo nível da hierarquia (ex.: dentro do grupo 71 Mobiliário, a classe 7110 é "Mobiliário de escritório").
Cache de 24h.
Inputs: pagina, codigo_grupo, tamanho_pagina. Returns: object
compras_catmat_listar_gruposARead-onlyIdempotentInspect
Lista os grupos do CATMAT (Catálogo de Materiais).
Grupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO, 11=MATERIAIS BÉLICOS NUCLEARES). Use esta tool para enquadrar a contratação no grupo correto antes de descer para classes/PDM/itens.
Cache de 24h: os grupos mudam muito raramente. Total atual ~79 grupos.
Inputs: pagina, tamanho_pagina. Returns: object
compras_catmat_listar_pdmsARead-onlyIdempotentInspect
Lista os PDMs (Padrão Descritivo de Material) do CATMAT.
Endpoint /modulo-material/3_consultarPdmMaterial. É o terceiro nível da
hierarquia do catálogo: grupo → classe → PDM → item.
O PDM é o que dá nome à família do material ("CADEIRA ESCRITÓRIO", "MICROCOMPUTADOR"), enquanto o item é uma variação específica dela. Como a API não faz busca por substring, descer até o PDM é a forma prática de localizar o material certo antes de pedir os itens.
Uma classe devolve suas dezenas de PDMs nomeados em uma chamada — a
classe 7110 (Mobiliário de escritório) tem 98 PDMs. A alternativa seria
varrer milhares de itens e deduplicar codigoPdm client-side.
Isto é navegação hierárquica, não busca: o endpoint não tem filtro
textual. Combine com compras_catmat_listar_grupos e
compras_catmat_listar_classes para descer a hierarquia, e depois passe o
codigo_pdm para compras_catmat_buscar.
Cache 24h.
Inputs: pagina, codigo_pdm, codigo_grupo, apenas_ativos, +2 more. Returns: object
compras_catser_consultarARead-onlyIdempotentInspect
Consulta detalhes de um item CATSER pelo código.
Devolve nome do serviço, descrição, seção/divisão/grupo/classe e unidades de medida. Use para confirmar o código antes de pesquisar preços ou contratações similares.
Cache de 24h.
Inputs: codigo_item (required). Returns: object
compras_catser_listar_classesARead-onlyIdempotentInspect
Lista as classes CATSER, opcionalmente filtradas por grupo.
Cache de 24h.
Inputs: pagina, codigo_grupo, tamanho_pagina. Returns: object
compras_catser_listar_secoesARead-onlyIdempotentInspect
Lista as seções do CATSER (Catálogo de Serviços).
Seções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU). Use para enquadrar a contratação de serviços em uma seção antes de descer para divisões/grupos/classes/itens.
Cache de 24h.
Inputs: pagina, tamanho_pagina. Returns: object
compras_checar_sancoes_fornecedorARead-onlyIdempotentInspect
Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).
Composição: chama em paralelo as listas do Portal da Transparência e os impedimentos do Comprasnet. Retorna um veredito booleano + lista consolidada de sanções ativas.
Levanta ComprasAuthError se TRANSPARENCIA_API_KEY não estiver configurada.
Sempre use antes de homologar pregões/contratos. Cache 10 min.
Inputs: cnpj (required). Returns: object
compras_comparar_periodos_contratacoesARead-onlyIdempotentInspect
Compara dois períodos lado a lado para a mesma modalidade.
Wrapper sobre compras_aggregate_contratacoes_por_periodo chamado duas
vezes (granularidade='ano' implícita — soma todo o período em 1 bucket).
Retorna totais de A e B + delta absoluto + delta percentual.
Caso de uso típico: "Houve antecipação de licitações em Jun/2024 (ano eleitoral) comparado a Jun/2025?" Ou "As dispensas em Dez/2024 foram maiores que Dez/2023 no mesmo órgão?".
Inputs: periodo_a_fim (required), periodo_b_fim (required), periodo_a_inicio (required), periodo_b_inicio (required), +6 more. Returns: object
compras_contratacoes_14133_consultarARead-onlyIdempotentInspect
Consulta uma contratação 14.133 pelo identificador.
Endpoint /modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id.
Devolve detalhes completos: objeto, valor estimado, modalidade,
instrumento convocatório, status no PNCP.
Aceita os dois identificadores do PNCP. Use tipo_identificador='idCompra'
com o campo idCompra das listagens, ou 'numeroControlePNCPCompra' com o
número de controle que aparece no edital (ex.: 10673078000120-1-000021/2025).
Cache 15 min.
Inputs: id_contratacao (required), tipo_identificador. Returns: object
compras_contratacoes_14133_itens_listarARead-onlyIdempotentInspect
Lista itens de contratações 14.133 incluídos no período.
Endpoint /modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133.
Uso principal — pesquisa de preço por item. Com cod_item_catalogo
(CATMAT/CATSER) cada linha traz, junto, quantidade,
valorUnitarioEstimado, valorUnitarioResultado, valorTotalResultado,
nomeFornecedor e unidadeMedida — ou seja, estimado versus homologado
por item, insumo direto do mapa de preços do ETP.
Higiene da amostra: passe tem_resultado=True (ou situacao_item='2',
Homologado) antes de calcular média ou mediana. Item deserto, fracassado ou
cancelado não é preço praticado.
Sem nenhum filtro além das datas, a resposta é "tudo que o Brasil incluiu no PNCP nessa janela" — quase sempre grande demais para ser útil.
Cache 15 min.
Inputs: data_final_inclusao (required), data_inicial_inclusao (required), pagina, cnpj_orgao, +9 more. Returns: object
compras_contratacoes_14133_itens_por_contratacaoARead-onlyIdempotentInspect
Lista itens de uma contratação 14.133 específica.
Endpoint /modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id.
Aceita idCompra ou número de controle PNCP, conforme tipo_identificador.
Inputs: id_contratacao (required), pagina, tamanho_pagina, tipo_identificador. Returns: object
compras_contratacoes_14133_listarARead-onlyIdempotentInspect
Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).
Endpoint /modulo-contratacoes/1_consultarContratacoes_PNCP_14133.
Cobre pregões eletrônicos, dispensas, inexigibilidades e demais
modalidades da Nova Lei de Licitações no governo federal.
Atenção semântica: o filtro codigo_modalidade_dados_abertos usa a
tabela de modalidade do SIASG/Dados Abertos, NÃO o cheat sheet PNCP de
compras_pncp_modalidades. Os payloads retornam ambos os campos
(codigoModalidade do Dados Abertos e modalidadeIdPncp do PNCP) — use
modalidadeNome para o nome amigável.
Cache 15 min.
Inputs: uf, pagina, cnpj_orgao, codigo_uasg, +7 more. Returns: object
compras_contratacoes_14133_resultados_listarARead-onlyIdempotentInspect
Lista resultados (homologações) de itens 14.133 no período.
Endpoint /modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133.
Devolve fornecedor vencedor, valor adjudicado e quantitativo homologado —
fonte primária de preço praticado para o ETP.
Due diligence de fornecedor: ni_fornecedor (CNPJ/CPF) levanta tudo que
um fornecedor ganhou na janela.
Auditoria por materialidade: valor_total_min monta a fila de
homologações acima de um patamar — combine com uma janela curta, já que o
filtro de data é obrigatório.
Para recortar por item de catálogo, use
compras_contratacoes_14133_itens_listar(cod_item_catalogo=...): esta rota
não oferece filtro por CATMAT/CATSER.
Cache 15 min.
Inputs: data_final_resultado (required), data_inicial_resultado (required), pagina, cnpj_orgao, +9 more. Returns: object
compras_contratacoes_14133_resultados_por_contratacaoARead-onlyIdempotentInspect
Lista resultados (homologações) de uma contratação 14.133 específica.
Endpoint /modulo-contratacoes/3.1_consultarResultadoItensContratacoes....
Aceita idCompra ou número de controle PNCP, conforme tipo_identificador.
Inputs: id_contratacao (required), pagina, tamanho_pagina, tipo_identificador. Returns: object
compras_contrato_comprasnet_consultarARead-onlyIdempotentInspect
Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).
Devolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD. Cache 15 min.
Inputs: id_contrato (required). Returns: object
compras_contrato_comprasnet_por_uasgARead-onlyIdempotentInspect
Lista contratos de uma UASG no Comprasnet.
Atenção: o upstream /api/contrato/ug/{uasg} não suporta paginação —
devolve a lista completa em uma resposta única (pode passar de 1 MB). Esta
tool fatia o resultado client-side conforme pagina + tamanho_pagina para
evitar inundar o LLM.
Cache 15 min do payload completo; fatiamento por chamada é barato.
Inputs: codigo_uasg (required), ativos, pagina, tamanho_pagina. Returns: object
compras_contrato_cronogramaARead-onlyIdempotentInspect
Lista cronograma financeiro (/api/contrato/{id}/cronograma).
Paginação client-side — alguns contratos têm 200+ entradas mensais. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_empenhosARead-onlyIdempotentInspect
Lista empenhos do contrato (/api/contrato/{id}/empenhos).
Paginação client-side. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_faturasARead-onlyIdempotentInspect
Lista NFs/faturas (/api/contrato/{id}/faturas).
Paginação client-side. Cache 15 min. Atenção LGPD: o campo
infcomplementar (texto livre) pode conter nome de servidor + matrícula
SIAPE não estruturados — o mascaramento LGPD só cobre CPFs em campos
nominais (cpf, niResponsavel, etc.).
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_garantiasARead-onlyIdempotentInspect
Lista garantias contratuais (/api/contrato/{id}/garantias).
Paginação client-side. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_historico_aditivosARead-onlyIdempotentInspect
Lista aditivos do contrato (/api/contrato/{id}/historico).
Paginação client-side (upstream não pagina). Cache 15 min do payload completo.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_ocorrenciasARead-onlyIdempotentInspect
Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).
Indicador-chave da confiabilidade do fornecedor. Paginação client-side. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_publicacoesARead-onlyIdempotentInspect
Lista publicações DOU (/api/contrato/{id}/publicacoes).
Paginação client-side. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contrato_responsaveisARead-onlyIdempotentInspect
Lista fiscais/gestores (/api/contrato/{id}/responsaveis).
CPFs mascarados por LGPD (123.***.***-45). Paginação client-side. Cache 15 min.
Inputs: id_contrato (required), pagina, tamanho_pagina. Returns: object
compras_contratos_consultarARead-onlyIdempotentInspect
Consulta um contrato no Dados Abertos (endpoint 1.1).
O upstream exige codigo + tipo. Tipos aceitos pela API:
idCompra e numeroControlePncpContrato.
Cache 15 min.
Inputs: codigo (required), tipo. Returns: object
compras_contratos_item_consultarARead-onlyIdempotentInspect
Lista os itens de um contrato específico, pelo identificador.
Endpoint /modulo-contratos/2.1_consultarContratosItem_Id.
Use quando você já tem o contrato em mãos e quer só os itens dele.
compras_contratos_itens_listar exige órgão mais janela de vigência e
devolve os itens de todos os contratos do recorte — chegar a um contrato
específico por ali significa paginar centenas de linhas irrelevantes.
O codigo aceita o idCompra numérico (padrão) ou o número de controle
PNCP do contrato, conforme tipo_identificador. Qualquer outro valor de
tipo faz o upstream devolver HTTP 500.
Atenção ao somar valores: pode haver mais de uma linha por item, uma por versão/alteração contratual. Confira o campo de exclusão antes de agregar.
Cache 15 min.
Inputs: codigo (required), pagina, tamanho_pagina, tipo_identificador. Returns: object
compras_contratos_itens_listarARead-onlyIdempotentInspect
Lista itens de contratos (endpoint 2).
Upstream exige codigoOrgao + dataVigenciaInicialMin/Max. Cache 15 min.
Inputs: codigo_orgao (required), data_vigencia_inicial_max (required), data_vigencia_inicial_min (required), pagina, +4 more. Returns: object
compras_contratos_listarARead-onlyIdempotentInspect
Lista contratos federais (Dados Abertos /modulo-contratos/1).
O upstream exige codigoOrgao + janela dataVigenciaInicialMin/Max
(≤ 365 dias). Para sub-recursos detalhados (garantias, faturas,
ocorrências), use compras_contrato_* que consulta o Comprasnet.
Cache 15 min.
Inputs: codigo_orgao (required), data_vigencia_inicial_max (required), data_vigencia_inicial_min (required), pagina, +5 more. Returns: object
compras_contratos_listar_por_fim_vigenciaARead-onlyIdempotentInspect
Lista contratos com vencimento na janela informada (endpoint 1.2).
Inventário do que precisa renovar. Upstream exige codigoOrgao +
dataVigenciaFinalMin/Max (≤ 365 dias). Cache 15 min.
Inputs: codigo_orgao (required), data_vigencia_final_max (required), data_vigencia_final_min (required), pagina, +2 more. Returns: object
compras_detalhar_preco_materialARead-onlyIdempotentInspect
Lista as compras individuais de um item CATMAT — sem valor de preço.
Endpoint: /modulo-pesquisa-preco/2_consultarMaterialDetalhe.
⚠️ Esta tool não devolve preço. Até a v0.3.12 a docstring prometia
"valor unitário homologado"; auditoria de 2026-08-05 mostrou que o DTO
upstream (FtPesqPrecoCompraMaterialDetalheDTO) tem exatamente 7 campos
e nenhum deles é valor:
idCompra, idItemCompra, numeroItemCompra, codigoItemCatalogo,
objetoCompra, descricaoDetalhadaItem, dataAtualizacaoFatoConfirmado nos dois sentidos: chamada crua ao upstream (fora da camada do MCP) devolve as mesmas 7 chaves, e o contrato OpenAPI oficial declara as mesmas 7. Ou seja: não somos nós que filtramos — o campo nunca existiu nesta rota. A rota 4 (serviço detalhe) tem DTO idêntico.
Para preço unitário de material use compras_pesquisar_preco_material,
que devolve precoUnitario, quantidade, dataCompra e fornecedor por
compra — é a fonte correta para a amostragem da IN SEGES/ME 65/2021.
Use esta tool apenas para: descrição detalhada do item como comprado,
objeto da compra e rastreio do idCompra para cruzar com outras bases.
Cache 10 min.
Inputs: codigo_item_catalogo (required), pagina, data_fim, data_inicio, +1 more. Returns: object
compras_detalhar_preco_servicoARead-onlyIdempotentInspect
Lista as compras individuais de um serviço CATSER — sem valor de preço.
Endpoint: /modulo-pesquisa-preco/4_consultarServicoDetalhe.
⚠️ Esta tool não devolve preço (verificado 2026-08-05): o DTO upstream é idêntico ao da rota 2 — idCompra, idItemCompra, numeroItemCompra, codigoItemCatalogo, objetoCompra, descricaoDetalhadaItem, dataAtualizacaoFato. Nenhum campo de valor.
Para preço unitário de serviço use compras_pesquisar_preco_servico,
que devolve precoUnitario e fornecedor por compra.
Cache 10 min.
Inputs: codigo_item_catalogo (required), pagina, data_fim, data_inicio, +1 more. Returns: object
compras_fornecedor_cnpj_receitaARead-onlyIdempotentInspect
Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).
Retorna razão social, nome fantasia, situação cadastral, CNAE primário e secundários, QSA (sócios), capital social, natureza jurídica, porte, endereço e datas de início de atividade e da situação cadastral.
Quando usar: complemento do compras_perfil_fornecedor_completo
para due diligence (avaliar porte, sócios, CNAEs vs objeto da licitação).
Os dados são da Receita; este MCP não consulta sanções aqui — para
isso use as tools de sanção (CEIS/CNEP/CEPIM/CEAF).
Cache 24h. Em caso de 404 ou erro upstream, retorna encontrado=false
com diagnóstico em _erro em vez de propagar exception.
Inputs: cnpj (required). Returns: object
compras_fornecedor_consultarARead-onlyIdempotentInspect
Consulta cadastro de um fornecedor pelo CNPJ ou CPF.
Endpoint Dados Abertos /modulo-fornecedor/1_consultarFornecedor.
Devolve razão social, CNAE, porte da empresa, natureza jurídica.
Cache 1h.
Inputs: cnpj_cpf (required). Returns: object
compras_fornecedor_contratos_por_itemARead-onlyIdempotentInspect
Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.
Endpoint POST /api/comprasnet/contratosempenhos. Útil para descobrir
quem fornece esses itens hoje no governo (potenciais participantes em
novos certames).
Cache 1h.
Inputs: codigos_catmat, codigos_catser. Returns: object
compras_fornecedor_impedimentos_por_itensARead-onlyIdempotentInspect
Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).
Endpoint POST /api/comprasnet/compras/impedimentos. Retorna fornecedores
impedidos de participar de contratações dos itens informados (sanções
aplicadas no SICAF). Essencial antes de homologar pregões eletrônicos.
Cache 1h.
Inputs: codigos_catmat, codigos_catser. Returns: object
compras_fornecedor_listarARead-onlyIdempotentInspect
Lista fornecedores no Compras.gov.br com filtros estruturais.
Endpoint Dados Abertos /modulo-fornecedor/1_consultarFornecedor. Use
para mapear fornecedores potenciais por porte/CNAE — ex.: levantar
todas as MEs com CNAE de TI.
Cache 1h.
Inputs: cpf, cnpj, ativo, pagina, +4 more. Returns: object
compras_healthcheckARead-onlyIdempotentInspect
Diz, em ~30 segundos, o que está de pé neste servidor agora.
Estende compras_versao: além de versão e configuração, dispara um
probe paralelo (timeout curto) contra as rotas upstream reais e
devolve a situação por módulo funcional.
Por que existe: em 04/08/2026 a tool de pesquisa de preço de material estava quebrada havia semanas e ninguém sabia — a SEGES trocou a assinatura da rota sem versionar. A descoberta veio de um analista tentando usar a ferramenta. Antes de uma demonstração ou de instruir processo, rode isto: o objetivo é que a descoberta aconteça aqui, não no palco.
Args:
profundidade: basico responde só versão/config (instantâneo);
rotas (padrão) executa o probe upstream.
modulo: restringe o probe a um módulo (ex.: pesquisa_preco,
atas, pncp). Sem isso, testa todos.
Situação por módulo:
- ok: todas as rotas responderam com os campos esperados.
- degradado: alguma rota caiu, ou respondeu 200 sem os campos
do contrato (ex.: rota de preço sem precoUnitario) — o modo de
falha silencioso que só o contrato de campos pega.
- fora: todas as rotas testáveis do módulo falharam.
- pulado: faltou credencial (ex.: TRANSPARENCIA_API_KEY).
Rota que estoura o relógio é reexecutada em série antes de virar
fora: com dezenas de rotas em paralelo, uma rota apenas lenta seria
reportada como quebrada. Quando passa na segunda tentativa, o campo
problemas do módulo registra "lenta sob carga" em vez de escondê-lo.
O campo pronto_para_uso é o resumo honesto: False quando existe
qualquer módulo fora ou degradado.
Inputs: modulo, profundidade. Returns: object
compras_indicadores_consolidadosARead-onlyIdempotentInspect
Métricas operacionais consolidadas da API Dados Abertos.
Endpoint /modulo-indicadores/1_consultarIndicadoresConsolidados.
Retorna: total de serviços disponíveis, total de requisições no
período, percentual de sucesso, latência média (ms), volume total
e médio de download (GB). Útil para diagnóstico/observabilidade,
não para indicadores de mercado público (ver docstring do módulo).
Cache 1h.
Inputs: pagina, tamanho_pagina. Returns: object
compras_indicadores_por_periodoARead-onlyIdempotentInspect
Métricas operacionais da API por período (ano/mês).
Endpoint Dados Abertos /modulo-indicadores/2_consultarIndicadoresPorPeriodo.
Retorna métricas de USO da API (requisições, latência, downloads),
não dados de compras. Útil para análise temporal de disponibilidade
do upstream.
Cache 1h.
Inputs: ano (required), mes, pagina, tamanho_pagina. Returns: object
compras_legado_compras_sem_licitacaoARead-onlyIdempotentInspect
Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.
Endpoint /modulo-legado/5_consultarComprasSemLicitacao. Upstream
exige dt_ano_aviso (ano inteiro, ex.: 2024) — não janela de datas.
Inputs: dt_ano_aviso (required), pagina, co_uasg, co_orgao, +5 more. Returns: object
compras_legado_itens_licitacao_listarBRead-onlyIdempotentInspect
Lista itens de licitações legado (/modulo-legado/2_consultarItemLicitacao).
Upstream exige modalidade obrigatório. Filtros opcionais: uasg,
numero_aviso, codigo_item_material/servico, cnpj_fornecedor.
Inputs: modalidade (required), uasg, pagina, numero_aviso, +4 more. Returns: object
compras_legado_itens_pregao_listarARead-onlyIdempotentInspect
Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.
Endpoints /modulo-legado/4_consultarItensPregoes (por período de
homologação) e /modulo-legado/4.1_consultarItensPregoes_Id (quando
id_compra é informado).
É a única fonte, em todo o MCP, da cadeia completa de formação de preço
por item: valor_estimado_item → menor_lance → valor_negociado →
valor_homologado_item. Serve para medir o desconto real obtido em certame
e para instruir negociação.
Traz também situacao_item, que revela itens desertos e fracassados —
invisíveis para quem só olha preço homologado, e relevantes para justificar
revisão de estimativa.
Informe id_compra ou o par de datas de homologação. As duas datas
precisam ser diferentes entre si (restrição do upstream).
Série histórica: use para contratações anteriores à Lei 14.133. Para 2022 em
diante, prefira compras_contratacoes_14133_itens_listar.
Cache 15 min.
Inputs: pagina, id_compra, codigo_uasg, decreto_7174, +4 more. Returns: object
compras_legado_itens_sem_licitacao_listarARead-onlyIdempotentInspect
Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).
Endpoints /modulo-legado/6_consultarCompraItensSemLicitacao (por ano do
aviso) e /modulo-legado/6.1_consultarItensComprasSemLicitacao_Id (quando
id_compra é informado).
É o único caminho para contratação direta em nível de item no período
anterior ao PNCP (2019-2021) — justamente a janela das dispensas
emergenciais da pandemia, para a qual as rotas da Lei 14.133 retornam vazio.
Traz vr_estimado, fornecedor vencedor e a descrição detalhada do item.
Informe id_compra ou ano_aviso.
CPF de fornecedor pessoa física vem mascarado por padrão (LGPD).
Cache 15 min.
Inputs: pagina, ano_aviso, id_compra, codigo_uasg, +7 more. Returns: object
compras_legado_licitacao_consultarARead-onlyIdempotentInspect
Consulta uma licitação legado pelo id_compra.
Endpoint /modulo-legado/1.1_consultarLicitacao_Id. Upstream exige
id_compra (string), não um id numérico.
Inputs: id_compra (required). Returns: object
compras_legado_licitacoes_listarARead-onlyIdempotentInspect
Lista licitações do regime legado (Lei 8.666/93).
Endpoint /modulo-legado/1_consultarLicitacao. Bug upstream
confirmado: o filtro uasg, embora documentado no swagger oficial,
retorna HTTP 400 ("Erro ao efetuar a consulta") porque o atributo não
existe no modelo Hibernate da view (TbVwLicitacao). Por isso este
parâmetro foi removido da assinatura.
Workaround se você precisar filtrar por UASG: liste sem filtro, depois
filtre client-side pelo campo uasg do resultado.
Inputs: data_publicacao_final (required), data_publicacao_inicial (required), pagina, modalidade, +3 more. Returns: object
compras_legado_pregoes_listarARead-onlyIdempotentInspect
Lista pregões eletrônicos do regime legado.
Endpoint /modulo-legado/3_consultarPregoes. Bug upstream
confirmado: os filtros co_uasg e co_orgao, embora documentados
no swagger, retornam HTTP 400 com erro Hibernate
Could not resolve attribute 'TbVwPregaoId.coUasg' porque os atributos
não existem no modelo da view. Por isso ambos foram removidos da
assinatura.
Workaround para filtrar por UASG: chame sem filtro e filtre client-side
pelos campos coUasg/coOrgao do resultado.
Inputs: dt_data_edital_final (required), dt_data_edital_inicial (required), numero, pagina, +3 more. Returns: object
compras_legado_rdc_listarARead-onlyIdempotentInspect
Lista contratações pelo RDC (Regime Diferenciado de Contratações).
Endpoint /modulo-legado/7_consultarRdc. Upstream usa
data_publicacao_min/max (note min/max, não inicial/final).
RDC foi usado principalmente para obras dos megaeventos e da Copa —
relevância residual hoje.
Inputs: data_publicacao_max (required), data_publicacao_min (required), uasg, orgao, +4 more. Returns: object
compras_listar_promptsARead-onlyIdempotentInspect
Lista os MCP Prompts disponíveis com nome, descrição e argumentos.
Tools de descoberta para clientes (como o Claude.ai web) que ainda não expõem UI para prompts. Em Claude Desktop / Cursor / MCP Inspector, prompts aparecem em UI dedicada — esta tool é um caminho alternativo, não substituto.
Use depois compras_obter_prompt(nome, argumentos) para renderizar
um prompt específico.
Retorno: { "total": int, "prompts": [ { "nome": str, "descricao": str, "tags": [str, ...], "argumentos": [ {"nome": str, "descricao": str | None, "obrigatorio": bool}, ... ] }, ... ] }
Inputs: no named parameters. Returns: object
compras_listar_resourcesARead-onlyIdempotentInspect
Lista os MCP Resources disponíveis com URI, nome e mime-type.
Tools de descoberta para clientes que não expõem UI de attachment de resources (como o Claude.ai web). Em Claude Desktop / Cursor / MCP Inspector, resources aparecem em picker dedicado.
Resources contêm dados de referência estáticos (tabelas de domínio,
glossário, metadados do servidor). Use compras_obter_resource(uri)
para ler o conteúdo.
Retorno: { "total": int, "resources": [ {"uri": str, "nome": str, "descricao": str, "mime_type": str, "tags": [str,...]}, ... ] }
Inputs: no named parameters. Returns: object
compras_montar_dossie_arpARead-onlyIdempotentInspect
Dossiê completo de uma ARP em uma chamada.
Composição: cabeçalho via /modulo-arp/1.1 (id PNCP) e — se numero_item
informado — saldo (4), adesões (5) e unidades participantes (3) em
paralelo. Os 3 últimos endpoints usam a chave composta
numeroAta + unidadeGerenciadora.
Os 3 IDs vêm naturalmente do retorno de compras_arp_listar ou
compras_arp_itens_listar (campos: numeroControlePncpAta,
numeroAta, unidadeGerenciadora, numeroItem). Cache 10 min.
Quando numero_controle_pncp_ata vem no formato de compra (sem
sufixo -NNNNNN), devolvemos diagnóstico explícito antes de bater
no upstream — caminho que retornava cabecalho: null silencioso.
Inputs: numero_ata (required), unidade_gerenciadora (required), numero_controle_pncp_ata (required), numero_item. Returns: object
compras_obter_promptARead-onlyIdempotentInspect
Renderiza um MCP Prompt e devolve o texto pronto.
O texto retornado é o conteúdo da PromptMessage[0] — tipicamente um
roteiro que orienta o LLM a executar um fluxo usando as tools deste
servidor. Depois de obter o texto, o LLM normalmente segue as
instruções dele, chamando outras tools conforme indicado.
Retorno: { "nome": str, "texto": str, # conteúdo renderizado pronto para usar "argumentos_usados": dict, }
Se o prompt não existir ou faltar argumento obrigatório, retorna
_erro com diagnóstico em vez de propagar exception.
Inputs: nome (required), argumentos. Returns: object
compras_obter_resourceARead-onlyIdempotentInspect
Lê o conteúdo de um MCP Resource pela URI.
Retorna o conteúdo bruto (texto/JSON-string conforme o mime-type registrado) e os metadados do resource.
Retorno: { "uri": str, "nome": str, "mime_type": str, "conteudo": str, }
Se a URI não existir, retorna _erro em vez de propagar exception.
Inputs: uri (required). Returns: object
compras_orgao_consultarARead-onlyIdempotentInspect
Consulta um órgão específico pelo código.
Devolve nome, sigla, CNPJ, esfera, poder e quantitativos. Cache 24h.
Inputs: codigo_orgao (required). Returns: object
compras_orgao_listarARead-onlyIdempotentInspect
Lista órgãos cadastrados no Compras.gov.br.
Endpoint Dados Abertos /modulo-uasg/2_consultarOrgao. Inclui órgãos
do SISG (Sistema de Serviços Gerais), com código numérico, nome,
esfera, poder e CNPJ.
✅ Restaurada em 2026-08-05: faltava o parâmetro obrigatório
statusOrgao — mesma causa do 404 em compras_uasg_listar.
nome, esfera e poder são aplicados aqui, client-side. Nenhum
dos três consta do contrato desta rota, e esta API ignora chave
desconhecida em silêncio — mandá-los devolvia os ~11,9 mil órgãos
ativos com cara de resultado filtrado (reconfirmado em 2026-09-07 com
parâmetro de controle). Desde 2026-09-07 eles não são mais enviados: o
recorte é feito sobre a página trazida, e o payload traz
_filtro_client_side dizendo quantos sobraram. Consequência prática:
o filtro só enxerga a página atual, então varra as páginas ou use
codigo_orgao em compras_orgao_consultar quando souber o código.
Cache 24h.
Inputs: nome, poder, esfera, pagina, +1 more. Returns: object
compras_perfil_fornecedor_completoARead-onlyIdempotentInspect
Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).
Composição em paralelo:
cadastro: Dados Abertos
/modulo-fornecedor/1_consultarFornecedorpelo CNPJ (razão social, CNAE, porte, natureza jurídica);receita_federal: BrasilAPI / MinhaReceita — QSA, capital social, atividades secundárias, data de início, situação cadastral (RF). Provider configurável via
CNPJ_PROVIDER(defaultbrasilapi);sanções: Portal da Transparência (CEIS+CNEP+CEPIM) pelo CNPJ;
impedimentos Comprasnet:
/api/comprasnet/compras/impedimentos.
Não inclui lista de contratos porque os endpoints upstream
/modulo-contratos/1 (Dados Abertos) e /v1/contratos (PNCP) exigem
codigoOrgao como filtro obrigatório — não é possível listar contratos
de um fornecedor sem saber em qual órgão ele tem contrato. Se você já
souber o órgão, use compras_contratos_listar(codigo_orgao=X, ni_fornecedor=Y, ...).
Sanções dependem de TRANSPARENCIA_API_KEY — se não configurada ou se
o WAF da CGU bloquear, o bloco retorna aviso e o restante segue.
Cache 10 min.
Inputs: cnpj (required). Returns: object
compras_pesquisar_preco_materialARead-onlyIdempotentInspect
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.
Inputs: codigo_item_catalogo (required), uf, pagina, data_fim, +4 more. Returns: object
compras_pesquisar_preco_servicoARead-onlyIdempotentInspect
Pesquisa preços praticados em compras de serviço (CATSER).
Endpoint: /modulo-pesquisa-preco/3_consultarServico. Para visão
consolidada (mediana, média, desvio no padrão IN 65/2021), use a tool
composta compras_pesquisar_precos_para_etp com tipo='servico'.
Inputs: codigo_item_catalogo (required), uf, pagina, data_fim, +4 more. Returns: object
compras_pesquisar_precos_para_etpARead-onlyIdempotentInspect
Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.
Composição: percorre compras_pesquisar_preco_material ou _servico
em até max_paginas, agrega os valores unitários e calcula:
mediana, média, desvio padrão, mínimo, máximo, quartis (Q1, Q3) e
descarte de outliers por IQR (1.5×IQR — Tukey).
Saída pronta para colagem em ETP: lista detalhada + sumário estatístico
amostra recomendada (sem outliers). Cache 10 min.
Inputs: tipo (required), codigo_item_catalogo (required), uf, max_paginas, +1 more. Returns: object
compras_pgc_agregacaoARead-onlyIdempotentInspect
Resumo agregado do PGC de um órgão num ano (totais por categoria).
Endpoint Dados Abertos /modulo-pgc/3_consultarPgcAgregacao. Retorna
contagens e valores totais por categoria/grupo, útil para diagnóstico
rápido do volume planejado pelo órgão.
Cache 1h.
Inputs: ano (required), codigo_orgao (required), pagina, tamanho_pagina. Returns: object
compras_pgc_listarARead-onlyIdempotentInspect
Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.
Endpoint Dados Abertos /modulo-pgc/1_consultarPgcDetalhe. Cada linha
representa um item planejado: descrição, quantidade, valor unitário
estimado, mês previsto de início e categoria de item.
Cache 1h.
Inputs: ano (required), pagina, codigo_uasg, codigo_orgao, +1 more. Returns: object
compras_pgc_listar_csvARead-onlyIdempotentInspect
Versão CSV de compras_pgc_listar (mesmo dataset, formato planilha).
Endpoint /modulo-pgc/1.1_consultarPgcDetalhe_CSV. Útil para colar no
ETP ou planilhar localmente. Retorna o CSV no campo csv da resposta.
Inputs: ano (required), codigo_uasg, codigo_orgao. Returns: object
compras_pgc_por_catalogoARead-onlyIdempotentInspect
Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).
Endpoint Dados Abertos /modulo-pgc/2_consultarPgcDetalheCatalogo.
Útil para responder: "Quais órgãos planejaram comprar esse item este ano?
Em que quantidade?". Insumo para ETP e benchmarking de quantitativos.
Corrigida em 2026-09-07. A tool mandava tipo=M/tipo=S e o enum
upstream é [Material, Servico] — toda chamada devolvia HTTP 500
("Failed to convert ... EnumPgcDetalheCatalogo ... for value [M]"). A
interface M/S foi mantida e a tradução passou a ser feita aqui.
Mesma classe de defeito do tipo=C das tools de contratações.
Cache 1h.
Inputs: ano (required), tipo (required), codigo_item (required), pagina, +1 more. Returns: object
compras_pncp_ata_arquivosARead-onlyIdempotentInspect
Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).
Endpoint /v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencialAta}/arquivos
da API pública de arquivos do PNCP (/api/pncp, sem chave).
Aditivos de reequilíbrio/prorrogação aparecem como documentos adicionais
do tipo Ata de Registro de Preços — diferencie por titulo e
dataPublicacaoPncp. Download: GET simples na url de cada item.
Cache 15 min.
Inputs: cnpj (required), ano_compra (required), sequencial_ata (required), sequencial_compra (required). Returns: object
compras_pncp_atas_listarARead-onlyIdempotentInspect
Lista atas registradas no PNCP no período (federal + estadual + municipal).
Endpoint PNCP /v1/atas. Permite encontrar atas de qualquer ente da
federação — mais amplo que Dados Abertos (só federal SISG).
Cache 15 min.
Inputs: data_final (required), data_inicial (required), pagina, cnpj_orgao, +1 more. Returns: object
compras_pncp_contratacao_arquivosARead-onlyIdempotentInspect
Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).
Endpoint /v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos da API
pública de arquivos do PNCP (host /api/pncp, sem chave — diferente de
/api/consulta, que exige chave-api-dadosabertos e não expõe anexos).
Cada item traz url (download direto do PDF/ZIP), sequencialDocumento,
titulo, tipoDocumentoNome (Edital, Termo de Referência, Projeto
Básico, Estudo Técnico Preliminar...). Atenção: o arquivo do Edital vem
frequentemente como ZIP (por vezes ZIP dentro de ZIP) contendo o TR.
Baixe com GET simples na url — não é necessário navegador.
Cache 15 min.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: object
compras_pncp_contratacao_item_resultadosARead-onlyIdempotentInspect
Lista resultados (vencedores) de um item específico de contratação no PNCP.
Endpoint /v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados.
Cache 15 min.
Inputs: ano (required), cnpj (required), sequencial (required), numero_item (required). Returns: object
compras_pncp_contratacao_itensBRead-onlyIdempotentInspect
Lista itens de uma contratação no PNCP.
Endpoint /v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens.
Cache 15 min.
Inputs: ano (required), cnpj (required), sequencial (required), pagina, +1 more. Returns: object
compras_pncp_contratacao_por_orgaoARead-onlyIdempotentInspect
Consulta uma contratação específica pelo CNPJ + ano + sequencial.
Endpoint /v1/orgaos/{cnpj}/compras/{ano}/{sequencial}. Devolve
cabeçalho completo da contratação.
Cache 15 min.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: object
compras_pncp_contratacoes_atualizacaoARead-onlyIdempotentInspect
Lista contratações alteradas no período (PNCP).
Endpoint /v1/contratacoes/atualizacao. Útil para monitoramento:
descobrir editais que sofreram retificações/republicações. Aceita
filtro esfera client-side.
Cache 15 min.
Inputs: data_final (required), data_inicial (required), codigo_modalidade (required), esfera, +2 more. Returns: object
compras_pncp_contratacoes_propostaARead-onlyIdempotentInspect
Lista contratações com prazo de proposta aberto no PNCP.
Endpoint /v1/contratacoes/proposta. Útil para mapear oportunidades
abertas para fornecedores ou para identificar contratações em curso
em órgãos similares. Filtro esfera opcional client-side.
Cache 15 min.
Inputs: data_final (required), codigo_modalidade (required), uf, esfera, +2 more. Returns: object
compras_pncp_contratacoes_publicacaoARead-onlyIdempotentInspect
Lista contratações publicadas no PNCP no período.
Endpoint /v1/contratacoes/publicacao. Cobre todos os entes da
federação. Modalidades comuns: 6=Pregão Eletrônico, 8=Dispensa,
9=Inexigibilidade, 4=Concorrência Eletrônica.
O filtro esfera (federal/estadual/municipal/distrital) é aplicado
client-side sobre a página retornada. Janela máxima por consulta: ~30
dias. Cache 15 min.
Inputs: data_final (required), data_inicial (required), codigo_modalidade (required), uf, +5 more. Returns: object
compras_pncp_contrato_por_orgaoBRead-onlyIdempotentInspect
Consulta um contrato específico no PNCP.
Endpoint /v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}. Cache 15 min.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: object
compras_pncp_contratos_listarARead-onlyIdempotentInspect
Lista contratos publicados no PNCP no período.
Endpoint /v1/contratos. Cache 15 min.
Inputs: data_final (required), data_inicial (required), pagina, cnpj_orgao, +1 more. Returns: object
compras_pncp_modalidadesARead-onlyIdempotentInspect
Cheat sheet local: códigos de modalidade de contratação do PNCP.
Tool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).
ATENÇÃO — duas tabelas em circulação no ecossistema Compras:
codigoaqui (PNCP) é o usado em TODAS as toolscompras_pncp_*e emmodalidadeIdPncpno payload de retorno.O Dados Abertos / SIASG usa uma enumeração diferente em
compras_contratacoes_14133_listar(codigo_modalidade_dados_abertos): campoequivalente_dados_abertosabaixo, ou None se a modalidade não estiver disponível naquele endpoint.
Inputs: no named parameters. Returns: object
compras_pncp_orgao_unidadesARead-onlyIdempotentInspect
Lista unidades administrativas de um órgão no PNCP.
Endpoint PNCP /v1/orgaos/{cnpj}/unidades. Útil para descobrir códigos
de unidade antes de filtrar contratações/contratos do órgão.
Cobre estados e municípios (não só federal). Cache 24h.
Tratamento de 404: nem todo CNPJ está indexado no PNCP. Em vez de
levantar exception, esta tool retorna _erro_upstream informativo
com lista de alternativas (mesmo padrão das tools compras_uasg_* /
compras_orgao_* quando o /modulo-uasg/* retorna 404).
Inputs: cnpj (required). Returns: object
compras_pncp_pca_atualizacaoARead-onlyIdempotentInspect
Lista PCAs atualizados num período (PNCP).
Endpoint PNCP /v1/pca/atualizacao. Útil para monitoramento: descobrir
quais órgãos revisaram seu PCA recentemente.
Cache 1h.
Inputs: data_final (required), data_inicial (required), pagina, tamanho_pagina. Returns: object
compras_pncp_pca_listarARead-onlyIdempotentInspect
Lista PCAs (Planos Anuais de Contratações) no PNCP.
Endpoint PNCP /v1/pca/. Diferente do PGC, o PCA da Lei 14.133 cobre
federais + estaduais + municipais. Filtra por categoria do item
(codigo_classificacao_superior é obrigatório no upstream).
Cache 1h.
Inputs: ano (required), codigo_classificacao_superior (required), pagina, cnpj_orgao, +1 more. Returns: object
compras_pncp_pca_por_classificacao_superiorARead-onlyIdempotentInspect
Lista itens de PCA filtrados por categoria superior do item.
Endpoint PNCP /v1/pca/ com codigoClassificacaoSuperior. Permite
agregar planejamentos por categoria (ex.: todos os itens de TI
planejados para o ano).
Cache 1h.
Inputs: ano (required), codigo_classificacao_superior (required), pagina, tamanho_pagina. Returns: object
compras_pncp_pca_por_usuarioARead-onlyIdempotentInspect
Lista PCAs vinculados a um usuário/sistema integrador específico.
Endpoint PNCP /v1/pca/usuario. Uso menos comum — geralmente o
analista prefere compras_pncp_pca_listar com cnpj_orgao.
Cache 1h.
Inputs: ano (required), id_usuario (required), pagina, tamanho_pagina. Returns: object
compras_sancao_acordos_lenienciaARead-onlyIdempotentInspect
Lista acordos de leniência firmados com a CGU.
Endpoint /api-de-dados/acordos-leniencia. Empresas com acordo ativo
estão sob compromisso de compliance reforçado — informação útil para
análise de risco em contratações de alto valor.
Cache 1h.
Inputs: cnpj, pagina. Returns: object
compras_sancao_ceafARead-onlyIdempotentInspect
Consulta CEAF — Cadastro de Expulsões da Administração Federal.
Endpoint /api-de-dados/ceaf. Servidores expulsos do serviço público
federal. Útil quando se identifica responsável/preposto suspeito.
CPFs mascarados por LGPD (123.***.***-45). Cache 1h.
Inputs: cpf, nome, pagina. Returns: object
compras_sancao_ceisARead-onlyIdempotentInspect
Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.
Endpoint /api-de-dados/ceis. Empresas com sanção ativa não podem
contratar com a administração pública. Use sempre antes de
homologar pregões e contratos.
Cache 1h.
Inputs: cnpj, nome, pagina, orgao_sancionador. Returns: object
compras_sancao_cepimARead-onlyIdempotentInspect
Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.
Endpoint /api-de-dados/cepim. Aplicável a contratações via convênios
e termos de fomento com OSCs.
Cache 1h.
Inputs: cnpj, nome, pagina. Returns: object
compras_sancao_cnepARead-onlyIdempotentInspect
Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).
Endpoint /api-de-dados/cnep. Empresas punidas pela Lei 12.846/2013
(Lei Anticorrupção). Indicador de risco de integridade.
Cache 1h.
Inputs: cnpj, nome, pagina. Returns: object
compras_uasg_buscarARead-onlyIdempotentInspect
Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).
✅ Restaurada em 2026-08-05, com busca local. Duas correções:
A rota exige
statusUasg; sem ele devolvia 404 (mesma causa decompras_uasg_listar).O parâmetro
nomenão existe no contrato da rota e era ignorado pelo upstream — enviá-lo devolvia o universo inteiro (~22 mil UASGs) como se fossem resultados de busca. Corrigir só o item 1 teria trocado um erro visível (404) por um erro silencioso, que é pior: o analista receberia "TCU - SECRETARIA DE INFORMATICA" como 1º resultado de qualquer termo.
Como não há filtro textual upstream, a busca é feita localmente:
a tool varre as páginas da rota (500 registros cada, ~8s no universo
completo), filtra por termo e pagina o resultado filtrado. O varrido
fica em cache por 24h, então só a primeira busca do dia paga o custo.
O payload informa _busca_local, _paginas_varridas e
_universo_varrido — se a varredura for truncada, isso fica explícito
em vez de virar silêncio.
Cache 24h.
Inputs: termo (required), pagina, tamanho_pagina. Returns: object
compras_uasg_consultarARead-onlyIdempotentInspect
Consulta uma UASG específica pelo código.
Devolve nome, sigla, CNPJ vinculado, órgão superior e endereço.
Útil para resolver codigo_uasg antes de consultas filtradas.
✅ Restaurada em 2026-08-05 — ver compras_uasg_listar para o
diagnóstico do 404 que afetava toda a família /modulo-uasg/*.
Busca primeiro entre as ativas; se não achar, repete entre as inativas
(o upstream exige statusUasg e não aceita "ambas"), devolvendo
ativa: false para UASGs extintas.
Cache 24h.
Inputs: codigo_uasg (required). Returns: object
compras_uasg_listarARead-onlyIdempotentInspect
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.
Inputs: ativo, pagina, codigo_orgao, tamanho_pagina. Returns: object
compras_versaoARead-onlyIdempotentInspect
Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e estado de configurações sensíveis (sem expor valores).
Útil para confirmar que o servidor está respondendo, qual a versão instalada, quais APIs estão acessíveis e se a chave da Transparência foi configurada (necessária para tools de sanções).
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 100 tools
The tools are generally organized around distinct resources and actions, and the descriptions are unusually explicit about sources, regimes, and endpoint quirks. However, 100 tools create several close families—pesquisar_preco_material vs. detalhar_preco_material, the multiple contrato/contratação listers, and the ARP/PGC/PCA variants—that require careful reading to select correctly.
Most names use a compras_<domain>_<action> shape, but the action placement and vocabulary vary widely: listar_* and consultar_* appear before or after the resource, several names are noun-only (compras_pncp_modalidades, compras_versao, compras_contrato_garantias), and words like aggregate and healthcheck break the Portuguese convention. The prefix is consistent, but the overall pattern is not.
100 tools is an extreme count for an MCP surface and far exceeds the well-scoped range. The set is fragmented into many fine-grained contract sub-resources, source/regime variants, and meta-tools for prompts/resources/health, making navigation and selection unnecessarily costly for an agent.
The surface is remarkably comprehensive for read-only Brazilian procurement data: catalogs, PNCP and legacy regimes, ARPs, contracts, suppliers, sanctions, price research, PGC/PCA, and operational diagnostics are all covered with few dead ends. Minor gaps remain—CATSER lacks explicit divisão/grupo steps, there is no true substring catalog search, and contract-by-supplier requires knowing the órgão—but these are documented and workable.
Maintenance
Related MCP Connectors
Query Brazil's public procurement portal (PNCP): tenders, contracts and price records.
Search Brazilian government tenders and public procurement (PNCP): find notices and auctions by keyw
Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.
Consolidated lookup of a company at the Federal Audit Court (TCU) from the CNPJ, gathering sanctions
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates 6 Korean public procurement APIs to search, analyze, and manage procurement data using natural language.83MIT

licinexus-mcpofficial
AlicenseAqualityDmaintenancerazilian public procurement (PNCP) and Federal Revenue CNPJ data for any MCP client. 18 tools covering bids, contracts, atas de registro de preço, annual procurement plans, CNPJ enrichment, plus temporal aggregation and period comparison. MIT licensed, maintained by Licinexus under Law 14.133/2021.18114 npm80MIT- AlicenseAqualityDmaintenanceEnables querying El Salvador's public procurement data, including awarded processes, supplier contracts, and institution details, from the live COMPRASAL API through an MCP interface.81MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Brazilian public transparency data for companies by CNPJ, returning indicators like sanctions, agreements, and contracts. Read-only and works with any MCP client over HTTP.MIT