io.github.opedrosoares/mcp-compras · v0.4.0 · data-and-databases
MCP Compras.gov.br is healthy: it completed an MCP handshake in 3039 ms and exposes 100 tools. It scores 57/100.
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)
Repository · Website · JSON · Add to my inventory
| health | 17 / 25 |
| authEase | 15 / 15 |
| toolQuality | 12 / 15 |
| maintenance | 5 / 15 |
| adoption | 0 / 10 |
| usage | 0 / 10 |
| security | 8 / 10 |
Scoring v0.3, computed 2026-10-15T06:21:00.519Z.
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-15T06:20:37.379Z | Healthy | 3039 |
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_P |
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 ante |
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. |
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 at |
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. |
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 normali |
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. |
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. |
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 (n |
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. |
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. |
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 rarament |
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. |
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. |
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 v |
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 |
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. |
compras_catser_listar_classes | Lista as classes CATSER, opcionalmente filtradas por grupo. Cache de 24h. |
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. |
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× |
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_ |
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 naturalmen |
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 devolv |
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 |
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 `co |
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='id |
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`, `valorUnitarioRes |
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`. |
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 |
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`. |
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 (`TbVwLicit |
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. |
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`. |
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 |
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. |
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. |
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 form |
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 diret |
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. |
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. |
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. |
compras_contratos_itens_listar | Lista itens de contratos (endpoint 2). Upstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min. |
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 |
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. |
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 |
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. |
compras_contrato_garantias | Lista garantias contratuais (/api/contrato/{id}/garantias). Paginação client-side. Cache 15 min. |
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.). |
compras_contrato_ocorrencias | Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias). Indicador-chave da confiabilidade do fornecedor. Paginação client-side. Cache 15 min. |
compras_contrato_responsaveis | Lista fiscais/gestores (/api/contrato/{id}/responsaveis). CPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min. |
compras_contrato_empenhos | Lista empenhos do contrato (/api/contrato/{id}/empenhos). Paginação client-side. Cache 15 min. |
compras_contrato_publicacoes | Lista publicações DOU (/api/contrato/{id}/publicacoes). Paginação client-side. Cache 15 min. |
compras_contrato_cronograma | Lista cronograma financeiro (/api/contrato/{id}/cronograma). Paginação client-side — alguns contratos têm 200+ entradas mensais. Cache 15 min. |
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 de |
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 i |
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 (ta |
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 |
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**: co |
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. |
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. |
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. |
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. |
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ósti |
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. |
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 `sta |
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/*`. |
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 40 |
compras_orgao_consultar | Consulta um órgão específico pelo código. Devolve nome, sigla, CNPJ, esfera, poder e quantitativos. Cache 24h. |
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 PN |
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 ig |
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 tra |
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 (`FtPesqPre |
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'. |
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, codigoItemCatalog |
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. |
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. **Corrig |
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. |
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. |
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. |
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. |
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. |
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. |
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 |
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. |
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. |
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. |
compras_pncp_contratacao_itens | Lista itens de uma contratação no PNCP. Endpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`. Cache 15 min. |
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. |
compras_pncp_contratos_listar | Lista contratos publicados no PNCP no período. Endpoint `/v1/contratos`. Cache 15 min. |
compras_pncp_contrato_por_orgao | Consulta um contrato específico no PNCP. Endpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min. |
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` |
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 it |
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 |
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. |
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. |
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. |
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. |
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. |
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 |
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 |