@daften/fireflyiii-mcp 0.1.0

package/dist/tools/currencies.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { unwrapList, unwrapSingle, } from '../transform.js';
+import { DELETE_ANNOTATIONS, READ_ANNOTATIONS, UPDATE_ANNOTATIONS, WRITE_ANNOTATIONS } from './_annotations.js';
+import { defineTool } from './_helpers.js';
+export async function fetchCurrencies(client, params) {
+    const response = await client.get('/currencies', { page: params.page, limit: params.limit });
+    return unwrapList(response);
+}
+export async function fetchCurrency(client, code) {
+    const response = await client.get(`/currencies/${encodeURIComponent(code)}`);
+    return unwrapSingle(response);
+}
+export async function createCurrency(client, params) {
+    const response = await client.post('/currencies', params);
+    return unwrapSingle(response);
+}
+export async function updateCurrency(client, code, params) {
+    const response = await client.put(`/currencies/${encodeURIComponent(code)}`, params);
+    return unwrapSingle(response);
+}
+export async function deleteCurrency(client, code) {
+    await client.delete(`/currencies/${encodeURIComponent(code)}`);
+    return { deleted: true, code };
+}
+export async function enableCurrency(client, code) {
+    const response = await client.post(`/currencies/${encodeURIComponent(code)}/enable`, {});
+    return unwrapSingle(response);
+}
+export async function disableCurrency(client, code) {
+    const response = await client.post(`/currencies/${encodeURIComponent(code)}/disable`, {});
+    return unwrapSingle(response);
+}
+export async function setPrimaryCurrency(client, code) {
+    const response = await client.post(`/currencies/${encodeURIComponent(code)}/primary`, {});
+    return unwrapSingle(response);
+}
+export function registerCurrencyTools(server, client) {
+    defineTool(server, 'get_currencies', {
+        title: 'Get Currencies',
+        description: 'Get all currencies configured in Firefly III.',
+        inputSchema: {
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ page, limit }) => fetchCurrencies(client, { page: page, limit: limit }));
+    defineTool(server, 'get_currency', {
+        title: 'Get Currency',
+        description: 'Get a single currency by its currency code (e.g. EUR, USD).',
+        inputSchema: { code: z.string().describe('Currency code (e.g. EUR, USD)') },
+        annotations: READ_ANNOTATIONS,
+    }, ({ code }) => fetchCurrency(client, code));
+    defineTool(server, 'create_currency', {
+        title: 'Create Currency',
+        description: 'Create a new currency in Firefly III.',
+        inputSchema: {
+            name: z.string().describe('Currency name (e.g. Euro)'),
+            code: z.string().describe('Currency code (e.g. EUR)'),
+            symbol: z.string().describe('Currency symbol (e.g. €)'),
+            decimal_places: z.number().int().min(0).max(10).optional().describe('Number of decimal places (default 2)'),
+            enabled: z.boolean().optional().describe('Whether the currency is enabled'),
+            default: z.boolean().optional().describe('Whether this is the default currency'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, (params) => createCurrency(client, params));
+    defineTool(server, 'update_currency', {
+        title: 'Update Currency',
+        description: 'Update an existing currency. Only fields provided will be changed. Use get_currencies to find valid currency codes.',
+        inputSchema: {
+            code: z.string().describe('Currency code to update (e.g. EUR)'),
+            name: z.string().optional().describe('Currency name'),
+            symbol: z.string().optional().describe('Currency symbol'),
+            decimal_places: z.number().int().min(0).max(10).optional().describe('Number of decimal places'),
+            enabled: z.boolean().optional().describe('Whether the currency is enabled'),
+            default: z.boolean().optional().describe('Whether this is the default currency'),
+        },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ code, ...params }) => updateCurrency(client, code, params));
+    defineTool(server, 'delete_currency', {
+        title: 'Delete Currency',
+        description: 'Permanently delete a currency from Firefly III. **This action cannot be undone.** Use get_currencies to confirm the code before deleting.',
+        inputSchema: { code: z.string().describe('Currency code to delete (e.g. EUR)') },
+        annotations: DELETE_ANNOTATIONS,
+    }, ({ code }) => deleteCurrency(client, code));
+    defineTool(server, 'enable_currency', {
+        title: 'Enable Currency',
+        description: 'Enable a currency so it can be used in transactions.',
+        inputSchema: { code: z.string().describe('Currency code (e.g. EUR)') },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ code }) => enableCurrency(client, code));
+    defineTool(server, 'disable_currency', {
+        title: 'Disable Currency',
+        description: 'Disable a currency so it no longer appears in transaction forms.',
+        inputSchema: { code: z.string().describe('Currency code (e.g. EUR)') },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ code }) => disableCurrency(client, code));
+    defineTool(server, 'set_primary_currency', {
+        title: 'Set Primary Currency',
+        description: 'Set a currency as the primary/default currency for Firefly III.',
+        inputSchema: { code: z.string().describe('Currency code to set as primary (e.g. EUR)') },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ code }) => setPrimaryCurrency(client, code));
+}
+//# sourceMappingURL=currencies.js.map

package/dist/tools/currencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.js","sourceRoot":"","sources":["../../src/tools/currencies.ts"],"names":[],"mappings":"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"}

package/dist/tools/exports.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FireflyClient } from '../client.js';
+type ExportEntity = 'transactions' | 'accounts' | 'bills' | 'budgets' | 'categories' | 'tags' | 'recurring' | 'rules' | 'piggy-banks';
+export declare function exportEntity(client: FireflyClient, entity: ExportEntity, params: {
+    start?: string;
+    end?: string;
+}): Promise<string>;
+export declare function registerExportTools(server: McpServer, client: FireflyClient): void;
+export {};
+//# sourceMappingURL=exports.d.ts.map

package/dist/tools/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,KAAK,YAAY,GACb,cAAc,GACd,UAAU,GACV,OAAO,GACP,SAAS,GACT,YAAY,GACZ,MAAM,GACN,WAAW,GACX,OAAO,GACP,aAAa,CAAC;AAElB,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,MAAM,CAAC,CAKjB;AAcD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAqBlF"}

package/dist/tools/exports.js

@@ -0,0 +1,37 @@
+import { READ_ANNOTATIONS } from './_annotations.js';
+import { dateSchema, defineTool } from './_helpers.js';
+export async function exportEntity(client, entity, params) {
+    const query = { type: 'csv' };
+    if (params.start)
+        query.start = params.start;
+    if (params.end)
+        query.end = params.end;
+    return client.getText(`/data/export/${entity}`, query);
+}
+const EXPORT_TOOLS = [
+    { name: 'export_transactions', title: 'Export Transactions', entity: 'transactions', hasDates: true },
+    { name: 'export_accounts', title: 'Export Accounts', entity: 'accounts', hasDates: false },
+    { name: 'export_bills', title: 'Export Bills', entity: 'bills', hasDates: false },
+    { name: 'export_budgets', title: 'Export Budgets', entity: 'budgets', hasDates: false },
+    { name: 'export_categories', title: 'Export Categories', entity: 'categories', hasDates: false },
+    { name: 'export_tags', title: 'Export Tags', entity: 'tags', hasDates: false },
+    { name: 'export_recurring', title: 'Export Recurring Transactions', entity: 'recurring', hasDates: false },
+    { name: 'export_rules', title: 'Export Rules', entity: 'rules', hasDates: false },
+    { name: 'export_piggy_banks', title: 'Export Piggy Banks', entity: 'piggy-banks', hasDates: false },
+];
+export function registerExportTools(server, client) {
+    for (const { name, title, entity, hasDates } of EXPORT_TOOLS) {
+        const inputSchema = {};
+        if (hasDates) {
+            inputSchema.start = dateSchema.optional().describe('Start date (YYYY-MM-DD)');
+            inputSchema.end = dateSchema.optional().describe('End date (YYYY-MM-DD)');
+        }
+        defineTool(server, name, {
+            title,
+            description: `Export all ${entity} as a CSV file. Returns raw CSV text.${hasDates ? ' Optionally filter by date range.' : ''}`,
+            inputSchema,
+            annotations: READ_ANNOTATIONS,
+        }, ({ start, end }) => exportEntity(client, entity, { start: start, end: end }));
+    }
+}
+//# sourceMappingURL=exports.js.map

package/dist/tools/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAavD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAqB,EACrB,MAAoB,EACpB,MAAwC;IAExC,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7C,IAAI,MAAM,CAAC,GAAG;QAAE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvC,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,YAAY,GAAoF;IACpG,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrG,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1F,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjF,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE;IACvF,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;IAChG,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC9E,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,+BAA+B,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1G,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjF,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;CACpG,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IAC1E,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,YAAY,EAAE,CAAC;QAC7D,MAAM,WAAW,GAAiC,EAAE,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAC9E,WAAW,CAAC,GAAG,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QAC5E,CAAC;QAED,UAAU,CACR,MAAM,EACN,IAAI,EACJ;YACE,KAAK;YACL,WAAW,EAAE,cAAc,MAAM,wCAAwC,QAAQ,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9H,WAAW;YACX,WAAW,EAAE,gBAAgB;SAC9B,EACD,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CACjB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAA2B,EAAE,GAAG,EAAE,GAAyB,EAAE,CAAC,CACvG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FireflyClient } from '../client.js';
+export declare const TOOL_GROUPS: readonly ["accounts", "transactions", "budgets", "categories", "bills", "piggy-banks", "reports", "rules", "recurring", "attachments", "currencies", "exports", "object-groups", "transaction-links"];
+export type ToolGroup = (typeof TOOL_GROUPS)[number];
+export declare const PRESETS: Record<string, ToolGroup[]>;
+export type PresetName = keyof typeof PRESETS;
+export interface ToolFilterOptions {
+    preset?: PresetName;
+    groups?: ToolGroup[];
+    readOnly?: boolean;
+}
+export declare function makeReadOnlyProxy(server: McpServer): McpServer;
+export declare function registerAllTools(server: McpServer, client: FireflyClient, options?: ToolFilterOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,eAAO,MAAM,WAAW,uMAed,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAO/C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAyBhH"}

package/dist/tools/index.js

@@ -0,0 +1,94 @@
+import { registerAccountTools } from './accounts.js';
+import { registerAttachmentTools } from './attachments.js';
+import { registerBillTools } from './bills.js';
+import { registerBudgetTools } from './budgets.js';
+import { registerCategoryTools } from './categories.js';
+import { registerCurrencyTools } from './currencies.js';
+import { registerExportTools } from './exports.js';
+import { registerObjectGroupTools } from './object-groups.js';
+import { registerPiggyBankTools } from './piggy-banks.js';
+import { registerRecurringTools } from './recurring.js';
+import { registerReportTools } from './reports.js';
+import { registerRuleTools } from './rules.js';
+import { registerTransactionLinkTools } from './transaction-links.js';
+import { registerTransactionTools } from './transactions.js';
+export const TOOL_GROUPS = [
+    'accounts',
+    'transactions',
+    'budgets',
+    'categories',
+    'bills',
+    'piggy-banks',
+    'reports',
+    'rules',
+    'recurring',
+    'attachments',
+    'currencies',
+    'exports',
+    'object-groups',
+    'transaction-links',
+];
+export const PRESETS = {
+    minimal: ['accounts', 'transactions'],
+    default: ['accounts', 'transactions', 'budgets', 'categories', 'bills'],
+    budgeting: ['accounts', 'transactions', 'budgets', 'categories', 'bills', 'piggy-banks'],
+    insights: ['accounts', 'transactions', 'categories', 'reports'],
+    automation: ['accounts', 'transactions', 'rules', 'recurring'],
+    full: [...TOOL_GROUPS],
+};
+function isReadOnlyTool(name) {
+    return name.startsWith('get_') || name.startsWith('search_') || name.startsWith('test_');
+}
+export function makeReadOnlyProxy(server) {
+    return new Proxy(server, {
+        get(target, prop) {
+            if (prop === 'registerTool') {
+                return (name, config, handler) => {
+                    if (isReadOnlyTool(name)) {
+                        target.registerTool(name, config, handler);
+                    }
+                };
+            }
+            const v = target[prop];
+            return typeof v === 'function' ? v.bind(target) : v;
+        },
+    });
+}
+export function registerAllTools(server, client, options = {}) {
+    const { preset, groups, readOnly = false } = options;
+    const activeGroups = preset
+        ? new Set(PRESETS[preset])
+        : groups
+            ? new Set(groups)
+            : new Set(TOOL_GROUPS);
+    const s = readOnly ? makeReadOnlyProxy(server) : server;
+    if (activeGroups.has('accounts'))
+        registerAccountTools(s, client);
+    if (activeGroups.has('transactions'))
+        registerTransactionTools(s, client);
+    if (activeGroups.has('budgets'))
+        registerBudgetTools(s, client);
+    if (activeGroups.has('categories'))
+        registerCategoryTools(s, client);
+    if (activeGroups.has('bills'))
+        registerBillTools(s, client);
+    if (activeGroups.has('piggy-banks'))
+        registerPiggyBankTools(s, client);
+    if (activeGroups.has('reports'))
+        registerReportTools(s, client);
+    if (activeGroups.has('rules'))
+        registerRuleTools(s, client);
+    if (activeGroups.has('recurring'))
+        registerRecurringTools(s, client);
+    if (activeGroups.has('attachments'))
+        registerAttachmentTools(s, client);
+    if (activeGroups.has('currencies'))
+        registerCurrencyTools(s, client);
+    if (activeGroups.has('exports'))
+        registerExportTools(s, client);
+    if (activeGroups.has('object-groups'))
+        registerObjectGroupTools(s, client);
+    if (activeGroups.has('transaction-links'))
+        registerTransactionLinkTools(s, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/object-groups.d.ts

@@ -0,0 +1,30 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FireflyClient } from '../client.js';
+import { type UnwrappedList, type UnwrappedSingle } from '../transform.js';
+export declare function fetchObjectGroups(client: FireflyClient, params: {
+    page?: number;
+    limit?: number;
+}): Promise<UnwrappedList>;
+export declare function fetchObjectGroup(client: FireflyClient, id: string): Promise<UnwrappedSingle>;
+export declare function createObjectGroup(client: FireflyClient, params: {
+    title: string;
+    order?: number;
+}): Promise<UnwrappedSingle>;
+export declare function updateObjectGroup(client: FireflyClient, id: string, params: {
+    title?: string;
+    order?: number;
+}): Promise<UnwrappedSingle>;
+export declare function deleteObjectGroup(client: FireflyClient, id: string): Promise<{
+    deleted: true;
+    id: string;
+}>;
+export declare function fetchObjectGroupBills(client: FireflyClient, id: string, params: {
+    page?: number;
+    limit?: number;
+}): Promise<UnwrappedList>;
+export declare function fetchObjectGroupPiggyBanks(client: FireflyClient, id: string, params: {
+    page?: number;
+    limit?: number;
+}): Promise<UnwrappedList>;
+export declare function registerObjectGroupTools(server: McpServer, client: FireflyClient): void;
+//# sourceMappingURL=object-groups.d.ts.map

package/dist/tools/object-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-groups.d.ts","sourceRoot":"","sources":["../../src/tools/object-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAIzB,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAGlG;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAGjH;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAiHvF"}

package/dist/tools/object-groups.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { unwrapList, unwrapSingle, } from '../transform.js';
+import { DELETE_ANNOTATIONS, READ_ANNOTATIONS, UPDATE_ANNOTATIONS, WRITE_ANNOTATIONS } from './_annotations.js';
+import { defineTool } from './_helpers.js';
+export async function fetchObjectGroups(client, params) {
+    const response = await client.get('/object-groups', { page: params.page, limit: params.limit });
+    return unwrapList(response);
+}
+export async function fetchObjectGroup(client, id) {
+    const response = await client.get(`/object-groups/${id}`);
+    return unwrapSingle(response);
+}
+export async function createObjectGroup(client, params) {
+    const response = await client.post('/object-groups', params);
+    return unwrapSingle(response);
+}
+export async function updateObjectGroup(client, id, params) {
+    const response = await client.put(`/object-groups/${id}`, params);
+    return unwrapSingle(response);
+}
+export async function deleteObjectGroup(client, id) {
+    await client.delete(`/object-groups/${id}`);
+    return { deleted: true, id };
+}
+export async function fetchObjectGroupBills(client, id, params) {
+    const response = await client.get(`/object-groups/${id}/bills`, {
+        page: params.page,
+        limit: params.limit,
+    });
+    return unwrapList(response);
+}
+export async function fetchObjectGroupPiggyBanks(client, id, params) {
+    const response = await client.get(`/object-groups/${id}/piggy-banks`, {
+        page: params.page,
+        limit: params.limit,
+    });
+    return unwrapList(response);
+}
+export function registerObjectGroupTools(server, client) {
+    defineTool(server, 'get_object_groups', {
+        title: 'Get Object Groups',
+        description: 'Get all object groups from Firefly III. Object groups organise accounts and piggy banks.',
+        inputSchema: {
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ page, limit }) => fetchObjectGroups(client, { page: page, limit: limit }));
+    defineTool(server, 'get_object_group', {
+        title: 'Get Object Group',
+        description: 'Get a single object group by ID. Use get_object_groups to find valid IDs.',
+        inputSchema: { id: z.string().describe('Object group ID') },
+        annotations: READ_ANNOTATIONS,
+    }, ({ id }) => fetchObjectGroup(client, id));
+    defineTool(server, 'create_object_group', {
+        title: 'Create Object Group',
+        description: 'Create a new object group to organise accounts and piggy banks.',
+        inputSchema: {
+            title: z.string().describe('Object group title'),
+            order: z.number().int().positive().optional().describe('Display order'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, (params) => createObjectGroup(client, params));
+    defineTool(server, 'update_object_group', {
+        title: 'Update Object Group',
+        description: 'Update an existing object group. Only fields provided will be changed. Use get_object_groups to find valid IDs.',
+        inputSchema: {
+            id: z.string().describe('Object group ID'),
+            title: z.string().optional().describe('Object group title'),
+            order: z.number().int().positive().optional().describe('Display order'),
+        },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ id, ...params }) => updateObjectGroup(client, id, params));
+    defineTool(server, 'delete_object_group', {
+        title: 'Delete Object Group',
+        description: 'Permanently delete an object group. **This action cannot be undone.** Use get_object_groups to confirm the ID before deleting.',
+        inputSchema: { id: z.string().describe('Object group ID') },
+        annotations: DELETE_ANNOTATIONS,
+    }, ({ id }) => deleteObjectGroup(client, id));
+    defineTool(server, 'get_object_group_bills', {
+        title: 'Get Object Group Bills',
+        description: 'Get all bills belonging to a specific object group. Use get_object_groups to find valid IDs.',
+        inputSchema: {
+            id: z.string().describe('Object group ID'),
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ id, page, limit }) => fetchObjectGroupBills(client, id, {
+        page: page,
+        limit: limit,
+    }));
+    defineTool(server, 'get_object_group_piggy_banks', {
+        title: 'Get Object Group Piggy Banks',
+        description: 'Get all piggy banks belonging to a specific object group. Use get_object_groups to find valid IDs.',
+        inputSchema: {
+            id: z.string().describe('Object group ID'),
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ id, page, limit }) => fetchObjectGroupPiggyBanks(client, id, {
+        page: page,
+        limit: limit,
+    }));
+}
+//# sourceMappingURL=object-groups.js.map

package/dist/tools/object-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-groups.js","sourceRoot":"","sources":["../../src/tools/object-groups.ts"],"names":[],"mappings":"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"}

package/dist/tools/piggy-banks.d.ts

@@ -0,0 +1,41 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FireflyClient } from '../client.js';
+import { type UnwrappedList, type UnwrappedSingle } from '../transform.js';
+export declare function fetchPiggyBanks(client: FireflyClient, params: {
+    page?: number;
+    limit?: number;
+}): Promise<UnwrappedList>;
+export declare function createPiggyBank(client: FireflyClient, params: {
+    name: string;
+    account_id: string;
+    target_amount?: string;
+    start_date?: string;
+    target_date?: string;
+    notes?: string;
+}): Promise<UnwrappedSingle>;
+export declare function updatePiggyBank(client: FireflyClient, id: string, params: {
+    name?: string;
+    account_id?: string;
+    target_amount?: string;
+    start_date?: string;
+    target_date?: string;
+    notes?: string;
+}): Promise<UnwrappedSingle>;
+export declare function deletePiggyBank(client: FireflyClient, id: string): Promise<{
+    deleted: true;
+    id: string;
+}>;
+export declare function fetchPiggyBankEvents(client: FireflyClient, id: string, params: {
+    page?: number;
+    limit?: number;
+}): Promise<UnwrappedList>;
+export declare function createPiggyBankEvent(client: FireflyClient, id: string, params: {
+    amount: string;
+    date: string;
+}): Promise<UnwrappedSingle>;
+export declare function deletePiggyBankEvent(client: FireflyClient, id: string, eventId: string): Promise<{
+    deleted: true;
+    id: string;
+}>;
+export declare function registerPiggyBankTools(server: McpServer, client: FireflyClient): void;
+//# sourceMappingURL=piggy-banks.d.ts.map

package/dist/tools/piggy-banks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"piggy-banks.d.ts","sourceRoot":"","sources":["../../src/tools/piggy-banks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAKzB,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAG/G;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAIxB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAGxC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA6HrF"}

package/dist/tools/piggy-banks.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { unwrapList, unwrapSingle, } from '../transform.js';
+import { DELETE_ANNOTATIONS, READ_ANNOTATIONS, UPDATE_ANNOTATIONS, WRITE_ANNOTATIONS } from './_annotations.js';
+import { dateSchema, defineTool } from './_helpers.js';
+export async function fetchPiggyBanks(client, params) {
+    const response = await client.get('/piggy-banks', { page: params.page, limit: params.limit });
+    return unwrapList(response);
+}
+export async function createPiggyBank(client, params) {
+    const response = await client.post('/piggy-banks', params);
+    return unwrapSingle(response);
+}
+export async function updatePiggyBank(client, id, params) {
+    const response = await client.put(`/piggy-banks/${id}`, params);
+    return unwrapSingle(response);
+}
+export async function deletePiggyBank(client, id) {
+    await client.delete(`/piggy-banks/${id}`);
+    return { deleted: true, id };
+}
+export async function fetchPiggyBankEvents(client, id, params) {
+    const query = { page: params.page, limit: params.limit };
+    const response = await client.get(`/piggy-banks/${id}/events`, query);
+    return unwrapList(response);
+}
+export async function createPiggyBankEvent(client, id, params) {
+    const response = await client.post(`/piggy-banks/${id}/events`, params);
+    return unwrapSingle(response);
+}
+export async function deletePiggyBankEvent(client, id, eventId) {
+    await client.delete(`/piggy-banks/${id}/events/${eventId}`);
+    return { deleted: true, id: eventId };
+}
+export function registerPiggyBankTools(server, client) {
+    defineTool(server, 'get_piggy_banks', {
+        title: 'Get Piggy Banks',
+        description: 'Get all piggy banks (savings goals) from Firefly III, including current saved amount and target amount.',
+        inputSchema: {
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ page, limit }) => fetchPiggyBanks(client, { page: page, limit: limit }));
+    defineTool(server, 'create_piggy_bank', {
+        title: 'Create Piggy Bank',
+        description: 'Create a new savings goal (piggy bank) in Firefly III. Requires an asset account ID to link to.',
+        inputSchema: {
+            name: z.string().describe('Piggy bank name'),
+            account_id: z.string().describe('Asset account ID to link to — use get_accounts to find valid IDs'),
+            target_amount: z.string().optional().describe('Savings goal amount as a number string'),
+            start_date: dateSchema.optional().describe('Start date (YYYY-MM-DD)'),
+            target_date: dateSchema.optional().describe('Target completion date (YYYY-MM-DD)'),
+            notes: z.string().optional().describe('Notes'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, (params) => createPiggyBank(client, params));
+    defineTool(server, 'update_piggy_bank', {
+        title: 'Update Piggy Bank',
+        description: 'Update an existing piggy bank in Firefly III. Only fields provided will be changed. Use get_piggy_banks to find valid IDs.',
+        inputSchema: {
+            id: z.string().describe('Piggy bank ID — use get_piggy_banks to find valid IDs'),
+            name: z.string().optional().describe('Piggy bank name'),
+            account_id: z.string().optional().describe('Asset account ID to link to'),
+            target_amount: z.string().optional().describe('Savings goal amount as a number string'),
+            start_date: dateSchema.optional().describe('Start date (YYYY-MM-DD)'),
+            target_date: dateSchema.optional().describe('Target completion date (YYYY-MM-DD)'),
+            notes: z.string().optional().describe('Notes'),
+        },
+        annotations: UPDATE_ANNOTATIONS,
+    }, ({ id, ...params }) => updatePiggyBank(client, id, params));
+    defineTool(server, 'delete_piggy_bank', {
+        title: 'Delete Piggy Bank',
+        description: 'Permanently delete a piggy bank (savings goal) from Firefly III. **This action cannot be undone.** Use get_piggy_banks to confirm the ID before deleting.',
+        inputSchema: { id: z.string().describe('Piggy bank ID — use get_piggy_banks to find valid IDs') },
+        annotations: DELETE_ANNOTATIONS,
+    }, ({ id }) => deletePiggyBank(client, id));
+    defineTool(server, 'get_piggy_bank_events', {
+        title: 'Get Piggy Bank Events',
+        description: 'Get all deposit/withdrawal events for a specific piggy bank. Use get_piggy_banks to find valid IDs.',
+        inputSchema: {
+            id: z.string().describe('Piggy bank ID'),
+            page: z.number().int().positive().optional().default(1).describe('Page number'),
+            limit: z.number().int().positive().max(100).optional().default(50).describe('Results per page (max 100)'),
+        },
+        annotations: READ_ANNOTATIONS,
+    }, ({ id, page, limit }) => fetchPiggyBankEvents(client, id, {
+        page: page,
+        limit: limit,
+    }));
+    defineTool(server, 'create_piggy_bank_event', {
+        title: 'Create Piggy Bank Event',
+        description: 'Add a deposit or withdrawal event to a piggy bank. Use a positive amount for a deposit and a negative amount for a withdrawal.',
+        inputSchema: {
+            id: z.string().describe('Piggy bank ID'),
+            amount: z.string().describe('Amount as a number string. Positive for deposit, negative for withdrawal.'),
+            date: z.string().describe('Event date (YYYY-MM-DD)'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, ({ id, amount, date }) => createPiggyBankEvent(client, id, { amount: amount, date: date }));
+    defineTool(server, 'delete_piggy_bank_event', {
+        title: 'Delete Piggy Bank Event',
+        description: 'Permanently delete a deposit/withdrawal event from a piggy bank. **This action cannot be undone.** Use get_piggy_bank_events to confirm the event ID.',
+        inputSchema: {
+            id: z.string().describe('Piggy bank ID'),
+            event_id: z.string().describe('Event ID — use get_piggy_bank_events to find valid IDs'),
+        },
+        annotations: DELETE_ANNOTATIONS,
+    }, ({ id, event_id }) => deletePiggyBankEvent(client, id, event_id));
+}
+//# sourceMappingURL=piggy-banks.js.map

package/dist/tools/piggy-banks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piggy-banks.js","sourceRoot":"","sources":["../../src/tools/piggy-banks.ts"],"names":[],"mappings":"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"}