MCP Compras.gov.br
Preços, atas, contratos e sanções das APIs públicas de compras do governo brasileiro
| Endpoint | https://mcp-compras.up.railway.app/mcp (streamable-http) |
|---|---|
| Registry version | 0.4.0 |
| Now | 100 tools · grade D (64) · pin ts_8bdacbae68e4b4a91dbc477594286e9b · protocol 2025-06-18 |
| First / last listed | 2026-10-28 04:40 UTC / 2026-10-28 04:40 UTC |
| Grade over time | 2026-10-28: D (64), 100 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: compras_aggregate_contratacoes_por_periodo compras_comparar_periodos_contratacoes compras_arp_listar compras_arp_consultar compras_arp_por_fim_vigencia compras_arp_buscar_por_objeto compras_arp_itens_listar compras_arp_unidades_item compras_arp_saldo_item compras_arp_adesoes_item compras_pncp_atas_listar compras_catmat_listar_grupos compras_catmat_listar_classes compras_catmat_consultar compras_catmat_listar_pdms compras_catmat_buscar compras_catser_listar_secoes compras_catser_listar_classes compras_catser_consultar compras_pesquisar_precos_para_etp compras_checar_sancoes_fornecedor compras_montar_dossie_arp compras_buscar_contratacoes_similares compras_perfil_fornecedor_completo compras_contratacoes_14133_listar compras_contratacoes_14133_consultar compras_contratacoes_14133_itens_listar compras_contratacoes_14133_itens_por_contratacao compras_contratacoes_14133_resultados_listar compras_contratacoes_14133_resultados_por_contratacao compras_legado_licitacoes_listar compras_legado_licitacao_consultar compras_legado_itens_licitacao_listar compras_legado_pregoes_listar compras_legado_compras_sem_licitacao compras_legado_rdc_listar compras_legado_itens_pregao_listar compras_legado_itens_sem_licitacao_listar compras_contratos_listar compras_contratos_consultar compras_contratos_listar_por_fim_vigencia compras_contratos_itens_listar compras_contratos_item_consultar compras_contrato_comprasnet_consultar compras_contrato_comprasnet_por_uasg compras_contrato_historico_aditivos compras_contrato_garantias compras_contrato_faturas compras_contrato_ocorrencias compras_contrato_responsaveis compras_contrato_empenhos compras_contrato_publicacoes compras_contrato_cronograma compras_listar_prompts compras_obter_prompt compras_listar_resources compras_obter_resource compras_fornecedor_cnpj_receita compras_fornecedor_consultar compras_fornecedor_listar compras_fornecedor_impedimentos_por_itens compras_fornecedor_contratos_por_item compras_indicadores_consolidados compras_indicadores_por_periodo compras_uasg_listar compras_uasg_consultar compras_orgao_listar compras_orgao_consultar compras_pncp_orgao_unidades compras_uasg_buscar compras_pesquisar_preco_material compras_detalhar_preco_material compras_pesquisar_preco_servico compras_detalhar_preco_servico compras_pgc_listar compras_pgc_por_catalogo compras_pgc_agregacao compras_pgc_listar_csv compras_pncp_pca_listar compras_pncp_pca_atualizacao compras_pncp_pca_por_usuario compras_pncp_pca_por_classificacao_superior compras_pncp_contratacoes_publicacao compras_pncp_contratacoes_proposta compras_pncp_contratacoes_atualizacao compras_pncp_contratacao_por_orgao compras_pncp_contratacao_itens compras_pncp_contratacao_item_resultados compras_pncp_contratos_listar compras_pncp_contrato_por_orgao compras_pncp_modalidades compras_pncp_contratacao_arquivos compras_pncp_ata_arquivos compras_sancao_ceis compras_sancao_cnep compras_sancao_ceaf compras_sancao_cepim compras_sancao_acordos_leniencia compras_versao compras_healthcheck
compras_aggregate_contratacoes_por_periodo | 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` quan params: data_inicial*, data_final*, codigo_modalidade*, granularidade, metrica, uf, esfera |
compras_comparar_periodos_contratacoes | 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/2 params: periodo_a_inicio*, periodo_a_fim*, periodo_b_inicio*, periodo_b_fim*, codigo_modalidade*, label_a, label_b, metrica, uf, esfera |
compras_arp_listar | 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. params: data_vigencia_inicial_min*, data_vigencia_inicial_max*, codigo_unidade_gerenciadora, codigo_modalidade_compra, numero_ata_registro_preco, pagina, tamanho_pagina |
compras_arp_consultar | 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. params: numero_controle_pncp_ata* |
compras_arp_por_fim_vigencia | 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. params: data_vigencia_final_min*, data_vigencia_final_max*, codigo_unidade_gerenciadora, pagina, tamanho_pagina |
compras_arp_buscar_por_objeto | 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 ant params: palavra_chave*, data_vigencia_final_min*, data_vigencia_final_max*, max_paginas_varridas, max_resultados |
compras_arp_itens_listar | 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. params: data_vigencia_inicial_min*, data_vigencia_inicial_max*, codigo_item, tipo_item, ni_fornecedor, codigo_unidade_gerenciadora, pagina, tamanho_pagina |
compras_arp_unidades_item | 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. params: numero_ata*, unidade_gerenciadora*, numero_item*, pagina, tamanho_pagina |
compras_arp_saldo_item | 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 `nume params: numero_ata*, unidade_gerenciadora*, pagina, tamanho_pagina |
compras_arp_adesoes_item | 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. params: numero_ata*, unidade_gerenciadora*, numero_item*, pagina, tamanho_pagina |
compras_pncp_atas_listar | 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. params: data_inicial*, data_final*, cnpj_orgao, pagina, tamanho_pagina |
compras_catmat_listar_grupos | 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. params: pagina, tamanho_pagina |
compras_catmat_listar_classes | 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. params: codigo_grupo, pagina, tamanho_pagina |
compras_catmat_consultar | 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. params: codigo_item* |
compras_catmat_listar_pdms | 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 params: codigo_classe, codigo_grupo, codigo_pdm, apenas_ativos, pagina, tamanho_pagina |
compras_catmat_buscar | 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 qua params: termo*, codigo_grupo, codigo_classe, codigo_pdm, pagina, tamanho_pagina |
compras_catser_listar_secoes | 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. params: pagina, tamanho_pagina |
compras_catser_listar_classes | Lista as classes CATSER, opcionalmente filtradas por grupo.
Cache de 24h. params: codigo_grupo, pagina, tamanho_pagina |
compras_catser_consultar | 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. params: codigo_item* |
compras_pesquisar_precos_para_etp | 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 rec params: tipo*, codigo_item_catalogo*, periodo_meses, uf, max_paginas |
compras_checar_sancoes_fornecedor | 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. params: cnpj* |
compras_montar_dossie_arp | 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` params: numero_controle_pncp_ata*, numero_ata*, unidade_gerenciadora*, numero_item |
compras_buscar_contratacoes_similares | 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 params: codigo_catmat, codigo_catser, periodo_meses, uf, max_resultados |
compras_perfil_fornecedor_completo | Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).
Composição em paralelo:
- **cadastro**: Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`
pelo 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 params: cnpj* |
compras_contratacoes_14133_listar | 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 params: data_inicial_publicacao, data_final_publicacao, codigo_uasg, cnpj_orgao, codigo_orgao_pncp, uf, codigo_ibge_municipio, amparo_legal, codigo_modalidade_dados_abertos, pagina, tamanho_pagina |
compras_contratacoes_14133_consultar | 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 contr params: id_contratacao*, tipo_identificador |
compras_contratacoes_14133_itens_listar | 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* homo params: data_inicial_inclusao*, data_final_inclusao*, cod_item_catalogo, material_ou_servico, codigo_grupo, codigo_classe, tem_resultado, situacao_item, cnpj_orgao, codigo_uasg, cnpj_cpf_fornecedor, pagina, tamanho_pagina |
compras_contratacoes_14133_itens_por_contratacao | 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`. params: id_contratacao*, tipo_identificador, pagina, tamanho_pagina |
compras_contratacoes_14133_resultados_listar | 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 materialid params: data_inicial_resultado*, data_final_resultado*, ni_fornecedor, porte_fornecedor, situacao_resultado, valor_unitario_min, valor_unitario_max, valor_total_min, valor_total_max, cnpj_orgao, codigo_uasg, pagina, tamanho_pagina |
compras_contratacoes_14133_resultados_por_contratacao | 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`. params: id_contratacao*, tipo_identificador, pagina, tamanho_pagina |
compras_legado_licitacoes_listar | 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 params: data_publicacao_inicial*, data_publicacao_final*, modalidade, numero_aviso, pertence14133, pagina, tamanho_pagina |
compras_legado_licitacao_consultar | 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. params: id_compra* |
compras_legado_itens_licitacao_listar | 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`. params: modalidade*, uasg, numero_aviso, codigo_item_material, codigo_item_servico, cnpj_fornecedor, pagina, tamanho_pagina |
compras_legado_pregoes_listar | 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 po params: dt_data_edital_inicial*, dt_data_edital_final*, numero, ds_tipo_pregao_compra, pertence14133, pagina, tamanho_pagina |
compras_legado_compras_sem_licitacao | 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. params: dt_ano_aviso*, co_uasg, co_orgao, co_orgao_superior, nu_aviso_licitacao, co_modalidade_licitacao, pertence14133, pagina, tamanho_pagina |
compras_legado_rdc_listar | 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. params: data_publicacao_min*, data_publicacao_max*, uasg, orgao, uf_uasg, modalidade, pagina, tamanho_pagina |
compras_legado_itens_pregao_listar | 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_homolog params: data_homologacao_inicial, data_homologacao_final, id_compra, id_compra_item, codigo_uasg, decreto_7174, pagina, tamanho_pagina |
compras_legado_itens_sem_licitacao_listar | 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
eme params: ano_aviso, id_compra, id_compra_item, codigo_uasg, codigo_orgao, codigo_modalidade, codigo_conjunto_materiais, codigo_servico, cpf_cnpj_fornecedor, pagina, tamanho_pagina |
compras_contratos_listar | 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. params: codigo_orgao*, data_vigencia_inicial_min*, data_vigencia_inicial_max*, codigo_unidade_gestora, numero_contrato, codigo_modalidade_compra, ni_fornecedor, pagina, tamanho_pagina |
compras_contratos_consultar | Consulta um contrato no Dados Abertos (endpoint 1.1).
O upstream exige `codigo + tipo`. Tipos aceitos pela API:
`idCompra` e `numeroControlePncpContrato`.
Cache 15 min. params: codigo*, tipo |
compras_contratos_listar_por_fim_vigencia | 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. params: codigo_orgao*, data_vigencia_final_min*, data_vigencia_final_max*, codigo_unidade_gestora, pagina, tamanho_pagina |
compras_contratos_itens_listar | Lista itens de contratos (endpoint 2).
Upstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min. params: codigo_orgao*, data_vigencia_inicial_min*, data_vigencia_inicial_max*, codigo_item, tipo_item, ni_fornecedor, pagina, tamanho_pagina |
compras_contratos_item_consultar | 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 irrelevan params: codigo*, tipo_identificador, pagina, tamanho_pagina |
compras_contrato_comprasnet_consultar | 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. params: id_contrato* |
compras_contrato_comprasnet_por_uasg | 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. params: codigo_uasg*, ativos, pagina, tamanho_pagina |
compras_contrato_historico_aditivos | Lista aditivos do contrato (/api/contrato/{id}/historico).
Paginação client-side (upstream não pagina). Cache 15 min do payload completo. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_garantias | Lista garantias contratuais (/api/contrato/{id}/garantias).
Paginação client-side. Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_faturas | 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.). params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_ocorrencias | Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).
Indicador-chave da confiabilidade do fornecedor. Paginação client-side.
Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_responsaveis | Lista fiscais/gestores (/api/contrato/{id}/responsaveis).
CPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_empenhos | Lista empenhos do contrato (/api/contrato/{id}/empenhos).
Paginação client-side. Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_publicacoes | Lista publicações DOU (/api/contrato/{id}/publicacoes).
Paginação client-side. Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_contrato_cronograma | Lista cronograma financeiro (/api/contrato/{id}/cronograma).
Paginação client-side — alguns contratos têm 200+ entradas mensais.
Cache 15 min. params: id_contrato*, pagina, tamanho_pagina |
compras_listar_prompts | 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:
{
params: none |
compras_obter_prompt | 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 params: nome*, argumentos |
compras_listar_resources | 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 co params: none |
compras_obter_resource | 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. params: uri* |
compras_fornecedor_cnpj_receita | 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 v params: cnpj* |
compras_fornecedor_consultar | 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. params: cnpj_cpf* |
compras_fornecedor_listar | 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. params: cnpj, cpf, porte_empresa, codigo_cnae, natureza_juridica, ativo, pagina, tamanho_pagina |
compras_fornecedor_impedimentos_por_itens | 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. params: codigos_catmat, codigos_catser |
compras_fornecedor_contratos_por_item | 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. params: codigos_catmat, codigos_catser |
compras_indicadores_consolidados | 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 params: pagina, tamanho_pagina |
compras_indicadores_por_periodo | 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. params: ano*, mes, pagina, tamanho_pagina |
compras_uasg_listar | 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, params: pagina, tamanho_pagina, codigo_orgao, ativo |
compras_uasg_consultar | 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 `statusUa params: codigo_uasg* |
compras_orgao_listar | 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
params: pagina, tamanho_pagina, nome, esfera, poder |
compras_orgao_consultar | Consulta um órgão específico pelo código.
Devolve nome, sigla, CNPJ, esfera, poder e quantitativos.
Cache 24h. params: codigo_orgao* |
compras_pncp_orgao_unidades | 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 altern params: cnpj* |
compras_uasg_buscar | Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).
**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:
1. A rota exige `statusUasg`; sem ele devolvia 404 (mesma causa de
`compras_uasg_listar`).
2. O parâmetro `nome` **não existe** no contrato da rota e era
ignorado pelo upstream — enviá-lo devolvia o universo inteiro
(~22 mil UASGs) como se fossem result params: termo*, pagina, tamanho_pagina |
compras_pesquisar_preco_material | 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 — params: codigo_item_catalogo*, data_inicio, data_fim, uf, codigo_municipio, codigo_uasg, pagina, tamanho_pagina |
compras_detalhar_preco_material | 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, idItemCo params: codigo_item_catalogo*, data_inicio, data_fim, pagina, tamanho_pagina |
compras_pesquisar_preco_servico | 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'. params: codigo_item_catalogo*, data_inicio, data_fim, uf, codigo_municipio, codigo_uasg, pagina, tamanho_pagina |
compras_detalhar_preco_servico | 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 u params: codigo_item_catalogo*, data_inicio, data_fim, pagina, tamanho_pagina |
compras_pgc_listar | 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. params: ano*, codigo_orgao, codigo_uasg, pagina, tamanho_pagina |
compras_pgc_por_catalogo | 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]` — ** params: ano*, tipo*, codigo_item*, pagina, tamanho_pagina |
compras_pgc_agregacao | 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. params: ano*, codigo_orgao*, pagina, tamanho_pagina |
compras_pgc_listar_csv | 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. params: ano*, codigo_orgao, codigo_uasg |
compras_pncp_pca_listar | 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. params: ano*, codigo_classificacao_superior*, cnpj_orgao, pagina, tamanho_pagina |
compras_pncp_pca_atualizacao | 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. params: data_inicial*, data_final*, pagina, tamanho_pagina |
compras_pncp_pca_por_usuario | 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. params: ano*, id_usuario*, pagina, tamanho_pagina |
compras_pncp_pca_por_classificacao_superior | 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. params: ano*, codigo_classificacao_superior*, pagina, tamanho_pagina |
compras_pncp_contratacoes_publicacao | 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. params: data_inicial*, data_final*, codigo_modalidade*, uf, codigo_municipio_ibge, cnpj_orgao, esfera, pagina, tamanho_pagina |
compras_pncp_contratacoes_proposta | 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. params: data_final*, codigo_modalidade*, uf, esfera, pagina, tamanho_pagina |
compras_pncp_contratacoes_atualizacao | 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. params: data_inicial*, data_final*, codigo_modalidade*, esfera, pagina, tamanho_pagina |
compras_pncp_contratacao_por_orgao | 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. params: cnpj*, ano*, sequencial* |
compras_pncp_contratacao_itens | Lista itens de uma contratação no PNCP.
Endpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.
Cache 15 min. params: cnpj*, ano*, sequencial*, pagina, tamanho_pagina |
compras_pncp_contratacao_item_resultados | 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. params: cnpj*, ano*, sequencial*, numero_item* |
compras_pncp_contratos_listar | Lista contratos publicados no PNCP no período.
Endpoint `/v1/contratos`. Cache 15 min. params: data_inicial*, data_final*, cnpj_orgao, pagina, tamanho_pagina |
compras_pncp_contrato_por_orgao | Consulta um contrato específico no PNCP.
Endpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min. params: cnpj*, ano*, sequencial* |
compras_pncp_modalidades | 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**:
- `codigo` aqui (PNCP) é o usado em TODAS as tools `compras_pncp_*` e
em `modalidadeIdPncp` no payload de retorno.
- O Dados Abertos / SIASG usa uma enumeração diferente em
`compras_contrata params: none |
compras_pncp_contratacao_arquivos | 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` (Ed params: cnpj*, ano*, sequencial* |
compras_pncp_ata_arquivos | 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`. Dow params: cnpj*, ano_compra*, sequencial_compra*, sequencial_ata* |
compras_sancao_ceis | 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. params: cnpj, nome, orgao_sancionador, pagina |
compras_sancao_cnep | 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. params: cnpj, nome, pagina |
compras_sancao_ceaf | 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. params: cpf, nome, pagina |
compras_sancao_cepim | 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. params: cnpj, nome, pagina |
compras_sancao_acordos_leniencia | 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. params: cnpj, pagina |
compras_versao | 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). params: none |
compras_healthcheck | 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 ve params: profundidade, modulo |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.