Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@licitacoes-mcp buscar editais sobre capacitação de profissionais de saúde"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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: mcp-ecuador-procurement
pip install git+https://github.com/cYoren/licitacoes-mcpOu 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]"# ~/.hermes/config.yaml
mcp_servers:
licitacoes:
command: licitacoes-mcp{
"mcpServers": {
"licitacoes": {
"command": "licitacoes-mcp"
}
}
}Transporte HTTP:
LICITACOES_MCP_TRANSPORT=streamable-http licitacoes-mcpFerramenta | Para que serve |
| Pesquisa full-text nacional por tema. Ex.: "capacitação de profissionais de saúde". |
| Volume publicado em um período, por modalidade. |
| Tudo que ainda aceita proposta até uma data. |
| Contratos firmados em um período. |
| Atas publicadas: preço de referência do governo. |
Ferramenta | Para que serve |
| Registro completo a partir de CNPJ + ano + sequencial. |
| Itens, quantidades e valor unitário estimado. |
| Edital, termo de referência e anexos, com link. |
| Quem ganhou e por quanto. |
Ferramenta | Para que serve |
| Cadastro federal de fornecedores por CNPJ. |
| Preços praticados de material no catálogo federal. |
| Histórico contratual de um órgão federal. |
| Atas de registro de preços federais vigentes. |
| Indicadores consolidados de compras federais. |
| Códigos de modalidade usados pelas outras ferramentas. |
buscar_editais(termo="seu produto") para achar oportunidades por tema.
detalhar_contratacao(cnpj, ano, sequencial) e listar_itens_contratacao(...) para entender o objeto real.
listar_arquivos_contratacao(...) para ler o edital.
listar_atas_registro_precos(...) ou pesquisar_preco(...) para calibrar preço.
listar_resultados_item(...) para ver quem venceu e a quanto.
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.
pytest # inclui testes de rede contra as APIs reais
pytest -m "not live" # só os testes offlineProjeto 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.
MIT. Veja LICENSE.
Pesquisa editais e contratações por palavra-chave no PNCP (índice full-text nacional). Use para descobrir oportunidades por tema, ex.: 'capacitação de profissionais de saúde'.
Inputs: termo (required), pagina, status, ordenacao, +1 more. Returns: object
Contratos de um órgão federal específico (codigoOrgao) vigentes em uma janela de datas. Mostra o histórico contratual daquele órgão.
Inputs: codigo_orgao (required), vigencia_inicial_max (required), vigencia_inicial_min (required), pagina, +1 more. Returns: object
Consulta o cadastro de fornecedores do governo federal. Informe um CNPJ para ver a situação de um fornecedor específico, ou deixe vazio para listar fornecedores ativos.
Inputs: cnpj, ativo, pagina, tamanho_pagina. Returns: object
Detalhe completo de uma contratação do PNCP a partir de CNPJ do órgão, ano e número sequencial. Esses três campos vêm em 'listar_oportunidades_abertas'.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: object
Indicadores consolidados de compras públicas federais. Visão agregada de volume e valores.
Inputs: pagina, tamanho_pagina. Returns: object
Atas de registro de preços federais vigentes em uma janela de datas, com link para a ata e para a compra no PNCP.
Inputs: vigencia_inicial_max (required), vigencia_inicial_min (required), pagina, tamanho_pagina. Returns: object
Documentos de uma contratação (edital, termo de referência, anexos) com link de download. Geralmente PDF.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: result
Atas de registro de preços publicadas no PNCP em um intervalo. Referência de preços já registrados por órgãos públicos, útil para calibrar proposta.
Inputs: data_final (required), data_inicial (required), pagina, tamanho_pagina. Returns: object
Lista contratações publicadas no PNCP em um intervalo de datas, por modalidade. Sem filtro de tema: use para medir volume ou varrer um período. Modalidade 6 = Pregão Eletrônico.
Inputs: data_final (required), data_inicial (required), pagina, modalidade, +1 more. Returns: object
Contratos públicos firmados no PNCP em um intervalo de datas. Serve para mapear quem já contrata o que você vende.
Inputs: data_final (required), data_inicial (required), pagina, tamanho_pagina. Returns: object
Itens de uma contratação com descrição, quantidade, unidade e valor unitário estimado. É aqui que se vê o que o órgão realmente compra e por quanto estima pagar.
Inputs: ano (required), cnpj (required), sequencial (required). Returns: result
Tabela de códigos de modalidade de contratação do PNCP. Consulte antes de passar 'modalidade' para as outras ferramentas.
Inputs: no named parameters. Returns: result
Lista contratações que ainda aceitam proposta até uma data limite. É a lista de oportunidades em aberto, já ordenável por prazo.
Inputs: data_final (required), pagina, modalidade, tamanho_pagina. Returns: object
Resultado homologado de um item: quem ganhou e por qual preço. Use para saber o preço praticado e o fornecedor vencedor de uma disputa encerrada.
Inputs: ano (required), cnpj (required), sequencial (required), numero_item (required). Returns: result
Pesquisa de preços de materiais no catálogo federal. tipo='codigoItemCatalogo' ou 'codigoPdm' e codigo é o código do item. Devolve preços praticados em compras públicas.
Inputs: codigo (required), tipo, pagina, tamanho_pagina. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 15 tools
Most tools target a clearly distinct resource+action (search editais, detail a contratação, list items/arquivos/resultados, consult a supplier), and descriptions actively disambiguate the 'list by date vs list open' split. Two pairs overlap somewhat: listar_atas_registro_precos vs listar_arp_vigentes, and listar_contratos_publicados vs consultar_contratos_orgao, though the descriptions clarify the differing filters.
Nearly all names follow a consistent snake_case verb_noun pattern (buscar_, listar_, detalhar_, consultar_, pesquisar_). Minor deviations: 'indicadores_compras' uses noun_noun, and there is a slight verb-variant inconsistency between buscar_ and pesquisar_ for search operations.
15 tools is well within a healthy range and each maps to a concrete PNCP data need (discovery, detail, items, documents, results, contracts, price references, supplier lookup, modality codes). No apparent redundant or filler tools.
The surface covers the procurement discovery lifecycle thoroughly: keyword/date search, open opportunities, detail, items, documents, results, contracts, price registration, price research, supplier lookup, and indicator aggregates. As a read-only public-data API this is near-complete; minor gaps like direct bidder/dispute listings exist but aren't essential.
Query Brazil's public procurement portal (PNCP): tenders, contracts and price records.
Search Brazilian government tenders and public procurement (PNCP): find notices and auctions by keyw
Monitor live government contracts and tenders across US Federal awards, EU TED OJ S & Brazil PNCP.
Search open Spanish public-sector tenders, updated daily, and estimate an offer. Read-only.