actual-mcp-server 0.7.2 → 0.7.3

package/README.md

@@ -755,4 +755,4 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.7.2 | **Tool Count:** 71 (verified LibreChat-compatible)
+**Version:** 0.7.3 | **Tool Count:** 71 (verified LibreChat-compatible)

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "actual-mcp-server",
     "displayName": "Actual MCP Server",
-    "version": "0.7.2",
+    "version": "0.7.3",
     "engines": {
         "node": ">=22.0.0",
         "npm": ">=10.0.0"

package/dist/src/actualToolsManager.js

@@ -1,5 +1,5 @@
+// src/actualToolsManager.ts
 import logger from './logger.js';
-import { z } from 'zod';
 import { formatZodError } from './lib/zod-error-format.js';
 // ✅ List of tools already implemented in this class.
 // Adding the tool name here is considered fully implemented.
@@ -119,21 +119,6 @@ const API_TOOL_MAP = {
     getIDByName: 'actual_get_id_by_name',
     getServerVersion: 'actual_server_get_version',
 };
-// Define Account schema for validation (simplified example)
-const AccountSchema = z.object({
-    id: z.string().optional(),
-    name: z.string(),
-    type: z.string(), // Consider enum if you have fixed valid types
-    offbudget: z.boolean().optional().default(false),
-    closed: z.boolean().optional().default(false),
-});
-// Input schema for get_accounts - no args
-const GetAccountsInputSchema = z.object({});
-// Input schema for get_account_balance
-const GetAccountBalanceInputSchema = z.object({
-    id: z.string().optional().describe('Account ID to get balance for (optional; defaults to first account)'),
-    cutoff: z.string().optional().describe('Optional ISO date string cutoff'),
-});
 class ActualToolsManager {
     tools = new Map();
     constructor() { }
@@ -141,7 +126,7 @@ class ActualToolsManager {
         // Dynamically import all tool modules from src/tools/index.ts
         const toolModules = (await import('./tools/index.js'));
         let count = 0;
-        for (const [key, tool] of Object.entries(toolModules)) {
+        for (const [_key, tool] of Object.entries(toolModules)) {
             const t = tool;
             if (t && t.name) {
                 this.tools.set(t.name, tool);

package/dist/src/index.js

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { isKnownBenignRejection } from './lib/rejection-allowlist.js';
 // Add global error handlers
-let isHandlingQueryError = false;
 process.on('unhandledRejection', (reason, promise) => {
     console.error('=== UNHANDLED REJECTION ===');
     console.error('Promise:', promise);
@@ -125,16 +124,14 @@ Docs & source: https://github.com/agigante80/actual-mcp-server`);
         import('./actualConnection.js'),
         import('./lib/ActualMCPConnection.js'),
     ]);
-    const [{ startHttpServer }, { startStdioServer }, loggerModule, osModule, utilsModule, actualToolsManagerModule,] = await Promise.all([
+    const [{ startHttpServer }, { startStdioServer }, loggerModule, utilsModule, actualToolsManagerModule,] = await Promise.all([
         import('./server/httpServer.js'),
         import('./server/stdioServer.js'),
         import('./logger.js'),
-        import('os'),
         import('./utils.js'),
         import('./actualToolsManager.js'),
     ]);
     const logger = loggerModule.default;
-    const os = osModule;
     const { getLocalIp } = utilsModule;
     const actualToolsManager = actualToolsManagerModule.default;
     // Load version from environment (Docker build-time) or package.json (local dev)

package/dist/src/lib/actual-adapter.js

@@ -689,30 +689,6 @@ export function getConcurrencyState() {
         writeConnectionReuses: writeConnectionReuseCount,
     };
 }
-/**
- * Sync local changes to the Actual Budget server.
- *
- * This function should be called after write operations (create, update, delete)
- * to ensure changes are properly synced to the remote server. Without syncing,
- * changes may only exist locally and could be lost.
- *
- * Note: Adds a small delay to ensure local changes are committed before syncing.
- */
-async function syncToServer() {
-    try {
-        // Small delay to ensure local changes are committed to the database
-        // before attempting to sync to the server
-        await new Promise(resolve => setTimeout(resolve, 100));
-        // TypeScript doesn't recognize sync in the type definitions, but it exists at runtime
-        console.log('[SYNC] Calling api.sync()...');
-        await api.sync();
-        console.log('[SYNC] api.sync() completed successfully');
-    }
-    catch (err) {
-        // Log but don't throw - sync failures shouldn't break the operation
-        console.error('[SYNC] Sync to server failed:', err);
-    }
-}
 /**
  * Wrap a raw function with the standard adapter retry + concurrency behavior.
  * Useful for tests that want to exercise retry behavior without calling the real raw methods.

package/dist/src/server/httpServer.js

@@ -37,7 +37,7 @@ serverDescription, // was passed by index.ts
 serverInstructions, // was passed by index.ts
 toolSchemas, // was passed by index.ts
 version, // server version from package.json
-bindHost = 'localhost', advertisedUrl) {
+_bindHost = 'localhost', advertisedUrl) {
     const app = express();
     // Explicit body-size cap (#168). An oversized payload is rejected with HTTP 413
     // rather than buffered unbounded. Tunable via MCP_HTTP_BODY_LIMIT (default 512kb).

package/dist/src/tests/testMcpClient.js

@@ -1,4 +1,4 @@
-export async function testMcpClient(advertisedUrl, port, httpPath) {
+export async function testMcpClient(advertisedUrl, _port, httpPath) {
     // Try builtin fetch or fallback to node-fetch if necessary
     const globalFetch = globalThis.fetch;
     const fetchAny = globalFetch ?? (await import('node-fetch')).default;
@@ -82,14 +82,10 @@ export async function testMcpClient(advertisedUrl, port, httpPath) {
         throw new Error('initialize result.capabilities missing or not object');
     }
     // Accept either a tools array or derive tools from capabilities.tools object
-    let initTools = [];
-    if (Array.isArray(initResult['tools'])) {
-        initTools = initResult['tools'];
-    }
-    else if (initResult['capabilities'] && typeof initResult['capabilities']['tools'] === 'object') {
-        initTools = Object.keys(initResult['capabilities']['tools']);
-    }
-    else {
+    const hasTools = Array.isArray(initResult['tools'])
+        || (initResult['capabilities'] != null
+            && typeof initResult['capabilities']['tools'] === 'object');
+    if (!hasTools) {
         throw new Error('initialize result.tools missing or not array and capabilities.tools not present');
     }
     // serverInstructions may be a string, an object { instructions }, or absent.
@@ -106,7 +102,6 @@ export async function testMcpClient(advertisedUrl, port, httpPath) {
     else {
         console.warn('Warning: serverInstructions present but in unexpected shape — continuing tests');
     }
-    // replace usages below with initTools where needed
     console.info('Initialize OK: capabilities/tools/serverInstructions present');
     // call tools/list (JSON-RPC) to verify RPC path works
     const listPayload = { jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} };

package/dist/src/tools/accounts_list.js

@@ -1,11 +1,12 @@
 import { z } from 'zod';
 import adapter from '../lib/actual-adapter.js';
 const InputSchema = z.object({});
+// RESPONSE_TYPE: Account[]
 const tool = {
     name: 'actual_accounts_list',
     description: "List all accounts in Actual Budget including checking, savings, credit cards, and investment accounts. Returns account ID, name, balance (in cents), on-budget/off-budget status, and open/closed state.",
     inputSchema: InputSchema,
-    call: async (args, _meta) => {
+    call: async (_args, _meta) => {
         // Single API session: getAccounts + all balances in one withActualApi cycle.
         // Calling getAccountBalance() per-account would open N separate sessions and
         // overwhelm the Actual server with concurrent init/shutdown cycles.

package/dist/src/tools/budgets_getMonth.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import adapter from '../lib/actual-adapter.js';
 const InputSchema = z.object({ month: z.string().optional() });
+// RESPONSE_TYPE: BudgetMonth
 const tool = {
     name: 'actual_budgets_getMonth',
     description: "Get budget data for a specific month in YYYY-MM format (e.g., '2025-12'). Returns all categories with their budgeted amounts, actual spending, and available balances for the month.",

package/dist/src/tools/budgets_getMonths.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import adapter from '../lib/actual-adapter.js';
 const InputSchema = z.object({});
+// RESPONSE_TYPE: array
 const tool = {
     name: 'actual_budgets_getMonths',
     description: "Get a list of all available budget months with summary data. Returns an array of months showing total budgeted, spent, and income for each month. Useful for viewing budget history and trends over time.",

package/dist/src/tools/categories_create.js

@@ -6,6 +6,7 @@ const InputSchema = z.object({
     group_id: CommonSchemas.categoryGroupId,
     is_income: z.boolean().nullable().optional(),
 }).passthrough(); // Allow other fields to pass through
+// RESPONSE_TYPE: string
 const tool = {
     name: 'actual_categories_create',
     description: "Create a category. REQUIRED: group_id (category group UUID). Use actual_category_groups_get to find available groups. Optional: is_income (boolean, defaults to false for expense categories).",

package/dist/src/tools/categories_get.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import adapter from '../lib/actual-adapter.js';
 const InputSchema = z.object({});
+// RESPONSE_TYPE: Category[]
 const tool = {
     name: 'actual_categories_get',
     description: 'List all budget categories organized by category groups. Categories are spending/income buckets (e.g., Groceries, Rent, Salary) used for budgeting and transaction categorization. Returns both grouped view and flat list with category IDs, names, and group assignments.',

package/dist/src/tools/category_groups_get.js

@@ -5,7 +5,7 @@ const tool = {
     name: 'actual_category_groups_get',
     description: `List all category groups in Actual Budget. Category groups organize related categories together (e.g., "Monthly Bills" group contains "Rent", "Utilities", "Internet" categories). Each group has an ID, name, and optional properties.`,
     inputSchema: InputSchema,
-    call: async (args, _meta) => {
+    call: async (_args, _meta) => {
         const groups = await adapter.getCategoryGroups();
         return { groups };
     },

package/dist/src/tools/payees_get.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import adapter from '../lib/actual-adapter.js';
 const InputSchema = z.object({});
+// RESPONSE_TYPE: Payee[]
 const tool = {
     name: 'actual_payees_get',
     description: "List all payees in Actual Budget. Payees represent merchants, service providers, individuals, or other entities you transact with. Returns payee ID, name, and optional transfer account information for internal transfers.",

package/dist/src/tools/rules_get.js

@@ -5,7 +5,7 @@ const tool = {
     name: 'actual_rules_get',
     description: `List all budget rules in Actual Budget. Rules automate transaction categorization and other budget operations based on conditions. Each rule has conditions (e.g., payee matches "Amazon") and actions (e.g., set category to "Shopping").`,
     inputSchema: InputSchema,
-    call: async (args, _meta) => {
+    call: async (_args, _meta) => {
         const rules = await adapter.getRules();
         return { rules };
     },

package/dist/src/tools/session_close.js

@@ -9,7 +9,7 @@ const tool = {
     name: 'actual_session_close',
     description: 'Close an idle MCP session to free up connection slots. Useful when you get "Max concurrent sessions reached" errors. Only closes sessions other than the current one.',
     inputSchema: InputSchema,
-    call: async (args, meta) => {
+    call: async (args, _meta) => {
         const input = InputSchema.parse(args || {});
         const stats = connectionPool.getStats();
         if (stats.totalSessions === 0) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "engines": {
     "node": ">=22.0.0",
     "npm": ">=10.0.0"