io.github.bitbusca由 GitHub 账号 bitbusca 发布v0.1.0更新于 Nov 6, 2026
Prazos com feriados forenses por comarca, DJEN, editais do PNCP, índices do BCB e CNPJ.
面向巴西律师与投标人的工具集：带法院假期的诉讼期限计算、DJEN 公告、PNCP 招标、央行指数与 CNPJ 查询。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
English summary.
juris-licita-mcpis an open-source Model Context Protocol server for Brazilian lawyers and public-procurement bidders. One line:npx juris-licita-mcp. Free and keyless: procedural deadlines with court holidays per court and district (CPC, CLT, DJEN publication rules, electronic summons, doubled deadlines, year-end recess) with the source of every skipped day, a catalog of statutory deadlines, business-day math, official Central Bank indices with inflation adjustment, open tenders from PNCP, CPF/CNPJ checksum validation (local), ZIP code and basic company data. Advanced tools (DJEN court publications by bar number, lawsuits, AI tender analysis, buyer score, lawyer lookup, real estate) proxy to the BitBusca remote MCP and need aBITBUSCA_API_KEY(free test key with fictitious data). No personal data, no telemetry. MIT licensed. Docs below are in Portuguese.
Prazos com feriado forense da comarca, editais abertos e correção monetária, direto no Claude, no Cursor ou no VS Code. Para quem advoga e para quem licita. Uma linha para instalar, sem cadastro, sem chave.
Chamada direta da ferramenta contar_dias_uteis pelo protocolo MCP (stdio), sem cliente de IA no meio, com o
script docs/demo-chamada.mjs. No Claude, no Cursor ou no VS Code a resposta é a mesma.
Gravado com a versão 0.1.0; a saída é a real da ferramenta.
Advocacia
Licitações
Com a chave da BitBusca (modo avançado):
Precisa do Node.js 20 ou mais novo. Nada mais.
Com o modo avançado:
Use --scope user para ter em todos os projetos.
Em Configurações → Desenvolvedor → Editar configuração (claude_desktop_config.json):
Deixe BITBUSCA_API_KEY vazio para usar só o grátis. Reinicie o Claude Desktop.
Windows: se o Claude Desktop não achar o
npx, use"command": "cmd"e"args": ["/c", "npx", "-y", "juris-licita-mcp"].
Arquivo ~/.cursor/mcp.json (global) ou .cursor/mcp.json (no projeto):
Arquivo .vscode/mcp.json. O VS Code pergunta a chave na primeira vez e guarda com segurança (pode deixar em branco):
No modo HTTP, o cabeçalho Authorization: Bearer bk_… de cada pedido vale como a chave daquele pedido. Por padrão ouve só em 127.0.0.1, com proteção contra DNS rebinding e limite de 60 chamadas por minuto por IP. Se for expor na internet, ponha um proxy com TLS na frente.
* Sem chave, CEP e CNPJ usam a consulta pública da BitBusca, com cota por conexão: 300 CEPs e 50 CNPJs diferentes por dia. O CNPJ vem só da base própria (cadastro público da Receita), sem sócios, telefone ou e-mail; no MEI e no empresário individual, o endereço sai só com bairro, cidade e UF. Consultas de CNPJ em sequência (raiz +1, +2…) pausam a consulta sem chave daquela conexão por 24 horas. Quando a cota acaba, a ferramenta diz isso e, se houver chave, segue por ela (com a chave, CEP é grátis e CNPJ custa 1 crédito).
Sem chave, toda ferramenta avançada responde normalmente dizendo o que faria e como ligar. Nada quebra.
O calendário forense completo (portarias do ano, feriados municipais, pontos facultativos, recesso) vem do prazos-br e cobre hoje 22 tribunais: TJSP, TJRJ, TJMG, TJRS, TJPR, TJSC, TJBA, TJGO, TJPE, TJDFT e TJMS; TRF1, TRF2, TRF4, TRF5 e TRF6; TRT1, TRT2, TRT3, TRT4, TRT15 e TRT24. Na maioria, a capital ou sede tem os feriados municipais; no TJMS e no TRT24, também o interior. A cobertura por ano está em COBERTURA.md. Nos demais tribunais o cálculo usa os feriados nacionais, o recesso e a suspensão de 20/12 a 20/01 (CPC art. 220), e avisa na resposta que o vencimento real pode ser posterior. Outros tribunais em breve; o formato é aberto e aceita contribuição no prazos-br. Pergunte à IA "quais tribunais estão cobertos?" para ver a lista atual.
bk_test_…): grátis, sem prazo, devolve dados fictícios. Boa para montar e testar.BITBUSCA_API_KEY na configuração do MCP e reinicie o app de IA.As ferramentas avançadas repassam a chamada ao MCP oficial da BitBusca no perfil Empresas (https://api.bitbusca.net/api/v1/mcp/empresas), o mesmo dos diretórios de conectores: sem pessoa física como resultado principal, credencial só no cabeçalho.
Como a cobrança funciona
analisar_edital e resumo_edital chamadas sem confirmar devolvem só o custo em créditos, o saldo e se você já pagou por aquela análise (grátis). Só com confirmar: true executam e cobram, uma vez por edital a cada 30 dias.validar_documento só confere a matemática do número. consultar_cnpj não traz sócios, telefone nem e-mail; no MEI e no empresário individual o endereço sai só com bairro, cidade e UF; sequência com cara de CPF dentro de texto vira ***.***.***-**. As avançadas usam o perfil Empresas, que filtra pessoa física do lado do servidor (publicações judiciais trazem os nomes como saíram no diário oficial).User-Agent: juris-licita-mcp/<versão>, para a fonte saber quem é.429 respeitando Retry-After. Nada de varredura.JURIS_LICITA_MCP_DEBUG=1 (vai só para o stderr local).Testar no Claude Code sem publicar:
Estrutura: src/ferramentas/ (uma por assunto), src/servidor.ts (registro das ferramentas), src/index.ts (stdio e HTTP), test/ (testes com fixtures reais recortadas em test/fixtures/).
Contribuições são bem-vindas: abra uma issue antes de mudanças grandes. Calendário de tribunal novo vai no prazos-br; ferramenta grátis nova (sempre de dado público e sem pessoa física) vem para cá.
来源：README.md，提交 8ee9cb2
Validar CPF ou CNPJ
Confere o dígito verificador de um CPF ou CNPJ (inclusive o CNPJ alfanumérico de 2026). Roda na sua máquina: não consulta nenhuma base, não diz se o documento existe nem de quem é. O CPF volta só mascarado.
tipodocumento必填Calcular prazo processual
Vencimento de prazo processual com passo a passo: CPC (dias úteis), CLT, dias corridos, publicação no DJEN (a data informada é a disponibilização), intimação eletrônica com ciência ficta de 10 dias, prazo em dobro, recesso e suspensão de 20/12 a 20/01, feriados forenses do tribunal e feriados municipais da comarca, cada dia pulado com a fonte. Calendários completos só nos tribunais de tribunais_cobertos; nos demais, avisa e usa os feriados nacionais. Cálculo local.
dias必填tipodobroeventoinicio必填comarcajuizadomateriaconsultatribunalautosEletronicosPrazos da lei (catálogo)
Procura no catálogo de prazos processuais (CPC, CLT, Juizados) quantos dias tem um ato, como conta e a base legal. Ex.: "contestação", "apelação", "embargos de declaração", "recurso ordinário".
quemramotermo必填limiteFeriados e dias sem expediente
Feriados do ano. Sem tribunal: feriados nacionais de lei (com a lei de cada um). Com tribunal (e comarca): calendário forense completo, com portarias, feriados municipais, recesso, pontos facultativos e suspensão de prazos. Cálculo local.
anocomarcamateriatribunalcalendarioContar dias úteis entre datas
Quantos dias úteis há entre duas datas (exclui o dia inicial, inclui o final), no calendário forense de um tribunal/comarca, no nacional ou no bancário. Lista os dias que não contaram e por quê. Cálculo local.
de必填ate必填comarcamateriatribunalcalendarioSomar dias úteis a uma data
Data que cai N dias úteis depois (ou antes, com N negativo) de uma data, sem contar o dia inicial, no calendário forense, nacional ou bancário. Bom para prazo interno do escritório e prazo de licitação. Para prazo processual a partir de intimação, use calcular_prazo.
data必填dias必填comarcamateriatribunalcalendarioTribunais com calendário forense
Lista os tribunais com calendário forense completo (portarias, comarcas, feriados municipais) e os anos conferidos. Nos demais, os cálculos usam só os feriados nacionais e avisam.
无需输入参数。
Índices do Banco Central
Valores oficiais publicados pelo Banco Central (API pública do SGS), com acumulado no período e em 12 meses para os índices mensais. Índices: ipca (IPCA, % no mês); ipca_e (IPCA-E, % no mês); inpc (INPC, % no mês); igpm (IGP-M, % no mês); selic_mensal (SELIC acumulada no mês, % no mês); selic (SELIC diária, % ao dia); selic_meta (Meta da SELIC (Copom), % ao ano); cdi (CDI, % ao dia); dolar (Dólar comercial (venda), R$ por US$).
deateindice必填ultimosCorreção monetária
Corrige um valor entre duas datas por IPCA, IPCA-E, INPC, IGP-M ou SELIC, com índices oficiais do Banco Central. Mesma convenção da Calculadora do Cidadão: do mês inicial até o mês anterior ao final. Correção simples, sem juros nem multa.
de必填atevalor必填indiceEditais abertos no PNCP
Licitações com proposta aberta no Portal Nacional de Contratações Públicas (API pública do PNCP): por palavras do objeto, UF, município (código IBGE) e modalidade. Traz órgão, valor estimado, prazo e link do edital.
quflimitepaginamodalidadeencerra_atemunicipio_ibgeConsultar CEP
Endereço de um CEP (logradouro, bairro, cidade, UF, código IBGE, DDD e coordenadas quando houver). Grátis, com cota diária por conexão; com BITBUSCA_API_KEY não há cota.
cep必填Consultar CNPJ (básico)
Cadastro público do CNPJ na Receita Federal: razão social, nome fantasia, situação, abertura, natureza jurídica, porte, CNAE principal, endereço e Simples/MEI. Sem sócios e sem contatos. Grátis com cota diária por conexão; com BITBUSCA_API_KEY usa a sua chave (1 crédito).
cnpj必填Publicações do DJEN (intimações)
[Avançado: exige BITBUSCA_API_KEY] Busca intimações e publicações do Diário de Justiça Eletrônico Nacional (desde 2021) por OAB, número do processo, parte, advogado ou palavras. Use ler_publicacao(id, data) para o texto completo, ficha_processo(numero) para os movimentos e calcular_prazo (grátis; evento "djen" com a data de disponibilização, campo "data") para o vencimento.
deateoabpartecursorlimiteadvogadopalavrasprocessotribunaisTexto integral da publicação
[Avançado: exige BITBUSCA_API_KEY] Traz o texto completo de uma publicação do DJEN, com partes e advogados.
id必填dataparteFicha do processo
[Avançado: exige BITBUSCA_API_KEY] Mostra capa e movimentações de um processo (classe, assuntos, órgão, últimos movimentos).
numero必填Monitorar OAB, parte ou processo no DJEN
[Avançado: exige BITBUSCA_API_KEY] Cria um monitor que avisa (por webhook) a cada publicação nova de uma OAB, parte ou processo.
alvo必填tiporotuloEditais abertos (PNCP e outros portais)
[Avançado: exige BITBUSCA_API_KEY] Busca editais abertos no PNCP e em outros portais, com filtros de valor e prazo; devolve o id para ler_edital e analisar_edital.
qufordemcursorlimitevalorMaxvalorMinencerraAteDetalhe do edital
[Avançado: exige BITBUSCA_API_KEY] Mostra itens, documentos, datas e órgão de um edital.
id必填Análise do edital pelo Bitinho (IA)
[Avançado: exige BITBUSCA_API_KEY] Lê o edital por você e devolve resumo, checklist de documentos, prazos, riscos e o que fazer, cada item com a página/trecho de onde saiu. SEMPRE chame primeiro sem confirmar: a resposta traz o custo em créditos, o saldo e se já foi paga (grátis). Mostre o custo ao usuário e só repita com confirmar: true depois do "sim" dele.
id必填confirmarResumo curto do edital (IA)
[Avançado: exige BITBUSCA_API_KEY] Resume o edital em poucas linhas (objeto, valor, prazo, exigências principais), com a fonte de cada item. SEMPRE chame primeiro sem confirmar: a resposta traz o custo em créditos, o saldo e se já foi paga (grátis). Mostre o custo ao usuário e só repita com confirmar: true depois do "sim" dele.
id必填confirmarScore do órgão comprador
[Avançado: exige BITBUSCA_API_KEY] Dá a nota de 0 a 100 do órgão público (saúde fiscal e histórico de pagamento, por regra sobre dados públicos), com as razões da nota.
cnpj必填Ficha do advogado por OAB
[Avançado: exige BITBUSCA_API_KEY] Mostra a ficha pública do advogado pela OAB (nome, inscrição, situação, cidade/UF), sem telefone, e-mail nem endereço.
oab必填Empresas por filtro (base CNPJ)
[Avançado: exige BITBUSCA_API_KEY] Lista empresas da base de CNPJ por UF, município, bairro, CNAE, porte e data de abertura (sem sócios).
ufcnaepageportebairropageSizemunicipioaberturaDiassomenteAtivasCidades com cadastro de imóveis
[Avançado: exige BITBUSCA_API_KEY] Lista as cidades com cadastro imobiliário disponível (cobertura parcial do país). Use o campo "slug" como cidade em buscar_imovel e ficha_imovel.
无需输入参数。
Buscar imóvel por endereço
[Avançado: exige BITBUSCA_API_KEY] Acha o lote/imóvel no cadastro municipal por endereço ou inscrição (não busca por CPF).
termo必填cidade必填limiteFicha do imóvel
[Avançado: exige BITBUSCA_API_KEY] Mostra a ficha do imóvel no cadastro municipal (área, uso, valor venal quando houver), sem dados do proprietário.
valor必填cidade必填Plano e saldo de créditos
[Avançado: exige BITBUSCA_API_KEY] Mostra o plano, o saldo de créditos e os limites da sua chave BitBusca.
无需输入参数。
Como ativar o modo avançado
Explica o que o modo avançado faz, quanto custa e como obter a chave grátis da BitBusca.
无需输入参数。
已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
npx juris-licita-mcpclaude mcp add juris-licita -- npx -y juris-licita-mcpclaude mcp add juris-licita -e BITBUSCA_API_KEY=bk_test_SUA_CHAVE -- npx -y juris-licita-mcp{ "mcpServers": { "juris-licita": { "command": "npx", "args": ["-y", "juris-licita-mcp"], "env": { "BITBUSCA_API_KEY": "" } } }}{ "mcpServers": { "juris-licita": { "command": "npx", "args": ["-y", "juris-licita-mcp"], "env": { "BITBUSCA_API_KEY": "" } } }}{ "inputs": [ { "type": "promptString", "id": "bitbusca-key", "description": "Chave BitBusca (opcional, liga o modo avançado)", "password": true } ], "servers": { "juris-licita": { "type": "stdio", "command": "npx", "args": ["-y", "juris-licita-mcp"], "env": { "BITBUSCA_API_KEY": "${input:bitbusca-key}" } } }}npx juris-licita-mcp --http # http://127.0.0.1:3333/mcp (Streamable HTTP, sem sessão)npx juris-licita-mcp --http --port 8080git clone https://github.com/bitbusca/juris-licita-mcp && cd juris-licita-mcpnpm installnpm run buildnpm test # node:test, sem rede (fixtures e mocks)npm run inspector # MCP Inspector apontando para dist/index.jsclaude mcp add juris-licita-local -- node /caminho/para/juris-licita-mcp/dist/index.js