io.github.paivapiovesan/next-finance

NPM · NEXT-FINANCE-MCP · SCANNED AUG 3

MCP Server for NEXT Finance ERP (finance.net.br) — browser login, wallets, accounts, transactions.

Available components

+41 this week 60 60 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (116 of 117), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (116 of 117), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 2 days ago).Pass
Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified

Schema Quality & AI Usability58

AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 12085 tokens (~194/item across 62 items; 62 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · next-finance-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add paivapiovesan-next-finance -- npx -y next-finance-mcp

# add to Codex CLI

codex mcp add paivapiovesan-next-finance -- npx -y next-finance-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "paivapiovesan-next-finance": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "next-finance-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add paivapiovesan-next-finance --command npx --arg -y --arg next-finance-mcp

# ~/.hermes/config.yaml

mcp_servers:
  paivapiovesan-next-finance:
    command: "npx"
    args: ["-y", "next-finance-mcp"]

// mcp.json

{
  "mcpServers": {
    "paivapiovesan-next-finance": {
      "command": "npx",
      "args": [
        "-y",
        "next-finance-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +47
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → good ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.20 ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Licence: MIT functional
- Package version: 0.9.70 → 0.9.71 functional
1 Aug 26 +13
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 0
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- Package version: 0.9.67 → 0.9.70 functional
29 Jul 26 0
- Package version: 0.9.68 → 0.9.70 functional
28 Jul 26 −19
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: 0.9.67 → 0.9.68 functional
27 Jul 26 19

First indexed and scored.

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 116 packages

116 packages in the resolved dependency tree · 115 deprecated · 43 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 62 exposed · ~11,785 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

Abre uma janela no browser para login seguro no NEXT Finance. As credenciais não passam pelo chat. Se já houver sessão salva, restaura automaticamente sem abrir o browser.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

logout ~21

Encerra a sessão e remove os dados de sessão salvos.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

obter_extrato_open_finance ~156

Solicita ao banco (via Open Finance) o extrato de uma conta no período. Diferente de 'atualizar_open_finance' (que só pega o mais recente), permite especificar um intervalo de datas. Default: últimos 30 dias. Após sucesso, a conciliação fica pendente no NEXT — finalize no app para os lançamentos aparecerem em 'buscar_lancamentos'.

Input Output Examples

Name	Type	Req	Description
data_fim	string	—	Data fim YYYY-MM-DD (padrão: hoje)
data_inicio	string	—	Data início YYYY-MM-DD (padrão: 30 dias atrás)
nome_conta	string	yes	Nome da conta (ex: 'Inter CC 651549')

No output schema declared.

No examples provided.

permissao_conta ~111

Verifica a permissão do usuário logado sobre uma conta. Retorna 'Negar' (oculta), 'Ver' (somente leitura) ou 'Editar' (acesso total). O MCP respeita essas permissões automaticamente: contas 'Negar' não aparecem em listagens, e tentativas de criar/editar/excluir lançamento em conta 'Ver' são rejeitadas.

Input Output Examples

Name	Type	Req	Description
nome_conta	string	yes	Nome da conta (ex: 'Inter CC 651549')

No output schema declared.

No examples provided.

reiniciar_conciliacao ~70

Reinicia uma conciliação em andamento (descarta o progresso e re-busca os lançamentos do extrato). Útil quando algo deu errado na conciliação atual.

Input Output Examples

Name	Type	Req	Description
nome_conta	string	yes	Nome da conta (ex: 'Inter CC 651549')

No output schema declared.

No examples provided.

remover_anexo_lancamento ~173

Remove um ou mais anexos de um lançamento. Localiza pelo trio (nome_conta + data + valor/descrição) e remove os arquivos por nome COM extensão (ex: 'boleto.pdf'). Use 'listar_anexos_lancamento' para ver os nomes exatos.

Input Output Examples

Name	Type	Req	Description
data	string	yes	Data do lançamento YYYY-MM-DD
descricao	string	—	Descrição (substring, opcional)
moeda	string	—	Moeda da conta (desambigua homônimas)
nome_conta	string	yes	Nome da conta do lançamento
nomes_arquivo	array	yes	Nomes dos anexos a remover, com extensão (ex: ['boleto.pdf'])
valor	number	—	Valor (opcional, ajuda a desambiguar)

No output schema declared.

No examples provided.

resumo_categoria ~170

Resumo de gastos/receitas numa categoria do plano de contas — responde 'quanto gastei com Restaurantes em maio?'. Retorna total de despesas/receitas/saldo do período, breakdown por mês, por conta, por centro de custo e top 15 descrições. Período default: últimos 30 dias.

Input Output Examples

Name	Type	Req	Description
apenas_despesas	boolean	—	Filtrar só despesas
apenas_receitas	boolean	—	Filtrar só receitas
data_fim	string	—	YYYY-MM-DD (padrão: hoje)
data_inicio	string	—	YYYY-MM-DD (padrão: 30 dias atrás)
plano_de_contas	string	yes	Nome da categoria (ex: 'Restaurantes', 'Combustível', 'Salário')

No output schema declared.

No examples provided.

resumo_centro_de_custo ~141

Resumo de gastos/receitas num centro de custo — responde 'despesas e receitas do CC Pedro Tobias?'. Retorna total de despesas/receitas/saldo, breakdown por mês, por plano de contas, por conta e top 15 descrições. Período default: últimos 30 dias.

Input Output Examples

Name	Type	Req	Description
centro_de_custo	string	yes	Nome do centro de custo (ex: 'Pedro Tobias', 'Wanêssa e Rodrigo')
data_fim	string	—	YYYY-MM-DD (padrão: hoje)
data_inicio	string	—	YYYY-MM-DD (padrão: 30 dias atrás)

No output schema declared.

No examples provided.

saldo_carteira ~112

Snapshot completo de saldos da carteira numa data (default: hoje), agrupado em árvore Moeda → Portfolio → Tipo de Conta → Conta. Equivale à tela 'Outras Contas' do NEXT Finance. Mostra patrimônio total por moeda (BRL, USD, EUR, etc.) e breakdown por categoria (Renda Fixa, Renda Variável, Tesouraria, Liquidez, Previdência).

Input Output Examples

Name	Type	Req	Description
data	string	—	Data YYYY-MM-DD (padrão: hoje)

No output schema declared.

No examples provided.

selecionar_carteira ~76

Seleciona uma carteira pelo nome (necessário antes de listar contas e lançamentos). Use listar_carteiras para ver os nomes disponíveis.

Input Output Examples

Name	Type	Req	Description
nome_carteira	string	yes	Nome (ou parte do nome) da carteira (ex: 'Rodrigo', 'Mônica', 'Paiva Piovesan')

No output schema declared.

No examples provided.

ultimo_preco_produto ~227

Histórico de preços de um produto — responde 'qual o último preço que paguei pelo produto X?'. Por padrão retorna 1 linha por fornecedor com a compra mais recente, ordenado por data desc. Use 'agrupar_por_fornecedor=false' para listar TODAS as compras. Período default: últimos 12 meses. Fonte: NEXT Business (NFCe/NF-e + cadastro de produtos).

Input Output Examples

Name	Type	Req	Description
agrupar_por_fornecedor	boolean	—	true (default) = 1 linha por fornecedor com a compra mais recente; false = lista completa
busca	string	yes	Nome ou parte do nome do produto (ex: 'bombom garoto', 'café')
data_fim	string	—	YYYY-MM-DD (padrão: hoje)
data_inicio	string	—	YYYY-MM-DD (padrão: 12 meses atrás)
limite	number	—	Máximo de entradas retornadas (padrão: 20)
nome_fornecedor	string	—	Restringe a um fornecedor (opcional)

No output schema declared.

No examples provided.

verificar_open_finance ~67

Verifica se uma conta específica tem vínculo Open Finance configurado e se exige MFA. Usa dados de cadastro (offline).

Input Output Examples

Name	Type	Req	Description
nome_conta	string	yes	Nome da conta (ex: 'Inter CC 651549', 'Nubank CC 9782300-2')

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug