{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_p3qv7emru7bq","handle":"mcp-compras-gov-br","url":"https://wellknown.network/agents/mcp-compras-gov-br","links":{"self":"https://wellknown.network/agents/mcp-compras-gov-br/record.json","html":"https://wellknown.network/agents/mcp-compras-gov-br","markdown":"https://wellknown.network/agents/mcp-compras-gov-br/record.md","api":"https://wellknown.network/api/v1/agents/mcp-compras-gov-br","status":"https://wellknown.network/api/v1/agents/mcp-compras-gov-br/status","claim":"https://wellknown.network/agents/mcp-compras-gov-br/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-compras-gov-br/claim.json","badge":"https://wellknown.network/agents/mcp-compras-gov-br/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-compras-gov-br/history","tools":"https://wellknown.network/api/v1/agents/mcp-compras-gov-br/tools"},"ard":{"identifier":"urn:air:mcp-compras.up.railway.app:server:mcp-compras-gov-br","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"MCP Compras.gov.br","summary":"Preços, atas, contratos e sanções das APIs públicas de compras do governo brasileiro","description":"Preços, atas, contratos e sanções das APIs públicas de compras do governo brasileiro","publisher":{"name":"opedrosoares","url":null},"homepage":"https://github.com/opedrosoares/MCP_Compras","repository":"https://github.com/opedrosoares/MCP_Compras","version":"0.4.0","license":null,"protocols":["mcp"],"tags":["brasil","compras","compras-gov-br","etp","lei-14133","licitacao","mcp","pncp"],"pricing":null,"endpoints":[{"url":"https://mcp-compras.up.railway.app/mcp","type":"mcp_streamable_http","auth":null,"probeable":true},{"url":"pypi:compras-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":{"updatedAt":"2026-09-09T18:52:03.166226Z","publishedAt":"2026-09-09T18:52:03.166226Z","registryName":"io.github.opedrosoares/mcp-compras"},"attribution":{"kind":"mcp_registry","name":"mcp_registry","repoUrl":"mcp_registry","summary":"mcp_registry","version":"mcp_registry","description":"mcp_registry","homepageUrl":"mcp_registry","publisherName":"mcp_registry"}},"derived":{"capabilities":[{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.948,"provenance":"derived"}],"categories":["productivity"],"language":"pt"},"observed":{"status":"live","statusReason":"Responded 6h ago.","lastOkAt":"2026-10-09T20:31:26.677Z","lastProbedAt":"2026-10-09T20:31:26.677Z","statusComputedAt":"2026-10-09T20:32:11.354Z","reliability30d":{"probes":110,"successRate":1,"p50Ms":104,"basis":"service","measures":{"availability":"availability","latency":"response time","tools":"tool surface observed","summary":"Checks reached the service itself."},"checks":{"total":110,"ok":110,"authBoundaryOk":0,"serviceOk":110,"note":"Counted from the observation rows for the window, checks of the server only (HTTP, A2A card, MCP initialize). ok = authBoundaryOk + serviceOk. `probes` is the sum of daily rollups and includes registry checks, so it can differ from `total`."}},"latestObservations":[{"at":"2026-10-09T20:31:26.677Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":102,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-09T14:31:59.675Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":100,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-09T08:28:10.743Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":105,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-09T02:27:38.054Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":96,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-08T20:25:05.507Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":104,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-08T14:22:42.797Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":99,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-08T07:24:27.937Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":104,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-08T00:24:53.934Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":104,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-07T17:30:22.871Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":109,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}},{"at":"2026-10-07T10:49:20.040Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":100,"error":null,"detail":{"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"toolCount":100,"toolsHash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","serverName":"compras-mcp","capabilities":["experimental","prompts","resources","tools","tasks"],"serverVersion":"2.14.7","protocolVersion":"2025-06-18"}}],"tools":[{"name":"compras_aggregate_contratacoes_por_periodo","description":"Série temporal de contratações no PNCP por bucket.\n\n**Modo `count` (recomendado para tendência)**: 1 chamada por bucket\nlendo apenas `totalRegistros`. Janelas g"},{"name":"compras_comparar_periodos_contratacoes","description":"Compara dois períodos lado a lado para a mesma modalidade.\n\nWrapper sobre `compras_aggregate_contratacoes_por_periodo` chamado duas\nvezes (granularidade='ano' i"},{"name":"compras_arp_listar","description":"Lista Atas de Registro de Preço (ARPs) por janela de início de vigência.\n\nEndpoint Dados Abertos `/modulo-arp/1_consultarARP`. O upstream exige\njanela `dataVige"},{"name":"compras_arp_consultar","description":"Consulta uma ARP específica pelo identificador PNCP.\n\nEndpoint Dados Abertos `/modulo-arp/1.1_consultarARP_Id`. Devolve o\ncabeçalho completo da ata (vigência, m"},{"name":"compras_arp_por_fim_vigencia","description":"Lista ARPs cuja vigência termina dentro do intervalo informado.\n\nEndpoint Dados Abertos `/modulo-arp/1.2_consultarARP_FimVigencia`.\nPermite ao gestor identifica"},{"name":"compras_arp_buscar_por_objeto","description":"Busca ARPs vigentes cujo `objeto` contém uma palavra-chave.\n\nResolve a limitação do endpoint `/modulo-arp/1.2_consultarARP_FimVigencia`,\nque não aceita filtro p"},{"name":"compras_arp_itens_listar","description":"Lista itens de ARPs na janela de vigência informada.\n\nEndpoint Dados Abertos `/modulo-arp/2_consultarARPItem`. O upstream\nexige `dataVigenciaInicialMin/Max` (ja"},{"name":"compras_arp_unidades_item","description":"Lista UGs participantes (potenciais caronas) de um item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/3_consultarUnidadesItem`. Determina\nquais unidades podem us"},{"name":"compras_arp_saldo_item","description":"Devolve o **saldo** (quantidade ainda disponível) por item da ARP.\n\nEndpoint Dados Abertos `/modulo-arp/4_consultarEmpenhosSaldoItem`.\n**Crítico para adesão**: "},{"name":"compras_arp_adesoes_item","description":"Lista adesões (caronas) já realizadas a uma ARP.\n\nEndpoint Dados Abertos `/modulo-arp/5_consultarAdesoesItem`. Mostra\nquem aderiu e com que quantidade — indica "},{"name":"compras_pncp_atas_listar","description":"Lista atas registradas no PNCP no período (federal + estadual + municipal).\n\nEndpoint PNCP `/v1/atas`. Permite encontrar atas de qualquer ente da\nfederação — ma"},{"name":"compras_catmat_listar_grupos","description":"Lista os grupos do CATMAT (Catálogo de Materiais).\n\nGrupos são o nível mais alto da hierarquia CATMAT (ex.: 10=ARMAMENTO,\n11=MATERIAIS BÉLICOS NUCLEARES). Use e"},{"name":"compras_catmat_listar_classes","description":"Lista as classes do CATMAT, opcionalmente filtradas por grupo.\n\nClasses são o segundo nível da hierarquia (ex.: dentro do grupo 71\nMobiliário, a classe 7110 é \""},{"name":"compras_catmat_consultar","description":"Consulta detalhes de um item CATMAT específico pelo código.\n\nDevolve nome do item, PDM, grupo, classe, características, NCM e\nunidades de fornecimento. Útil par"},{"name":"compras_catmat_listar_pdms","description":"Lista os PDMs (Padrão Descritivo de Material) do CATMAT.\n\nEndpoint `/modulo-material/3_consultarPdmMaterial`. É o terceiro nível da\nhierarquia do catálogo: grup"},{"name":"compras_catmat_buscar","description":"Busca itens CATMAT.\n\n**⚠️ Não existe busca por substring nesta API.** O contrato do\n`/modulo-material/4_consultarItemMaterial` oferece `descricaoItem`, que é\n**"},{"name":"compras_catser_listar_secoes","description":"Lista as seções do CATSER (Catálogo de Serviços).\n\nSeções são o nível mais alto da hierarquia CATSER (baseada no CPC ONU).\nUse para enquadrar a contratação de s"},{"name":"compras_catser_listar_classes","description":"Lista as classes CATSER, opcionalmente filtradas por grupo.\n\nCache de 24h."},{"name":"compras_catser_consultar","description":"Consulta detalhes de um item CATSER pelo código.\n\nDevolve nome do serviço, descrição, seção/divisão/grupo/classe e\nunidades de medida. Use para confirmar o códi"},{"name":"compras_pesquisar_precos_para_etp","description":"Agrega preços praticados aplicando metodologia IN SEGES/ME 65/2021.\n\nComposição: percorre `compras_pesquisar_preco_material` ou `_servico`\nem até `max_paginas`,"},{"name":"compras_checar_sancoes_fornecedor","description":"Consolida sanções de um fornecedor (CEIS + CNEP + CEPIM + leniência + impedimentos).\n\nComposição: chama em paralelo as listas do Portal da Transparência e os\nim"},{"name":"compras_montar_dossie_arp","description":"Dossiê completo de uma ARP em uma chamada.\n\nComposição: cabeçalho via `/modulo-arp/1.1` (id PNCP) e — se `numero_item`\ninformado — saldo (4), adesões (5) e unid"},{"name":"compras_buscar_contratacoes_similares","description":"Federa Dados Abertos + PNCP buscando contratações similares.\n\nComposição: consulta os **itens** de contratações 14.133 no Dados Abertos\n(`/modulo-contratacoes/2"},{"name":"compras_perfil_fornecedor_completo","description":"Perfil consolidado do fornecedor (cadastro + Receita + sanções + impedimentos).\n\nComposição em paralelo:\n- **cadastro**: Dados Abertos `/modulo-fornecedor/1_con"},{"name":"compras_contratacoes_14133_listar","description":"Lista contratações da Lei 14.133 publicadas no PNCP (via Dados Abertos).\n\nEndpoint `/modulo-contratacoes/1_consultarContratacoes_PNCP_14133`.\nCobre pregões elet"},{"name":"compras_contratacoes_14133_consultar","description":"Consulta uma contratação 14.133 pelo identificador.\n\nEndpoint `/modulo-contratacoes/1.1_consultarContratacoes_PNCP_14133_Id`.\nDevolve detalhes completos: objeto"},{"name":"compras_contratacoes_14133_itens_listar","description":"Lista itens de contratações 14.133 incluídos no período.\n\nEndpoint `/modulo-contratacoes/2_consultarItensContratacoes_PNCP_14133`.\n\n**Uso principal — pesquisa d"},{"name":"compras_contratacoes_14133_itens_por_contratacao","description":"Lista itens de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/2.1_consultarItensContratacoes_PNCP_14133_Id`.\nAceita `idCompra` ou número de "},{"name":"compras_contratacoes_14133_resultados_listar","description":"Lista resultados (homologações) de itens 14.133 no período.\n\nEndpoint `/modulo-contratacoes/3_consultarResultadoItensContratacoes_PNCP_14133`.\nDevolve fornecedo"},{"name":"compras_contratacoes_14133_resultados_por_contratacao","description":"Lista resultados (homologações) de uma contratação 14.133 específica.\n\nEndpoint `/modulo-contratacoes/3.1_consultarResultadoItensContratacoes...`.\nAceita `idCom"},{"name":"compras_legado_licitacoes_listar","description":"Lista licitações do regime legado (Lei 8.666/93).\n\nEndpoint `/modulo-legado/1_consultarLicitacao`. **Bug upstream\nconfirmado**: o filtro `uasg`, embora document"},{"name":"compras_legado_licitacao_consultar","description":"Consulta uma licitação legado pelo id_compra.\n\nEndpoint `/modulo-legado/1.1_consultarLicitacao_Id`. Upstream exige\n`id_compra` (string), não um `id` numérico."},{"name":"compras_legado_itens_licitacao_listar","description":"Lista itens de licitações legado (`/modulo-legado/2_consultarItemLicitacao`).\n\nUpstream exige `modalidade` obrigatório. Filtros opcionais: `uasg`,\n`numero_aviso"},{"name":"compras_legado_pregoes_listar","description":"Lista pregões eletrônicos do regime legado.\n\nEndpoint `/modulo-legado/3_consultarPregoes`. **Bug upstream\nconfirmado**: os filtros `co_uasg` e `co_orgao`, embor"},{"name":"compras_legado_compras_sem_licitacao","description":"Lista compras sem licitação (dispensa/inexigibilidade) do regime legado.\n\nEndpoint `/modulo-legado/5_consultarComprasSemLicitacao`. **Upstream\nexige `dt_ano_avi"},{"name":"compras_legado_rdc_listar","description":"Lista contratações pelo RDC (Regime Diferenciado de Contratações).\n\nEndpoint `/modulo-legado/7_consultarRdc`. **Upstream usa\n`data_publicacao_min/max`** (note `"},{"name":"compras_legado_itens_pregao_listar","description":"Lista itens de pregões do regime legado (Lei 8.666), com a cadeia de preço.\n\nEndpoints `/modulo-legado/4_consultarItensPregoes` (por período de\nhomologação) e `"},{"name":"compras_legado_itens_sem_licitacao_listar","description":"Lista itens de contratações diretas do regime legado (dispensa/inexigibilidade).\n\nEndpoints `/modulo-legado/6_consultarCompraItensSemLicitacao` (por ano do\navis"},{"name":"compras_contratos_listar","description":"Lista contratos federais (Dados Abertos /modulo-contratos/1).\n\nO upstream exige `codigoOrgao` + janela `dataVigenciaInicialMin/Max`\n(≤ 365 dias). Para sub-recur"},{"name":"compras_contratos_consultar","description":"Consulta um contrato no Dados Abertos (endpoint 1.1).\n\nO upstream exige `codigo + tipo`. Tipos aceitos pela API:\n`idCompra` e `numeroControlePncpContrato`.\n\nCac"},{"name":"compras_contratos_listar_por_fim_vigencia","description":"Lista contratos com vencimento na janela informada (endpoint 1.2).\n\nInventário do que precisa renovar. Upstream exige `codigoOrgao` +\n`dataVigenciaFinalMin/Max`"},{"name":"compras_contratos_itens_listar","description":"Lista itens de contratos (endpoint 2).\n\nUpstream exige `codigoOrgao + dataVigenciaInicialMin/Max`. Cache 15 min."},{"name":"compras_contratos_item_consultar","description":"Lista os itens de um contrato específico, pelo identificador.\n\nEndpoint `/modulo-contratos/2.1_consultarContratosItem_Id`.\n\nUse quando você já tem o contrato em"},{"name":"compras_contrato_comprasnet_consultar","description":"Consulta detalhe completo de um contrato no Comprasnet (/api/contrato/id/{id}).\n\nDevolve contrato com sub-recursos embutidos. CPFs mascarados por LGPD.\nCache 15"},{"name":"compras_contrato_comprasnet_por_uasg","description":"Lista contratos de uma UASG no Comprasnet.\n\n**Atenção**: o upstream `/api/contrato/ug/{uasg}` não suporta paginação —\ndevolve a lista completa em uma resposta ú"},{"name":"compras_contrato_historico_aditivos","description":"Lista aditivos do contrato (/api/contrato/{id}/historico).\n\nPaginação client-side (upstream não pagina). Cache 15 min do payload completo."},{"name":"compras_contrato_garantias","description":"Lista garantias contratuais (/api/contrato/{id}/garantias).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_faturas","description":"Lista NFs/faturas (/api/contrato/{id}/faturas).\n\nPaginação client-side. Cache 15 min. **Atenção LGPD**: o campo\n`infcomplementar` (texto livre) pode conter nome"},{"name":"compras_contrato_ocorrencias","description":"Lista ocorrências/penalidades (/api/contrato/{id}/ocorrencias).\n\nIndicador-chave da confiabilidade do fornecedor. Paginação client-side.\nCache 15 min."},{"name":"compras_contrato_responsaveis","description":"Lista fiscais/gestores (/api/contrato/{id}/responsaveis).\n\nCPFs mascarados por LGPD (`123.***.***-45`). Paginação client-side. Cache 15 min."},{"name":"compras_contrato_empenhos","description":"Lista empenhos do contrato (/api/contrato/{id}/empenhos).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_publicacoes","description":"Lista publicações DOU (/api/contrato/{id}/publicacoes).\n\nPaginação client-side. Cache 15 min."},{"name":"compras_contrato_cronograma","description":"Lista cronograma financeiro (/api/contrato/{id}/cronograma).\n\nPaginação client-side — alguns contratos têm 200+ entradas mensais.\nCache 15 min."},{"name":"compras_listar_prompts","description":"Lista os MCP Prompts disponíveis com nome, descrição e argumentos.\n\nTools de descoberta para clientes (como o Claude.ai web) que ainda\nnão expõem UI para prompt"},{"name":"compras_obter_prompt","description":"Renderiza um MCP Prompt e devolve o texto pronto.\n\nO texto retornado é o conteúdo da `PromptMessage[0]` — tipicamente um\nroteiro que orienta o LLM a executar um"},{"name":"compras_listar_resources","description":"Lista os MCP Resources disponíveis com URI, nome e mime-type.\n\nTools de descoberta para clientes que não expõem UI de attachment de\nresources (como o Claude.ai "},{"name":"compras_obter_resource","description":"Lê o conteúdo de um MCP Resource pela URI.\n\nRetorna o conteúdo bruto (texto/JSON-string conforme o mime-type\nregistrado) e os metadados do resource.\n\nRetorno:\n "},{"name":"compras_fornecedor_cnpj_receita","description":"Dados públicos do CNPJ na Receita Federal (via BrasilAPI/MinhaReceita).\n\nRetorna razão social, nome fantasia, situação cadastral, CNAE primário e\nsecundários, Q"},{"name":"compras_fornecedor_consultar","description":"Consulta cadastro de um fornecedor pelo CNPJ ou CPF.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`.\nDevolve razão social, CNAE, porte da em"},{"name":"compras_fornecedor_listar","description":"Lista fornecedores no Compras.gov.br com filtros estruturais.\n\nEndpoint Dados Abertos `/modulo-fornecedor/1_consultarFornecedor`. Use\npara mapear fornecedores p"},{"name":"compras_fornecedor_impedimentos_por_itens","description":"Consulta impedimentos no Comprasnet por lista de itens (CATMAT/CATSER).\n\nEndpoint `POST /api/comprasnet/compras/impedimentos`. Retorna fornecedores\nimpedidos de"},{"name":"compras_fornecedor_contratos_por_item","description":"Lista contratos e empenhos por itens (CATMAT/CATSER) no Comprasnet.\n\nEndpoint `POST /api/comprasnet/contratosempenhos`. Útil para descobrir\nquem fornece esses i"},{"name":"compras_indicadores_consolidados","description":"Métricas operacionais consolidadas da API Dados Abertos.\n\nEndpoint `/modulo-indicadores/1_consultarIndicadoresConsolidados`.\nRetorna: total de serviços disponív"},{"name":"compras_indicadores_por_periodo","description":"Métricas operacionais da API por período (ano/mês).\n\nEndpoint Dados Abertos `/modulo-indicadores/2_consultarIndicadoresPorPeriodo`.\nRetorna métricas de USO da A"},{"name":"compras_uasg_listar","description":"Lista UASGs (Unidades Administrativas de Serviços Gerais) do governo.\n\n**✅ Restaurada em 2026-08-05.** Da v0.2.x até a v0.3.12 esta tool\ndevolvia \"endpoint indi"},{"name":"compras_uasg_consultar","description":"Consulta uma UASG específica pelo código.\n\nDevolve nome, sigla, CNPJ vinculado, órgão superior e endereço.\nÚtil para resolver `codigo_uasg` antes de consultas f"},{"name":"compras_orgao_listar","description":"Lista órgãos cadastrados no Compras.gov.br.\n\nEndpoint Dados Abertos `/modulo-uasg/2_consultarOrgao`. Inclui órgãos\ndo SISG (Sistema de Serviços Gerais), com cód"},{"name":"compras_orgao_consultar","description":"Consulta um órgão específico pelo código.\n\nDevolve nome, sigla, CNPJ, esfera, poder e quantitativos.\nCache 24h."},{"name":"compras_pncp_orgao_unidades","description":"Lista unidades administrativas de um órgão no PNCP.\n\nEndpoint PNCP `/v1/orgaos/{cnpj}/unidades`. Útil para descobrir códigos\nde unidade antes de filtrar contrat"},{"name":"compras_uasg_buscar","description":"Busca UASGs por trecho do nome (match parcial, ignora acento e caixa).\n\n**✅ Restaurada em 2026-08-05, com busca local.** Duas correções:\n\n1. A rota exige `statu"},{"name":"compras_pesquisar_preco_material","description":"Pesquisa preços praticados em compras de material (CATMAT) pelo governo.\n\nEndpoint Dados Abertos: `/modulo-pesquisa-preco/1_consultarMaterial`.\nPara visão conso"},{"name":"compras_detalhar_preco_material","description":"Lista as compras individuais de um item CATMAT — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/2_consultarMaterialDetalhe`.\n\n**⚠️ Esta tool não dev"},{"name":"compras_pesquisar_preco_servico","description":"Pesquisa preços praticados em compras de serviço (CATSER).\n\nEndpoint: `/modulo-pesquisa-preco/3_consultarServico`. Para visão\nconsolidada (mediana, média, desvi"},{"name":"compras_detalhar_preco_servico","description":"Lista as compras individuais de um serviço CATSER — **sem valor de preço**.\n\nEndpoint: `/modulo-pesquisa-preco/4_consultarServicoDetalhe`.\n\n**⚠️ Esta tool não d"},{"name":"compras_pgc_listar","description":"Lista itens de PGC (Plano de Gestão de Contratações) do governo federal.\n\nEndpoint Dados Abertos `/modulo-pgc/1_consultarPgcDetalhe`. Cada linha\nrepresenta um i"},{"name":"compras_pgc_por_catalogo","description":"Lista todos os PGCs que incluem determinado item de catálogo (CATMAT/CATSER).\n\nEndpoint Dados Abertos `/modulo-pgc/2_consultarPgcDetalheCatalogo`.\nÚtil para res"},{"name":"compras_pgc_agregacao","description":"Resumo agregado do PGC de um órgão num ano (totais por categoria).\n\nEndpoint Dados Abertos `/modulo-pgc/3_consultarPgcAgregacao`. Retorna\ncontagens e valores to"},{"name":"compras_pgc_listar_csv","description":"Versão CSV de `compras_pgc_listar` (mesmo dataset, formato planilha).\n\nEndpoint `/modulo-pgc/1.1_consultarPgcDetalhe_CSV`. Útil para colar no\nETP ou planilhar l"},{"name":"compras_pncp_pca_listar","description":"Lista PCAs (Planos Anuais de Contratações) no PNCP.\n\nEndpoint PNCP `/v1/pca/`. Diferente do PGC, o PCA da Lei 14.133 cobre\nfederais + estaduais + municipais. Fi"},{"name":"compras_pncp_pca_atualizacao","description":"Lista PCAs atualizados num período (PNCP).\n\nEndpoint PNCP `/v1/pca/atualizacao`. Útil para monitoramento: descobrir\nquais órgãos revisaram seu PCA recentemente."},{"name":"compras_pncp_pca_por_usuario","description":"Lista PCAs vinculados a um usuário/sistema integrador específico.\n\nEndpoint PNCP `/v1/pca/usuario`. Uso menos comum — geralmente o\nanalista prefere `compras_pnc"},{"name":"compras_pncp_pca_por_classificacao_superior","description":"Lista itens de PCA filtrados por categoria superior do item.\n\nEndpoint PNCP `/v1/pca/` com `codigoClassificacaoSuperior`. Permite\nagregar planejamentos por cate"},{"name":"compras_pncp_contratacoes_publicacao","description":"Lista contratações publicadas no PNCP no período.\n\nEndpoint `/v1/contratacoes/publicacao`. Cobre todos os entes da\nfederação. Modalidades comuns: 6=Pregão Eletr"},{"name":"compras_pncp_contratacoes_proposta","description":"Lista contratações com prazo de proposta aberto no PNCP.\n\nEndpoint `/v1/contratacoes/proposta`. Útil para mapear oportunidades\nabertas para fornecedores ou para"},{"name":"compras_pncp_contratacoes_atualizacao","description":"Lista contratações alteradas no período (PNCP).\n\nEndpoint `/v1/contratacoes/atualizacao`. Útil para monitoramento:\ndescobrir editais que sofreram retificações/r"},{"name":"compras_pncp_contratacao_por_orgao","description":"Consulta uma contratação específica pelo CNPJ + ano + sequencial.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}`. Devolve\ncabeçalho completo da contra"},{"name":"compras_pncp_contratacao_itens","description":"Lista itens de uma contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens`.\nCache 15 min."},{"name":"compras_pncp_contratacao_item_resultados","description":"Lista resultados (vencedores) de um item específico de contratação no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/itens/{n}/resultados`.\nCache"},{"name":"compras_pncp_contratos_listar","description":"Lista contratos publicados no PNCP no período.\n\nEndpoint `/v1/contratos`. Cache 15 min."},{"name":"compras_pncp_contrato_por_orgao","description":"Consulta um contrato específico no PNCP.\n\nEndpoint `/v1/orgaos/{cnpj}/contratos/{ano}/{sequencial}`. Cache 15 min."},{"name":"compras_pncp_modalidades","description":"Cheat sheet local: códigos de modalidade de contratação do PNCP.\n\nTool local (não chama upstream). Fonte: tabela oficial PNCP (Lei 14.133).\n\n**ATENÇÃO — duas ta"},{"name":"compras_pncp_contratacao_arquivos","description":"Lista os ARQUIVOS anexos de uma contratação no PNCP (Edital, TR, ETP...).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{ano}/{sequencial}/arquivos` da API\npública de ar"},{"name":"compras_pncp_ata_arquivos","description":"Lista os ARQUIVOS de uma Ata de Registro de Preços no PNCP (ata + aditivos).\n\nEndpoint `/v1/orgaos/{cnpj}/compras/{anoCompra}/{sequencialCompra}/atas/{sequencia"},{"name":"compras_sancao_ceis","description":"Consulta CEIS — Cadastro de Empresas Inidôneas e Suspensas.\n\nEndpoint `/api-de-dados/ceis`. Empresas com sanção ativa não podem\ncontratar com a administração pú"},{"name":"compras_sancao_cnep","description":"Consulta CNEP — Cadastro Nacional de Empresas Punidas (Lei Anticorrupção).\n\nEndpoint `/api-de-dados/cnep`. Empresas punidas pela Lei 12.846/2013\n(Lei Anticorrup"},{"name":"compras_sancao_ceaf","description":"Consulta CEAF — Cadastro de Expulsões da Administração Federal.\n\nEndpoint `/api-de-dados/ceaf`. Servidores expulsos do serviço público\nfederal. Útil quando se i"},{"name":"compras_sancao_cepim","description":"Consulta CEPIM — Entidades Privadas Sem Fins Lucrativos Impedidas.\n\nEndpoint `/api-de-dados/cepim`. Aplicável a contratações via convênios\ne termos de fomento c"},{"name":"compras_sancao_acordos_leniencia","description":"Lista acordos de leniência firmados com a CGU.\n\nEndpoint `/api-de-dados/acordos-leniencia`. Empresas com acordo ativo\nestão sob compromisso de compliance reforç"},{"name":"compras_versao","description":"Healthcheck/diagnóstico do MCP. Retorna versão, fontes upstream e\nestado de configurações sensíveis (sem expor valores).\n\nÚtil para confirmar que o servidor est"},{"name":"compras_healthcheck","description":"Diz, em ~30 segundos, o que está de pé neste servidor **agora**.\n\nEstende `compras_versao`: além de versão e configuração, dispara um\nprobe paralelo (timeout cu"}],"package":{"name":"compras-mcp","registry":"pypi","observedAt":"2026-10-09T20:33:22.611Z","publishedAt":"2026-09-09T18:51:53.259276Z","latestVersion":"0.4.0"},"toolSurface":{"id":"ts_p7gj3whguhre","endpointId":"ep_fqw27q64qmh9","hash":"7b4cb2781dcd3394369056cb541bf604a8bf4482334e3f50679f05f6d960602c","toolCount":100,"serverName":"compras-mcp","serverVersion":"2.14.7","protocolVersion":"2025-06-18","firstSeenAt":"2026-09-12T11:27:11.314Z","lastSeenAt":"2026-10-09T20:31:26.745Z","observations":102,"toolNames":["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"],"distinctSurfaces":1},"endpointFacts":[{"id":"ep_fqw27q64qmh9","url":"https://mcp-compras.up.railway.app/mcp","type":"mcp_streamable_http","factsCheckedAt":"2026-10-08T00:24:53.966Z","auth":{"observedAt":"2026-10-08T00:24:54.078Z","authRequired":false,"scheme":null,"resourceMetadata":null,"authorizationServer":null,"conformance":{"dpop":false,"rfc8414":false,"rfc9728":false,"pkceS256":false,"clientIdMetadataDocument":false,"dynamicClientRegistration":false}},"tls":{"observedAt":"2026-10-08T00:24:54.091Z","protocol":"TLSv1.3","chainValid":true,"chainError":null,"hostMatches":true,"subject":"*.up.railway.app","issuer":{"commonName":"YE2","organization":"Let's Encrypt"},"validFrom":"2026-09-27T03:01:43.000Z","validTo":"2026-12-26T03:01:42.000Z","daysToExpiry":77,"sanCount":2,"fingerprint256":"FB:37:0C:A2:68:42:DA:2B:2F:F8:E3:18:2E:0E:8C:FC:6F:B8:EA:C3:2C:DB:57:18:F4:5A:4B:39:B9:E1:40:AF"}}]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"compras-mcp","url":"https://pypi.org/project/compras-mcp/","firstSeenAt":"2026-09-08T20:19:25.188Z","fetchedAt":"2026-10-09T17:23:21.204Z","normalizedAt":"2026-10-09T17:23:21.204Z"},{"source":"mcp_registry","key":"io.github.opedrosoares/mcp-compras","url":"https://registry.modelcontextprotocol.io/v0/servers/io.github.opedrosoares%2Fmcp-compras","firstSeenAt":"2026-09-08T20:19:13.076Z","fetchedAt":"2026-10-07T23:21:27.659Z","normalizedAt":"2026-10-07T23:21:27.659Z"}]},"firstSeenAt":"2026-09-08T20:19:13.076Z","updatedAt":"2026-10-09T20:33:22.611Z"}