monobank-mcp 2.0.0

package/dist/server.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TtlCache } from './cache/ttl-cache.js';
+import { CorporateClient } from './client/corporate.js';
+import { PersonalClient } from './client/personal.js';
+import { apiFetch } from './client/base.js';
+import { withRetry } from './client/retry.js';
+import { loadPrivateKey } from './client/signing.js';
+import { registerAccountTools } from './tools/account.js';
+import { registerCorporateAuthTools } from './tools/corporate-auth.js';
+import { registerCorporateSettingsTools } from './tools/corporate-settings.js';
+import { registerCurrencyTools } from './tools/currency.js';
+import { registerJarTools } from './tools/jars.js';
+import { registerStatementTools } from './tools/statement.js';
+import { registerWebhookTools } from './tools/webhook.js';
+export function createServer() {
+    const mode = (process.env.MONOBANK_AUTH_MODE ?? 'personal');
+    const server = new McpServer({ name: 'monobank-mcp', version: '1.0.0' }, {
+        capabilities: {
+            logging: {},
+        },
+        instructions: 'Monobank banking MCP server. Provides access to Ukrainian bank account balances, ' +
+            'transaction history (statements), currency exchange rates, savings jars, and webhook management. ' +
+            (mode === 'personal'
+                ? 'Rate limit: 1 request per 60 seconds for personal API endpoints (client-info, statement). '
+                : 'Corporate mode: no rate limits. Per-user endpoints require a requestId from the auth flow. ') +
+            'Results are cached automatically. Use get_client_info first to discover available accounts.',
+    });
+    const cache = new TtlCache();
+    if (mode === 'corporate') {
+        const keyId = process.env.MONOBANK_KEY_ID;
+        if (!keyId)
+            throw new Error('MONOBANK_KEY_ID is required for corporate mode');
+        const privateKeyPem = loadPrivateKey();
+        const client = new CorporateClient(keyId, privateKeyPem);
+        registerCorporateAuthTools(server, client);
+        registerCorporateSettingsTools(server, client);
+        registerCurrencyTools(server, client, cache);
+    }
+    else {
+        const token = process.env.MONOBANK_TOKEN;
+        if (!token)
+            throw new Error('MONOBANK_TOKEN is required for personal mode');
+        const client = new PersonalClient(token);
+        registerAccountTools(server, client, cache);
+        registerStatementTools(server, client, cache);
+        registerCurrencyTools(server, client, cache);
+        registerWebhookTools(server, client, cache);
+        registerJarTools(server, client, cache);
+    }
+    registerResources(server, mode, cache);
+    registerPrompts(server);
+    return server;
+}
+function registerResources(server, _mode, cache) {
+    server.registerResource('exchange-rates', 'monobank://exchange-rates', {
+        description: 'Current Monobank exchange rates for all currency pairs',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const cacheKey = 'resource:exchange-rates';
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { contents: [{ uri: uri.href, mimeType: 'application/json', text: cached }] };
+        }
+        const rates = await withRetry(() => apiFetch('/bank/currency'));
+        const text = JSON.stringify(rates, null, 2);
+        cache.set(cacheKey, text, 300);
+        return { contents: [{ uri: uri.href, mimeType: 'application/json', text }] };
+    });
+}
+function registerPrompts(server) {
+    server.registerPrompt('spending-analysis', {
+        title: 'Analyze Spending',
+        description: 'Analyze spending patterns for a given time period',
+        argsSchema: {
+            period: z.enum(['week', 'month', 'quarter']).describe('Time period to analyze'),
+            account_id: z.string().optional().describe('Specific account ID (optional, defaults to main card)'),
+        },
+    }, async ({ period, account_id }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Analyze my spending for the last ${period}. ${account_id ? `Focus on account ${account_id}.` : 'Use the default card.'} Steps:\n1. Use get_statement to fetch transactions for the period\n2. Categorize transactions by MCC code\n3. Calculate totals per category\n4. Identify the largest expenses\n5. Note any unusual spending patterns`,
+                },
+            }],
+    }));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/account.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TtlCache } from '../cache/ttl-cache.js';
+import type { PersonalClient } from '../client/personal.js';
+export declare function registerAccountTools(server: McpServer, client: PersonalClient, cache: TtlCache): void;

package/dist/tools/account.js

@@ -0,0 +1,75 @@
+import { AuthError, RateLimitError } from '../errors/index.js';
+import { CURRENCY_SYMBOLS, formatAmount } from '../types/monobank.js';
+export function registerAccountTools(server, client, cache) {
+    server.registerTool('get_client_info', {
+        title: 'Get Client Info',
+        description: 'Get client profile, all bank accounts and savings jars. Includes balances, IBANs, and account types. Results are cached for 59 seconds.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async () => {
+        try {
+            const cacheKey = 'client-info';
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                return { content: [{ type: 'text', text: formatClientInfo(cached) }] };
+            }
+            const info = await client.getClientInfo();
+            cache.set(cacheKey, info, 59);
+            return { content: [{ type: 'text', text: formatClientInfo(info) }] };
+        }
+        catch (err) {
+            return handleToolError(err);
+        }
+    });
+}
+function formatClientInfo(info) {
+    const formatted = {
+        name: info.name,
+        accounts: (info.accounts ?? []).map((a) => ({
+            id: a.id,
+            iban: a.iban,
+            type: a.type,
+            currency: CURRENCY_SYMBOLS[a.currencyCode] ?? a.currencyCode,
+            balance: formatAmount(a.balance),
+            creditLimit: a.creditLimit > 0 ? formatAmount(a.creditLimit) : undefined,
+            cashback: a.cashbackType,
+        })),
+        jars: (info.jars ?? []).map((j) => ({
+            id: j.id,
+            title: j.title,
+            balance: formatAmount(j.balance),
+            goal: j.goal > 0 ? formatAmount(j.goal) : undefined,
+            currency: CURRENCY_SYMBOLS[j.currencyCode] ?? j.currencyCode,
+        })),
+    };
+    return JSON.stringify(formatted, null, 2);
+}
+function handleToolError(err) {
+    if (err instanceof AuthError) {
+        return {
+            content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+    if (err instanceof RateLimitError) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Rate limit hit. Monobank allows 1 request per 60 seconds. Retry in ${err.retryAfterSeconds ?? 60}s. Cached results are served automatically.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=account.js.map

package/dist/tools/account.js.map

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

package/dist/tools/corporate-auth.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CorporateClient } from '../client/corporate.js';
+export declare function registerCorporateAuthTools(server: McpServer, client: CorporateClient): void;

package/dist/tools/corporate-auth.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { AuthError } from '../errors/index.js';
+export function registerCorporateAuthTools(server, client) {
+    server.registerTool('initiate_authorization', {
+        title: 'Initiate Authorization',
+        description: '[Corporate API only] Start the user authorization flow. Returns a URL the user must open in their Monobank app to approve access. Poll check_authorization with the returned requestId to confirm approval.',
+        inputSchema: {
+            callback_url: z.string().url()
+                .describe('Publicly accessible HTTPS URL where Monobank will POST the authorization result'),
+            permissions: z.string().optional().default('sp')
+                .describe("Permission flags: 's' = statements, 'p' = personal info. Default: 'sp' (both)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ callback_url, permissions }) => {
+        try {
+            const result = await client.initiateAuthorization(callback_url, permissions);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Authorization initiated.\n\nAsk the user to open this URL in their Monobank app:\n${result.acceptUrl}\n\nRequest ID: ${result.tokenRequestId}\n\nUse check_authorization with this ID to confirm approval.`,
+                    }],
+            };
+        }
+        catch (err) {
+            return handleError(err);
+        }
+    });
+    server.registerTool('check_authorization', {
+        title: 'Check Authorization',
+        description: '[Corporate API only] Check if a user has approved the authorization request.',
+        inputSchema: {
+            request_id: z.string()
+                .describe('The tokenRequestId returned by initiate_authorization'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ request_id }) => {
+        try {
+            const result = await client.checkAuthorization(request_id);
+            return {
+                content: [{ type: 'text', text: `Status: ${result.status}` }],
+            };
+        }
+        catch (err) {
+            return handleError(err);
+        }
+    });
+}
+function handleError(err) {
+    if (err instanceof AuthError) {
+        return {
+            content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=corporate-auth.js.map

package/dist/tools/corporate-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corporate-auth.js","sourceRoot":"","sources":["../../src/tools/corporate-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,MAAuB;IAEvB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,6MAA6M;QAC/M,WAAW,EAAE;YACX,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;iBAC3B,QAAQ,CAAC,iFAAiF,CAAC;YAC9F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;iBAC7C,QAAQ,CAAC,+EAA+E,CAAC;SAC7F;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qFAAqF,MAAM,CAAC,SAAS,mBAAmB,MAAM,CAAC,cAAc,+DAA+D;qBACnN,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,8EAA8E;QAChF,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;iBACnB,QAAQ,CAAC,uDAAuD,CAAC;SACrE;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC3D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/corporate-settings.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CorporateClient } from '../client/corporate.js';
+export declare function registerCorporateSettingsTools(server: McpServer, client: CorporateClient): void;

package/dist/tools/corporate-settings.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { AuthError } from '../errors/index.js';
+export function registerCorporateSettingsTools(server, client) {
+    server.registerTool('get_corp_settings', {
+        title: 'Get Corporate Settings',
+        description: '[Corporate API only] Get corporate application settings including registered public key, app name, permissions, and webhook URL.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async () => {
+        try {
+            const settings = await client.getCorpSettings();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(settings, null, 2) }],
+            };
+        }
+        catch (err) {
+            return handleError(err);
+        }
+    });
+    server.registerTool('set_corp_webhook', {
+        title: 'Set Corporate Webhook',
+        description: '[Corporate API only] Set or update the webhook URL for the corporate application.',
+        inputSchema: {
+            url: z.string().url()
+                .describe('Publicly accessible HTTPS URL to receive events'),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ url }) => {
+        try {
+            await client.setCorpWebhook(url);
+            return {
+                content: [{ type: 'text', text: `Corporate webhook set to: ${url}` }],
+            };
+        }
+        catch (err) {
+            return handleError(err);
+        }
+    });
+}
+function handleError(err) {
+    if (err instanceof AuthError) {
+        return {
+            content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=corporate-settings.js.map

package/dist/tools/corporate-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corporate-settings.js","sourceRoot":"","sources":["../../src/tools/corporate-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,8BAA8B,CAC5C,MAAiB,EACjB,MAAuB;IAEvB,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,kIAAkI;QACpI,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,mFAAmF;QACrF,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;iBAClB,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,6BAA6B,GAAG,EAAE,EAAE,CAAC;aAC/E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/currency.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TtlCache } from '../cache/ttl-cache.js';
+import type { PersonalClient } from '../client/personal.js';
+export declare function registerCurrencyTools(server: McpServer, client: PersonalClient, cache: TtlCache): void;

package/dist/tools/currency.js

@@ -0,0 +1,51 @@
+import { CURRENCY_SYMBOLS } from '../types/monobank.js';
+const CACHE_TTL_SECONDS = 300; // 5 minutes — Monobank updates rates every 5 min
+export function registerCurrencyTools(server, client, cache) {
+    server.registerTool('get_exchange_rates', {
+        title: 'Get Exchange Rates',
+        description: 'Get current Monobank exchange rates (UAH/USD/EUR and 100+ other pairs). Public endpoint, no auth required. Cached for 5 minutes.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async () => {
+        try {
+            const cacheKey = 'exchange-rates';
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                return { content: [{ type: 'text', text: formatRates(cached) }] };
+            }
+            const rates = await client.getExchangeRates();
+            cache.set(cacheKey, rates, CACHE_TTL_SECONDS);
+            return { content: [{ type: 'text', text: formatRates(rates) }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error fetching exchange rates: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+function formatRates(rates) {
+    const formatted = rates.map((r) => {
+        const from = CURRENCY_SYMBOLS[r.currencyCodeA] ?? r.currencyCodeA;
+        const to = CURRENCY_SYMBOLS[r.currencyCodeB] ?? r.currencyCodeB;
+        const result = {
+            pair: `${from}/${to}`,
+            date: new Date(r.date * 1000).toISOString(),
+        };
+        if (r.rateBuy != null)
+            result.buy = r.rateBuy;
+        if (r.rateSell != null)
+            result.sell = r.rateSell;
+        if (r.rateCross != null)
+            result.cross = r.rateCross;
+        return result;
+    });
+    return JSON.stringify(formatted, null, 2);
+}
+//# sourceMappingURL=currency.js.map

package/dist/tools/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/tools/currency.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,iBAAiB,GAAG,GAAG,CAAC,CAAC,iDAAiD;AAEhF,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAsB,EACtB,KAAe;IAEf,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,kIAAkI;QACpI,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAClC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAiB,QAAQ,CAAC,CAAC;YACnD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7E,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC9C,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;YAE9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kCAAkC,OAAO,EAAE,EAAE,CAAC;gBACvF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC;QAClE,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC;QAChE,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE;YACrB,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;SAC5C,CAAC;QACF,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;QAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC;QACjD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI;YAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/tools/jars.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TtlCache } from '../cache/ttl-cache.js';
+import type { PersonalClient } from '../client/personal.js';
+export declare function registerJarTools(server: McpServer, client: PersonalClient, cache: TtlCache): void;

package/dist/tools/jars.js

@@ -0,0 +1,59 @@
+import { AuthError, RateLimitError } from '../errors/index.js';
+import { CURRENCY_SYMBOLS, formatAmount } from '../types/monobank.js';
+export function registerJarTools(server, client, cache) {
+    server.registerTool('get_jars', {
+        title: 'Get Jars',
+        description: 'Get all savings jars (копилки) with current balances and goals.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async () => {
+        try {
+            const cacheKey = 'client-info';
+            let info = cache.get(cacheKey);
+            if (!info) {
+                info = await client.getClientInfo();
+                cache.set(cacheKey, info, 59);
+            }
+            if (!info.jars || info.jars.length === 0) {
+                return { content: [{ type: 'text', text: 'No savings jars found.' }] };
+            }
+            const jars = info.jars.map((j) => ({
+                id: j.id,
+                title: j.title,
+                description: j.description || undefined,
+                balance: formatAmount(j.balance),
+                goal: j.goal > 0 ? formatAmount(j.goal) : 'No goal set',
+                progress: j.goal > 0 ? `${((j.balance / j.goal) * 100).toFixed(1)}%` : undefined,
+                currency: CURRENCY_SYMBOLS[j.currencyCode] ?? j.currencyCode,
+            }));
+            return { content: [{ type: 'text', text: JSON.stringify(jars, null, 2) }] };
+        }
+        catch (err) {
+            if (err instanceof AuthError) {
+                return {
+                    content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
+                    isError: true,
+                };
+            }
+            if (err instanceof RateLimitError) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Rate limit hit. Retry in ${err.retryAfterSeconds ?? 60}s.`,
+                        }],
+                    isError: true,
+                };
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=jars.js.map

package/dist/tools/jars.js.map

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

package/dist/tools/statement.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TtlCache } from '../cache/ttl-cache.js';
+import type { PersonalClient } from '../client/personal.js';
+export declare function registerStatementTools(server: McpServer, client: PersonalClient, cache: TtlCache): void;

package/dist/tools/statement.js

@@ -0,0 +1,159 @@
+import { z } from 'zod';
+import { AuthError, RateLimitError } from '../errors/index.js';
+import { CURRENCY_SYMBOLS, formatAmount } from '../types/monobank.js';
+const MAX_RANGE_SECONDS = 31 * 24 * 60 * 60; // 31 days
+export function registerStatementTools(server, client, cache) {
+    server.registerTool('get_statement', {
+        title: 'Get Statement',
+        description: 'Get transaction history for a date range (max 31 days). Cached for 59 seconds.',
+        inputSchema: {
+            account_id: z
+                .string()
+                .optional()
+                .default('0')
+                .describe("Account ID from get_client_info. Use '0' for the default (black) card"),
+            from_date: z
+                .string()
+                .describe("Start date in ISO 8601 format (e.g. '2024-01-01') or Unix timestamp in seconds"),
+            to_date: z
+                .string()
+                .optional()
+                .describe('End date in ISO 8601 format. Defaults to now. Max range: 31 days'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .optional()
+                .default(50)
+                .describe('Maximum number of transactions to return (default: 50, max: 500)'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ account_id, from_date, to_date, limit }) => {
+        try {
+            const from = parseTimestamp(from_date);
+            const to = to_date ? parseTimestamp(to_date) : Math.floor(Date.now() / 1000);
+            if (to - from > MAX_RANGE_SECONDS) {
+                return {
+                    content: [{ type: 'text', text: 'Error: Date range exceeds 31 days. Monobank limits statement queries to 31 days maximum.' }],
+                    isError: true,
+                };
+            }
+            if (from > to) {
+                return {
+                    content: [{ type: 'text', text: 'Error: from_date must be before to_date.' }],
+                    isError: true,
+                };
+            }
+            const cacheKey = `statement:${account_id}:${from}:${to}`;
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                const sliced = cached.slice(0, limit);
+                return { content: [{ type: 'text', text: JSON.stringify(sliced, null, 2) }] };
+            }
+            const items = await client.getStatement(account_id, from, to);
+            const formatted = formatStatementItems(items);
+            cache.set(cacheKey, formatted, 59);
+            const sliced = formatted.slice(0, limit);
+            return {
+                content: [{
+                        type: 'text',
+                        text: sliced.length === 0
+                            ? 'No transactions in this period.'
+                            : JSON.stringify(sliced, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            return handleToolError(err);
+        }
+    });
+    server.registerTool('get_recent_transactions', {
+        title: 'Get Recent Transactions',
+        description: 'Get the most recent transactions from an account. Use this to check for new activity, monitor spending, or find a specific payment.',
+        inputSchema: {
+            account_id: z.string().optional().default('0')
+                .describe("Account ID. Use '0' for default card. Get IDs via get_client_info"),
+            minutes: z.number().int().min(1).max(43200).optional().default(60)
+                .describe('How many minutes back to look (default: 60, max: 43200 = 30 days)'),
+            limit: z.number().int().min(1).max(100).optional().default(20)
+                .describe('Max transactions to return (default: 20)'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ account_id, minutes, limit }) => {
+        try {
+            const to = Math.floor(Date.now() / 1000);
+            const from = to - minutes * 60;
+            const items = await client.getStatement(account_id, from, to);
+            const formatted = formatStatementItems(items).slice(0, limit);
+            return {
+                content: [{
+                        type: 'text',
+                        text: formatted.length === 0
+                            ? 'No transactions in this period.'
+                            : JSON.stringify(formatted, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            return handleToolError(err);
+        }
+    });
+}
+function parseTimestamp(value) {
+    const asNumber = Number(value);
+    if (!isNaN(asNumber) && asNumber > 1_000_000_000 && asNumber < 10_000_000_000) {
+        return Math.floor(asNumber);
+    }
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid date: "${value}". Use ISO 8601 format (e.g. "2024-01-01") or Unix timestamp in seconds.`);
+    }
+    return Math.floor(date.getTime() / 1000);
+}
+function formatStatementItems(items) {
+    return items.map((item) => ({
+        time: new Date(item.time * 1000).toISOString(),
+        description: item.description,
+        amount: `${formatAmount(item.amount)} ${CURRENCY_SYMBOLS[item.currencyCode] ?? item.currencyCode}`,
+        balance: formatAmount(item.balance),
+        mcc: item.mcc,
+        hold: item.hold,
+        ...(item.comment ? { comment: item.comment } : {}),
+    }));
+}
+function handleToolError(err) {
+    if (err instanceof AuthError) {
+        return {
+            content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+    if (err instanceof RateLimitError) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Rate limit hit. Monobank allows 1 request per 60 seconds. Retry in ${err.retryAfterSeconds ?? 60}s.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=statement.js.map