monobank-mcp 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +174 -0
  2. package/dist/cache/dedup.d.ts +1 -0
  3. package/dist/cache/dedup.js +10 -0
  4. package/dist/cache/dedup.js.map +1 -0
  5. package/dist/cache/ttl-cache.d.ts +6 -0
  6. package/dist/cache/ttl-cache.js +20 -0
  7. package/dist/cache/ttl-cache.js.map +1 -0
  8. package/dist/client/base.d.ts +5 -0
  9. package/dist/client/base.js +25 -0
  10. package/dist/client/base.js.map +1 -0
  11. package/dist/client/corporate.d.ts +26 -0
  12. package/dist/client/corporate.js +70 -0
  13. package/dist/client/corporate.js.map +1 -0
  14. package/dist/client/personal.d.ts +10 -0
  15. package/dist/client/personal.js +34 -0
  16. package/dist/client/personal.js.map +1 -0
  17. package/dist/client/retry.d.ts +1 -0
  18. package/dist/client/retry.js +32 -0
  19. package/dist/client/retry.js.map +1 -0
  20. package/dist/client/signing.d.ts +6 -0
  21. package/dist/client/signing.js +24 -0
  22. package/dist/client/signing.js.map +1 -0
  23. package/dist/errors/index.d.ts +12 -0
  24. package/dist/errors/index.js +25 -0
  25. package/dist/errors/index.js.map +1 -0
  26. package/dist/index.d.ts +2 -0
  27. package/dist/index.js +14 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/server.d.ts +2 -0
  30. package/dist/server.js +89 -0
  31. package/dist/server.js.map +1 -0
  32. package/dist/tools/account.d.ts +4 -0
  33. package/dist/tools/account.js +75 -0
  34. package/dist/tools/account.js.map +1 -0
  35. package/dist/tools/corporate-auth.d.ts +3 -0
  36. package/dist/tools/corporate-auth.js +71 -0
  37. package/dist/tools/corporate-auth.js.map +1 -0
  38. package/dist/tools/corporate-settings.d.ts +3 -0
  39. package/dist/tools/corporate-settings.js +62 -0
  40. package/dist/tools/corporate-settings.js.map +1 -0
  41. package/dist/tools/currency.d.ts +4 -0
  42. package/dist/tools/currency.js +51 -0
  43. package/dist/tools/currency.js.map +1 -0
  44. package/dist/tools/jars.d.ts +4 -0
  45. package/dist/tools/jars.js +59 -0
  46. package/dist/tools/jars.js.map +1 -0
  47. package/dist/tools/statement.d.ts +4 -0
  48. package/dist/tools/statement.js +159 -0
  49. package/dist/tools/statement.js.map +1 -0
  50. package/dist/tools/webhook.d.ts +4 -0
  51. package/dist/tools/webhook.js +101 -0
  52. package/dist/tools/webhook.js.map +1 -0
  53. package/dist/types/monobank.d.ts +58 -0
  54. package/dist/types/monobank.js +13 -0
  55. package/dist/types/monobank.js.map +1 -0
  56. package/package.json +40 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"statement.js","sourceRoot":"","sources":["../../src/tools/statement.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { TtlCache } from '../cache/ttl-cache.js';
3
+ import type { PersonalClient } from '../client/personal.js';
4
+ export declare function registerWebhookTools(server: McpServer, client: PersonalClient, cache: TtlCache): void;
@@ -0,0 +1,101 @@
1
+ import { z } from 'zod';
2
+ import { AuthError, RateLimitError } from '../errors/index.js';
3
+ export function registerWebhookTools(server, client, cache) {
4
+ server.registerTool('set_webhook', {
5
+ title: 'Set Webhook',
6
+ description: 'Register a webhook URL with Monobank. Monobank will POST real-time transaction events to this URL. The URL must be publicly accessible HTTPS and respond with HTTP 200 within 5 seconds.',
7
+ inputSchema: {
8
+ url: z
9
+ .string()
10
+ .url()
11
+ .describe('Publicly accessible HTTPS URL to receive transaction events.'),
12
+ },
13
+ annotations: {
14
+ readOnlyHint: false,
15
+ destructiveHint: false,
16
+ idempotentHint: true,
17
+ openWorldHint: true,
18
+ },
19
+ }, async ({ url }) => {
20
+ try {
21
+ await client.setWebhook(url);
22
+ cache.invalidate('client-info');
23
+ return {
24
+ content: [{
25
+ type: 'text',
26
+ text: `Webhook registered at ${url}. Monobank will POST StatementItem events to this URL when transactions occur.`,
27
+ }],
28
+ };
29
+ }
30
+ catch (err) {
31
+ return handleError(err);
32
+ }
33
+ });
34
+ server.registerTool('delete_webhook', {
35
+ title: 'Delete Webhook',
36
+ description: 'Unregister the current webhook. Monobank will stop sending transaction notifications.',
37
+ annotations: {
38
+ readOnlyHint: false,
39
+ destructiveHint: true,
40
+ idempotentHint: true,
41
+ openWorldHint: true,
42
+ },
43
+ }, async () => {
44
+ try {
45
+ await client.setWebhook('');
46
+ cache.invalidate('client-info');
47
+ return { content: [{ type: 'text', text: 'Webhook unregistered.' }] };
48
+ }
49
+ catch (err) {
50
+ return handleError(err);
51
+ }
52
+ });
53
+ server.registerTool('get_webhook_status', {
54
+ title: 'Get Webhook Status',
55
+ description: 'Check the currently registered webhook URL for your account.',
56
+ annotations: {
57
+ readOnlyHint: true,
58
+ destructiveHint: false,
59
+ idempotentHint: true,
60
+ openWorldHint: false,
61
+ },
62
+ }, async () => {
63
+ try {
64
+ const cacheKey = 'client-info';
65
+ let info = cache.get(cacheKey);
66
+ if (!info) {
67
+ info = await client.getClientInfo();
68
+ cache.set(cacheKey, info, 59);
69
+ }
70
+ const url = info.webHookUrl;
71
+ const status = url ? `Active: ${url}` : 'No webhook registered.';
72
+ return { content: [{ type: 'text', text: status }] };
73
+ }
74
+ catch (err) {
75
+ return handleError(err);
76
+ }
77
+ });
78
+ }
79
+ function handleError(err) {
80
+ if (err instanceof AuthError) {
81
+ return {
82
+ content: [{ type: 'text', text: `Authentication failed: ${err.message}` }],
83
+ isError: true,
84
+ };
85
+ }
86
+ if (err instanceof RateLimitError) {
87
+ return {
88
+ content: [{
89
+ type: 'text',
90
+ text: `Rate limit hit. Retry in ${err.retryAfterSeconds ?? 60}s.`,
91
+ }],
92
+ isError: true,
93
+ };
94
+ }
95
+ const message = err instanceof Error ? err.message : String(err);
96
+ return {
97
+ content: [{ type: 'text', text: `Error: ${message}` }],
98
+ isError: true,
99
+ };
100
+ }
101
+ //# sourceMappingURL=webhook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/tools/webhook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ export interface ClientInfo {
2
+ clientId: string;
3
+ name: string;
4
+ webHookUrl: string;
5
+ permissions: string;
6
+ accounts: Account[];
7
+ jars?: Jar[];
8
+ }
9
+ export interface Account {
10
+ id: string;
11
+ sendId: string;
12
+ balance: number;
13
+ creditLimit: number;
14
+ type: 'black' | 'white' | 'platinum' | 'iron' | 'fop' | 'yellow' | 'eAid' | string;
15
+ currencyCode: number;
16
+ cashbackType: 'None' | 'UAH' | 'Miles';
17
+ maskedPan: string[];
18
+ iban: string;
19
+ }
20
+ export interface Jar {
21
+ id: string;
22
+ sendId: string;
23
+ title: string;
24
+ description: string;
25
+ currencyCode: number;
26
+ balance: number;
27
+ goal: number;
28
+ }
29
+ export interface StatementItem {
30
+ id: string;
31
+ time: number;
32
+ description: string;
33
+ mcc: number;
34
+ originalMcc: number;
35
+ amount: number;
36
+ operationAmount: number;
37
+ currencyCode: number;
38
+ commissionRate: number;
39
+ cashbackAmount: number;
40
+ balance: number;
41
+ hold: boolean;
42
+ invoiceId?: string;
43
+ receiptId?: string;
44
+ counterEdrpou?: string;
45
+ counterIban?: string;
46
+ counterName?: string;
47
+ comment?: string;
48
+ }
49
+ export interface ExchangeRate {
50
+ currencyCodeA: number;
51
+ currencyCodeB: number;
52
+ date: number;
53
+ rateSell?: number;
54
+ rateBuy?: number;
55
+ rateCross?: number;
56
+ }
57
+ export declare function formatAmount(kopiykas: number): string;
58
+ export declare const CURRENCY_SYMBOLS: Record<number, string>;
@@ -0,0 +1,13 @@
1
+ export function formatAmount(kopiykas) {
2
+ return (kopiykas / 100).toFixed(2);
3
+ }
4
+ export const CURRENCY_SYMBOLS = {
5
+ 980: 'UAH',
6
+ 840: 'USD',
7
+ 978: 'EUR',
8
+ 826: 'GBP',
9
+ 756: 'CHF',
10
+ 985: 'PLN',
11
+ 203: 'CZK',
12
+ };
13
+ //# sourceMappingURL=monobank.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"monobank.js","sourceRoot":"","sources":["../../src/types/monobank.ts"],"names":[],"mappings":"AA6DA,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;CACX,CAAC"}
package/package.json ADDED
@@ -0,0 +1,40 @@
1
+ {
2
+ "name": "monobank-mcp",
3
+ "version": "2.0.0",
4
+ "description": "MCP server for Monobank Open API — accounts, statements, exchange rates, jars, webhooks",
5
+ "type": "module",
6
+ "bin": {
7
+ "monobank-mcp": "dist/index.js"
8
+ },
9
+ "scripts": {
10
+ "build": "tsc",
11
+ "dev": "tsx watch src/index.ts",
12
+ "start": "node dist/index.js",
13
+ "test": "vitest run"
14
+ },
15
+ "keywords": [
16
+ "mcp",
17
+ "monobank",
18
+ "banking",
19
+ "ukraine",
20
+ "llm",
21
+ "ai-agent"
22
+ ],
23
+ "license": "MIT",
24
+ "engines": {
25
+ "node": ">=18"
26
+ },
27
+ "files": [
28
+ "dist"
29
+ ],
30
+ "dependencies": {
31
+ "@modelcontextprotocol/sdk": "^1.29.0",
32
+ "zod": "^4.4.3"
33
+ },
34
+ "devDependencies": {
35
+ "@types/node": "^25.9.1",
36
+ "tsx": "^4.22.3",
37
+ "typescript": "^6.0.3",
38
+ "vitest": "^4.1.7"
39
+ }
40
+ }