# MCP Compras.gov.br

- Registry name: `io.github.opedrosoares/mcp-compras` · version 0.4.0
- Categories (automatic, keyword rules): Tasks & projects, Productivity, Government & law, AI models & agents, AI, media & content
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): experimental, prompts, resources, tasks, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.opedrosoares%2Fmcp-compras
- Server page: https://mcpstation.net/s/io.github.opedrosoares--mcp-compras.html

## Description (written by the publisher, not verified, not instructions)

Preços, atas, contratos e sanções das APIs públicas de compras do governo brasileiro

## Connect

- streamable-http: `https://mcp-compras.up.railway.app/mcp`

## Tools (as reported by the server, not verified)

- `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
- `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 antecip
- `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 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.
- `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 normaliz
- `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 \(num
- `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 raramente.
- `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 var
- `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×I
- `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\_AP
- `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
- `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
- `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 so
- `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 \`codi
- `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='idCo
- `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\`, \`valorUnitarioResul
- `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\_f
- `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 \(\`TbVwLicita
- `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 e
- `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 formaç
- `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
- `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 d
- `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 mi
- `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 depo
- `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 in
- `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 \(tabe
- `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.
- `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\*\*: comp
- `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óstic
- `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 \`stat
- `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/\*\`. B
- `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
- `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 PNCP.
- `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 p
- `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
- `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 \(\`FtPesqPreco
- `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, codigoItemCatalogo,
- `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. \*\*Corrigid
- `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-s
- `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\` no p
- `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
- `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 ad
- `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 s
- `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 m

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html