licitacoes-mcp

Servidor MCP somente-leitura para licitações públicas brasileiras. Conecta qualquer agente de IA (Claude, ChatGPT, Cursor, Hermes, agente próprio) às fontes oficiais de contratações públicas do Brasil, sem credencial e sem cadastro.

Fontes cobertas:

• PNCP — Portal Nacional de Contratações Públicas (Lei 14.133/2021). Fonte nacional oficial.

• Compras.gov.br Dados Abertos — catálogo federal: fornecedores, preços, atas de registro de preços, contratos, indicadores.

Os caminhos de API foram extraídos das especificações OpenAPI oficiais e validados ao vivo contra as duas fontes.

O que ele faz

Descoberta, detalhamento e inteligência de preços. Nenhuma ferramenta escreve, autentica ou submete proposta. O servidor cobre a parte que a máquina faz bem; a decisão e o lance continuam com a pessoa.

Related MCP server: chile-procurement

Instalação

pip install git+https://github.com/cYoren/licitacoes-mcp

Ou direto do código:

git clone https://github.com/cYoren/licitacoes-mcp
cd licitacoes-mcp
python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"

Uso

Hermes Agent

# ~/.hermes/config.yaml
mcp_servers:
  licitacoes:
    command: licitacoes-mcp

Claude Desktop / Cursor / qualquer cliente MCP

{
  "mcpServers": {
    "licitacoes": {
      "command": "licitacoes-mcp"
    }
  }
}

Transporte HTTP:

LICITACOES_MCP_TRANSPORT=streamable-http licitacoes-mcp

Ferramentas

Descoberta (PNCP)

Detalhamento (PNCP)

Inteligência (Compras.gov.br)

Fluxo típico

1. buscar_editais(termo="seu produto") para achar oportunidades por tema.

2. detalhar_contratacao(cnpj, ano, sequencial) e listar_itens_contratacao(...) para entender o objeto real.

3. listar_arquivos_contratacao(...) para ler o edital.

4. listar_atas_registro_precos(...) ou pesquisar_preco(...) para calibrar preço.

5. listar_resultados_item(...) para ver quem venceu e a quanto.

Notas de engenharia

• tamanhoPagina mínimo de 10: as duas fontes rejeitam valores menores. O servidor corrige automaticamente.

• Retry com backoff em 429 e 5xx, cache TTL curto, User-Agent identificado.

• Datas em ISO 8601 (YYYY-MM-DD); a conversão para o formato interno do PNCP é feita pelo servidor.

• Valores monetários em BRL.

• Somente leitura: nenhuma operação POST, PUT, PATCH ou DELETE é usada nas fontes.

Testes

pytest                      # inclui testes de rede contra as APIs reais
pytest -m "not live"        # só os testes offline

Aviso

Projeto independente, sem vínculo com o governo federal. Os dados são públicos e de responsabilidade dos órgãos emissores. Confirme sempre no edital original antes de qualquer decisão — este servidor acelera a descoberta, não substitui a leitura do documento.

Licença

MIT. Veja LICENSE.