@licinexusbr/mcp

🇧🇷 Português · 🇺🇸 English version

@licinexusbr/mcp

Acesso conversacional aos dados de licitações públicas brasileiras — direto do Claude Desktop, Cursor, Continue ou qualquer cliente compatível com MCP.

Mantido pela Licinexus como contribuição open source ao ecossistema brasileiro de govtech.

📺 A demonstração acima é um script CLI chamando os mesmos adaptadores que o LLM usa, contra PNCP e BrasilAPI ao vivo. A experiência no Claude Desktop / Cursor é idêntica — mesmas ferramentas, mesmos dados, com o LLM fazendo a interpretação em linguagem natural.

O que faz

Encapsula os endpoints mais úteis do Portal Nacional de Contratações Públicas (PNCP) e dos dados de CNPJ da Receita Federal, para que um LLM consiga responder perguntas reais sobre contratações públicas brasileiras:

• "Quais editais de TI no Sudeste publicados nos últimos 7 dias com valor acima de R$ 500 mil?"
• "Existe ata de registro de preço vigente com saldo para notebook no estado de SP?"
• "Qual o histórico de contratos do CNPJ X com órgãos públicos federais nos últimos 2 anos?"
• "O que a Prefeitura de Y planeja comprar este ano segundo o PCA?"
• "Resuma este edital e me dê uma lista de verificação de viabilidade."

Instalação

npx @licinexusbr/mcp

Pronto — sem compilação, sem banco de dados, sem token de autenticação. O servidor consulta APIs públicas diretamente.

Configuração

Claude Desktop — adicione em ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

Cursor / Continue / outros clientes MCP — mesma estrutura, consulte a documentação do seu cliente para a localização do arquivo de configuração.

Reinicie o cliente MCP. As 16 ferramentas e 4 prompts ficarão disponíveis.

Ferramentas (16)

Compras / Licitações

Ferramenta	O que faz
search_licitacoes	Busca editais por data, modalidade, UF, CNPJ do órgão, valor, palavra-chave
get_licitacao	Detalhes completos de um edital pelo número de controle PNCP
list_licitacao_itens	Itens (lotes) de um edital: descrições, quantidades, valores
list_licitacao_resultados	Resultados da disputa por item: vencedores, preços, fornecedores
list_licitacao_arquivos	Documentos do edital (PDFs, anexos, termos de referência)

Contratos

Ferramenta	O que faz
search_contratos	Busca contratos por data, órgão, fornecedor, valor
get_contrato	Detalhes completos de um contrato
list_contrato_termos	Termos aditivos (prorrogações, alterações de valor/prazo)
list_contrato_instrumentos	Instrumentos de cobrança (NFes, faturas)

Atas de Registro de Preço

Ferramenta	O que faz
search_atas_rp	Busca atas de RP — apenas vigentes por padrão. Encontra contratos utilizáveis.
get_ata_rp	Detalhes completos da ata + itens (com saldo disponível) + arquivos

Órgãos / Fornecedores / PCA

Ferramenta	O que faz
get_orgao	Perfil de órgão público (poder, esfera, natureza jurídica)
get_fornecedor_contratos	Contratos públicos de um CNPJ como fornecedor
search_pca	Plano de Contratação Anual — sinal antecipado do que será comprado
list_pca_itens	Itens planejados de um PCA específico

Enriquecimento de CNPJ

Ferramenta	O que faz
get_cnpj_data	Cadastro da Receita Federal (CNAEs, sócios, capital, situação) via BrasilAPI (padrão) ou MinhaReceita (CNPJ_PROVIDER=minhareceita)

Prompts prontos (4)

Fluxos pré-construídos que seu assistente pode invocar diretamente:

Prompt	O que faz
analyze_edital	Lista de verificação de viabilidade de um edital
analyze_orgao	Perfil 360° de um órgão público
find_arp_opportunities	Encontra atas vigentes com saldo disponível para uma palavra-chave
check_supplier	Verificação básica de dado público sobre um CNPJ fornecedor

Recursos (2)

URI	Conteúdo
licitacao://modalidades	Tabela de referência de modalidades PNCP (Lei 14.133)
licinexus://scope	O que este MCP faz e o que não faz

Exemplo de sessão

Você:   Tem alguma ata de registro de preço vigente para notebooks?
Claude: [chama search_atas_rp com palavraChave="notebook", somenteVigentes=true]
        Encontrei 12 atas vigentes mencionando notebooks. As 3 mais relevantes:
        1. Ministério da Justiça — vigência até 2026-12-31, valor estimado R$ 2,4M
        2. Prefeitura de São Paulo — vigência até 2026-09-30...

Você:   Detalhes da primeira, com saldos por item?
Claude: [chama get_ata_rp includeItens=true]
        - Item 1: Notebook tipo I (16GB RAM, 512GB SSD) — saldo 1.200 unid, R$ 4.800/un
        - Item 2: Notebook tipo II ...

Roteiro de evolução

• Fase 0 — Estrutura, governança, CI
• Fase 1 — Licitações (5 ferramentas)
• Fase 2 — Contratos + Aditivos + NFes (4 ferramentas)
• Fase 3 — Atas RP (2 ferramentas)
• Fase 4 — Órgãos + Fornecedores + PCA (4 ferramentas)
• Fase 5 — CNPJ + 4 prompts + 2 recursos (1 ferramenta)
• Teste de fumaça contra APIs reais (15/15 endpoints)
• Fase 6 — Lançamento público (11/05/2026 · v0.1.0 no npm)
• Fase 7 — Adapters comunitários (TCE/TCM estaduais, ComprasNet legado)

Escopo

O que este MCP faz

• Encapsula APIs públicas do governo brasileiro (PNCP, BrasilAPI).
• Devolve dado bruto estruturado — o LLM faz a análise.
• Mantém cache local de respostas pesadas (LRU em memória, TTL curto).

O que este MCP não faz

• Não consulta nenhuma infraestrutura nem banco de dados privado da Licinexus.
• Não inclui o motor de correspondência (matchmaking), pontuação de fornecedores, agregação de preços, artefatos gerados por IA ou qualquer dado proprietário da Licinexus.
• Não substitui o produto Licinexus — é uma ferramenta open source complementar para a camada pública dos mesmos dados.

Veja docs/architecture.md para o modelo completo de separação em três paredes.

Precisa de matchmaking automático, alertas ou gestão de propostas?

O produto Licinexus é construído sobre essas mesmas fontes públicas, com motor de correspondência proprietário, pontuação inteligente e artefatos gerados por IA. Este MCP intencionalmente não replica esses recursos.

→ https://licinexus.com.br

Como contribuir

PRs são bem-vindos sob o DCO (Developer Certificate of Origin) — assine seus commits com git commit --signoff.

Por favor, abra uma issue antes para discutir qualquer mudança não trivial. Veja CONTRIBUTING.md.

Suporte

Projeto comunitário. Melhor esforço, sem SLA. Issues são triadas em até 7 dias quando possível.

Para suporte pago e funcionalidades do produto, veja licinexus.com.br.

Segurança

Encontrou uma vulnerabilidade? Veja SECURITY.md para divulgação responsável (não abra issues públicas).

Licença

MIT © Licinexus. Veja LICENSE.