Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/中文
Sign inSign up
Home/Servers/Licinexus

Licinexus

I
by io.github.Licinexus

Brazilian public procurement (PNCP) and Federal Revenue CNPJ data — 16 tools, 4 prompts.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
npx -y @licinexusbr/[email protected]
Credentials from the publisher
  • CNPJ_PROVIDER — CNPJ data provider. Options: 'brasilapi' (default) or 'minhareceita'. Both are free public APIs — no key required.
Provider
Claude Code
CNPJ_PROVIDER=<value> claude mcp add io.github.licinexus-mcp -- npx -y @licinexusbr/[email protected]

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.licinexus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@licinexusbr/[email protected]"
      ],
      "env": {
        "CNPJ_PROVIDER": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • Firecrawl🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.
  • M
    mcp-builderGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate externa
  • browser-testing-with-devtoolsTests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests,

Brazilian public procurement (PNCP) and Federal Revenue CNPJ data — 16 tools, 4 prompts.


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."

🚀 Como usar

Pré-requisitos

  • Node.js 18 ou superior instalado (nodejs.org)
  • Qualquer cliente compatível com MCP (lista abaixo)

Nenhuma chave de API, nenhum cadastro, nenhum banco local — o servidor consulta endpoints públicos diretamente.

⚠️ Importante: Este é um servidor MCP stdio-based. Você não roda ele diretamente no terminal — é o cliente MCP (Claude Desktop, Cursor, etc.) que invoca o servidor quando precisa, e a comunicação acontece por JSON-RPC via stdin/stdout. Se você executar npx @licinexusbr/mcp direto no terminal, vai parecer que "travou" — é normal, o servidor está esperando o cliente conectar.

Da mesma forma, npx -y @licinexusbr/mcp não é uma instalação global — apenas baixa o pacote pra um cache local (~/.npm/_npx/) e executa. O cliente MCP invoca npx toda vez que precisa do servidor; execuções subsequentes usam o cache e são instantâneas. (Você também pode usar npm exec em vez de npx — são equivalentes.)


1. Claude Desktop ⭐ (recomendado)

Caminho A — Via UI (Claude Desktop ≥ 4.x)
  1. Abra o Claude Desktop
  2. Cmd + , (macOS) ou Ctrl + , (Windows) → Configurações
  3. Barra lateral → Conectores
  4. Clica em "Editar Configuração" (Aplicativo desktop → Desenvolvedor)
  5. Abre o arquivo claude_desktop_config.json no seu editor

Substitua (ou adicione dentro de mcpServers):

{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}
  1. Salve o arquivo (Cmd+S)
  2. Encerre o Claude completamente (Cmd+Q — não basta fechar a janela) e reabra
Caminho B — Editando o arquivo direto
SOCaminho
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
LinuxNão oficialmente suportado pelo Claude Desktop ainda
Como verificar que funcionou

Após reabrir, na conversa nova:

  • Em Configurações → Conectores → licinexus, você deve ver 18 ferramentas listadas (search_licitacoes, get_cnpj_data, etc.)
  • No campo de prompt, digite:
Quais ferramentas do licinexus você tem disponíveis?

O Claude deve listar as 18 ferramentas. Pode prosseguir.

Primeiros prompts para testar
Me mostra os dados do CNPJ 00000000000191 (Banco do Brasil)
Tem ata de registro de preço vigente para notebook em São Paulo com saldo disponível?
O que a Prefeitura de Juiz de Fora planeja comprar este ano segundo o PCA?
Quais editais de tecnologia da informação foram publicados nos últimos 7 dias acima de R$ 200 mil?

2. Cursor

Cursor suporta MCP servers nativamente. Crie/edite o arquivo ~/.cursor/mcp.json:

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

Ou via UI: Cursor → Settings → MCP → Add new MCP server.

Reinicie o Cursor. As ferramentas aparecem no chat do Composer.


3. Continue.dev (VS Code / JetBrains)

Edite o arquivo ~/.continue/config.json (ou config.yaml):

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

Recarregue o Continue (Cmd+Shift+P → "Continue: Reload"). As ferramentas ficam disponíveis no chat.


4. Cline / Roo Code (extensão VS Code)

Pela UI do Cline:

  1. Abra a extensão Cline na sidebar do VS Code
  2. Ícone de configurações → MCP Servers → Edit MCP Settings
  3. Adicione:
{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

5. Zed editor

Edite ~/.config/zed/settings.json (macOS/Linux) e adicione:

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

Reinicie o Zed.


6. ChatGPT

O ChatGPT consumer (web) não suporta MCP stdio nativamente até o momento. Mas dá pra usar via:

Via OpenAI Agents SDK (Python)
from openai import OpenAI
from openai.agents import Agent, MCPServerStdio

server = MCPServerStdio(
    command="npx",
    args=["-y", "@licinexusbr/mcp"]
)

agent = Agent(
    name="Licinexus Assistant",
    instructions="Você é um analista de licitações públicas brasileiras.",
    mcp_servers=[server]
)
ChatGPT Desktop

Versões recentes têm suporte limitado a MCP — verifique a documentação oficial da OpenAI para o estado atual.


7. Programaticamente (qualquer LLM via stdio)

Você pode chamar o servidor diretamente via stdio em qualquer linguagem que suporte o protocolo JSON-RPC do MCP. Exemplo Node:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', '@licinexusbr/mcp'],
});

const client = new Client({ name: 'meu-app', version: '1.0.0' }, { capabilities: {} });
await client.connect(transport);

const tools = await client.listTools();
console.log(tools);

const result = await client.callTool({
  name: 'search_atas_rp',
  arguments: { palavraChave: 'notebook', somenteVigentes: true },
});

🔧 Troubleshooting

"Server failed to start" ou "command not found: npx"

Causa: Claude Desktop / outro cliente não acha o npx no PATH.

Solução: use o caminho absoluto. Descubra com:

which npx

E substitua no config:

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

"Ferramentas não aparecem após salvar config"

Solução: reinicie o cliente completamente. No Mac, Cmd+Q (não basta fechar a janela). MCP servers só são carregados na inicialização.

"EACCES" ou erro de permissão

Causa: cache do npx corrompido ou permissão de escrita.

Solução:

npm cache clean --force
npx -y @licinexusbr/mcp

Versão antiga sendo executada

Causa: npx mantém cache. Para forçar a versão mais recente:

npx -y @licinexusbr/mcp@latest

E no config:

"args": ["-y", "@licinexusbr/mcp@latest"]

Timeout em consultas grandes

Algumas consultas (busca por palavra-chave ampla, datas longas) podem demorar — o PNCP às vezes leva 15-30s para responder. O servidor já implementa retry budget. Se persistir, refine a consulta com filtros mais específicos.

Logs e debug

Para inspecionar requisições/respostas, rode manualmente no terminal:

LICINEXUS_LOG_LEVEL=debug npx -y @licinexusbr/mcp

E em outra janela, observe os logs enquanto o cliente faz chamadas.

Idioma das mensagens de erro

Por padrão, as mensagens de erro retornadas pelas tools estão em português. Para recebê-las em inglês:

LICINEXUS_LANG=en npx -y @licinexusbr/mcp

Valores aceitos: pt (padrão) ou en.

Ferramentas (18)

Compras / Licitações

FerramentaO que faz
search_licitacoesBusca editais por data, modalidade, UF, CNPJ do órgão, valor, palavra-chave
get_licitacaoDetalhes completos de um edital pelo número de controle PNCP
list_licitacao_itensItens (lotes) de um edital: descrições, quantidades, valores
list_licitacao_resultadosResultados da disputa por item: vencedores, preços, fornecedores
list_licitacao_arquivosDocumentos do edital (PDFs, anexos, termos de referência)

Contratos

FerramentaO que faz
search_contratosBusca contratos por data, órgão, fornecedor, valor
get_contratoDetalhes completos de um contrato
list_contrato_termosTermos aditivos (prorrogações, alterações de valor/prazo)
list_contrato_instrumentosInstrumentos de cobrança (NFes, faturas)

Atas de Registro de Preço

FerramentaO que faz
search_atas_rpBusca atas de RP — apenas vigentes por padrão. Encontra contratos utilizáveis.
get_ata_rpDetalhes completos da ata + itens (com saldo disponível) + arquivos

Órgãos / Fornecedores / PCA

FerramentaO que faz
get_orgaoPerfil de órgão público (poder, esfera, natureza jurídica)
get_fornecedor_contratosContratos públicos de um CNPJ como fornecedor
search_pcaPlano de Contratação Anual — sinal antecipado do que será comprado
list_pca_itensItens planejados de um PCA específico

Enriquecimento de CNPJ

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

Análise agregada (v0.2.0)

FerramentaO que faz
aggregate_licitacoes_por_periodoSérie temporal de contagem (e opcional valor) sobre janela de até 5 anos, com bucketing dia/semana/mês/ano. Filtros por modalidade, UF, município, CNPJ, esfera de governo
compare_periodosCompara dois períodos lado-a-lado retornando totais + delta absoluto e percentual. Útil pra perguntas tipo "houve antecipação em ano eleitoral?"

Prompts prontos (4)

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

PromptO que faz
analyze_editalLista de verificação de viabilidade de um edital
analyze_orgaoPerfil 360° de um órgão público
find_arp_opportunitiesEncontra atas vigentes com saldo disponível para uma palavra-chave
check_supplierVerificação básica de dado público sobre um CNPJ fornecedor

Recursos (2)

URIConteúdo
licitacao://modalidadesTabela de referência de modalidades PNCP (Lei 14.133)
licinexus://scopeO 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.

How do I install Licinexus?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Licinexus need an API key?
The publisher lists these environment variables: CNPJ_PROVIDER.
What transport does Licinexus use?
Licinexus runs locally over stdio.
When was Licinexus last checked?
Last checked 2026-10-16. Brazilian public procurement (PNCP) and Federal Revenue CNPJ data — 16 tools, 4 prompts.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA