next-finance-mcp 0.9.13 → 0.9.14

package/dist/client.d.ts

@@ -113,8 +113,9 @@ export declare function atualizarOpenFinance(nomeConta: string): Promise<{
     sucesso: boolean;
     mensagem: string;
 }>;
-/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web. */
-export declare function obterExtratoOpenFinance(nomeConta: string, dataInicio: string, dataFim: string): Promise<{
+/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web.
+ *  Período default: últimos 30 dias. */
+export declare function obterExtratoOpenFinance(nomeConta: string, dataInicioOpt?: string, dataFimOpt?: string): Promise<{
     conta: string;
     sucesso: boolean;
     mensagem: string;

package/dist/client.js

@@ -646,6 +646,18 @@ export async function listarTiposConta() {
     const tipos = arr.map(t => ({ nome: String(t["Nome"] ?? t["Descricao"] ?? "") })).filter(t => t.nome);
     return { tipos };
 }
+// ── Helpers de datas padrão ──────────────────────────────────────────────────
+// Default consistente em toda a API: últimos 30 dias terminando hoje.
+function isoDate(d) { return d.toISOString().slice(0, 10); }
+function defaultsUltimos30Dias(opts) {
+    const hoje = new Date();
+    const dataFim = opts.dataFim ?? isoDate(hoje);
+    // 30 dias atrás = hoje - 30 (inclusive)
+    const trintaDiasAtras = new Date(hoje);
+    trintaDiasAtras.setDate(trintaDiasAtras.getDate() - 30);
+    const dataInicio = opts.dataInicio ?? isoDate(trintaDiasAtras);
+    return { dataInicio, dataFim };
+}
 /** Resolve um nome de conta → IdConta interno, exigindo match único (não expõe ID). */
 async function resolverIdConta(nome) {
     const { contas } = await fetchContas();
@@ -709,9 +721,11 @@ export async function atualizarOpenFinance(nomeConta) {
     }
     return { conta: nome, sucesso: true, mensagem: r.text?.trim() || "Sincronização iniciada." };
 }
-/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web. */
-export async function obterExtratoOpenFinance(nomeConta, dataInicio, dataFim) {
+/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web.
+ *  Período default: últimos 30 dias. */
+export async function obterExtratoOpenFinance(nomeConta, dataInicioOpt, dataFimOpt) {
     const { id, nome } = await resolverIdConta(nomeConta);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias({ dataInicio: dataInicioOpt, dataFim: dataFimOpt });
     // Endpoint web real (verificado): POST application/json com DataInicio/DataFim em ISO datetime
     const body = JSON.stringify({
         DataInicio: `${dataInicio}T00:00:00`,
@@ -819,9 +833,7 @@ function slimDespesa(d, comItens) {
     return result;
 }
 export async function buscarDespesas(opts = {}) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     // API exige formato ISO completo com hora
     const raw = await apiPost("/api/Despesa/Filtrar", {
         DataInicio: dataInicio + "T00:00:00.000Z",
@@ -855,9 +867,7 @@ export async function buscarDespesas(opts = {}) {
     };
 }
 export async function buscarItensDespesa(opts = {}) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     // Resolve nome do fornecedor → ID interno (nunca exposto)
     let pessoaId;
     if (opts.nomeFornecedor?.trim()) {
@@ -982,9 +992,7 @@ const TIPOS_CONTA_MOVIMENTO = new Set([
     "contas em cobrança", "contas em cobranca",
 ]);
 export async function buscarLancamentos(opts) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     const pagina = Math.max(1, opts.pagina ?? 1);
     const limite = Math.min(200, Math.max(1, opts.limite ?? 50));
     // Resolve nome da conta → ID interno (nunca exposto ao usuário)

package/dist/index.js

@@ -8,7 +8,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import * as client from "./client.js";
 import { openLoginUI } from "./login-server.js";
-const server = new Server({ name: "next-finance-mcp", version: "0.9.13" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "next-finance-mcp", version: "0.9.14" }, { capabilities: { tools: {} } });
 // ── Ferramentas ─────────────────────────────────────────────────────────────
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -100,7 +100,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 type: "object",
                 properties: {
                     nome_conta: { type: "string", description: "Nome da conta (opcional — omitir busca em todas as contas, ex: 'Nubank', 'Inter')" },
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
                     data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                     plano_de_contas: { type: "string", description: "Filtra por categoria/plano de contas (ex: 'Restaurante')" },
                     centro_de_custo: { type: "string", description: "Filtra por centro de custo" },
@@ -159,18 +159,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: "obter_extrato_open_finance",
-            description: "Solicita ao banco (via Open Finance) o extrato completo de uma conta no período. " +
-                "Diferente de 'atualizar_open_finance' (que só pega o mais recente), este endpoint " +
-                "permite especificar um intervalo de datas. Após sucesso, use 'buscar_lancamentos' " +
-                "para ver os lançamentos importados.",
+            description: "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'.",
             inputSchema: {
                 type: "object",
                 properties: {
                     nome_conta: { type: "string", description: "Nome da conta (ex: 'Inter CC 651549')" },
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD" },
-                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
+                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                 },
-                required: ["nome_conta", "data_inicio", "data_fim"],
+                required: ["nome_conta"],
             },
         },
         {
@@ -182,7 +182,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             inputSchema: {
                 type: "object",
                 properties: {
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
                     data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                     nome_fornecedor: { type: "string", description: "Filtra por nome do fornecedor (ex: 'Supermercados BH', 'Epa')" },
                     busca: { type: "string", description: "Filtra por número do documento ou tipo" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "mcpName": "io.github.paivapiovesan/next-finance",
   "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
   "type": "module",