@monnify/mcp-server 1.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 (192) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +563 -0
  3. package/build/auth/tokenManager.d.ts +11 -0
  4. package/build/auth/tokenManager.d.ts.map +1 -0
  5. package/build/auth/tokenManager.js +62 -0
  6. package/build/auth/tokenManager.js.map +1 -0
  7. package/build/cli.d.ts +3 -0
  8. package/build/cli.d.ts.map +1 -0
  9. package/build/cli.js +39 -0
  10. package/build/cli.js.map +1 -0
  11. package/build/client/monnifyClient.d.ts +7 -0
  12. package/build/client/monnifyClient.d.ts.map +1 -0
  13. package/build/client/monnifyClient.js +119 -0
  14. package/build/client/monnifyClient.js.map +1 -0
  15. package/build/config/env.d.ts +47 -0
  16. package/build/config/env.d.ts.map +1 -0
  17. package/build/config/env.js +39 -0
  18. package/build/config/env.js.map +1 -0
  19. package/build/index.d.ts +36 -0
  20. package/build/index.d.ts.map +1 -0
  21. package/build/index.js +84 -0
  22. package/build/index.js.map +1 -0
  23. package/build/schemas/compat.d.ts +24 -0
  24. package/build/schemas/compat.d.ts.map +1 -0
  25. package/build/schemas/compat.js +20 -0
  26. package/build/schemas/compat.js.map +1 -0
  27. package/build/schemas/extended/collections.d.ts +439 -0
  28. package/build/schemas/extended/collections.d.ts.map +1 -0
  29. package/build/schemas/extended/collections.js +403 -0
  30. package/build/schemas/extended/collections.js.map +1 -0
  31. package/build/schemas/extended/directDebit.d.ts +123 -0
  32. package/build/schemas/extended/directDebit.d.ts.map +1 -0
  33. package/build/schemas/extended/directDebit.js +121 -0
  34. package/build/schemas/extended/directDebit.js.map +1 -0
  35. package/build/schemas/extended/verification.d.ts +55 -0
  36. package/build/schemas/extended/verification.d.ts.map +1 -0
  37. package/build/schemas/extended/verification.js +51 -0
  38. package/build/schemas/extended/verification.js.map +1 -0
  39. package/build/schemas/generated.d.ts +4 -0
  40. package/build/schemas/generated.d.ts.map +1 -0
  41. package/build/schemas/generated.js +2603 -0
  42. package/build/schemas/generated.js.map +1 -0
  43. package/build/security/guards.d.ts +5 -0
  44. package/build/security/guards.d.ts.map +1 -0
  45. package/build/security/guards.js +43 -0
  46. package/build/security/guards.js.map +1 -0
  47. package/build/security/sanitiser.d.ts +46 -0
  48. package/build/security/sanitiser.d.ts.map +1 -0
  49. package/build/security/sanitiser.js +269 -0
  50. package/build/security/sanitiser.js.map +1 -0
  51. package/build/tools/collections/authoriseCard3ds.d.ts +7 -0
  52. package/build/tools/collections/authoriseCard3ds.d.ts.map +1 -0
  53. package/build/tools/collections/authoriseCard3ds.js +63 -0
  54. package/build/tools/collections/authoriseCard3ds.js.map +1 -0
  55. package/build/tools/collections/authoriseCardOtp.d.ts +7 -0
  56. package/build/tools/collections/authoriseCardOtp.d.ts.map +1 -0
  57. package/build/tools/collections/authoriseCardOtp.js +55 -0
  58. package/build/tools/collections/authoriseCardOtp.js.map +1 -0
  59. package/build/tools/collections/chargeCard.d.ts +7 -0
  60. package/build/tools/collections/chargeCard.d.ts.map +1 -0
  61. package/build/tools/collections/chargeCard.js +59 -0
  62. package/build/tools/collections/chargeCard.js.map +1 -0
  63. package/build/tools/collections/chargeCardToken.d.ts +7 -0
  64. package/build/tools/collections/chargeCardToken.d.ts.map +1 -0
  65. package/build/tools/collections/chargeCardToken.js +68 -0
  66. package/build/tools/collections/chargeCardToken.js.map +1 -0
  67. package/build/tools/collections/createInvoice.d.ts +7 -0
  68. package/build/tools/collections/createInvoice.d.ts.map +1 -0
  69. package/build/tools/collections/createInvoice.js +57 -0
  70. package/build/tools/collections/createInvoice.js.map +1 -0
  71. package/build/tools/collections/deallocateReservedAccount.d.ts +14 -0
  72. package/build/tools/collections/deallocateReservedAccount.d.ts.map +1 -0
  73. package/build/tools/collections/deallocateReservedAccount.js +55 -0
  74. package/build/tools/collections/deallocateReservedAccount.js.map +1 -0
  75. package/build/tools/collections/getAllTransactions.d.ts +47 -0
  76. package/build/tools/collections/getAllTransactions.d.ts.map +1 -0
  77. package/build/tools/collections/getAllTransactions.js +140 -0
  78. package/build/tools/collections/getAllTransactions.js.map +1 -0
  79. package/build/tools/collections/getReservedAccount.d.ts +14 -0
  80. package/build/tools/collections/getReservedAccount.d.ts.map +1 -0
  81. package/build/tools/collections/getReservedAccount.js +55 -0
  82. package/build/tools/collections/getReservedAccount.js.map +1 -0
  83. package/build/tools/collections/getReservedAccountTransactions.d.ts +20 -0
  84. package/build/tools/collections/getReservedAccountTransactions.d.ts.map +1 -0
  85. package/build/tools/collections/getReservedAccountTransactions.js +86 -0
  86. package/build/tools/collections/getReservedAccountTransactions.js.map +1 -0
  87. package/build/tools/collections/getTransactionDetails.d.ts +14 -0
  88. package/build/tools/collections/getTransactionDetails.d.ts.map +1 -0
  89. package/build/tools/collections/getTransactionDetails.js +60 -0
  90. package/build/tools/collections/getTransactionDetails.js.map +1 -0
  91. package/build/tools/collections/getTransactionStatus.d.ts +7 -0
  92. package/build/tools/collections/getTransactionStatus.d.ts.map +1 -0
  93. package/build/tools/collections/getTransactionStatus.js +58 -0
  94. package/build/tools/collections/getTransactionStatus.js.map +1 -0
  95. package/build/tools/collections/initiatePayment.d.ts +7 -0
  96. package/build/tools/collections/initiatePayment.d.ts.map +1 -0
  97. package/build/tools/collections/initiatePayment.js +63 -0
  98. package/build/tools/collections/initiatePayment.js.map +1 -0
  99. package/build/tools/collections/payWithBankTransfer.d.ts +7 -0
  100. package/build/tools/collections/payWithBankTransfer.d.ts.map +1 -0
  101. package/build/tools/collections/payWithBankTransfer.js +55 -0
  102. package/build/tools/collections/payWithBankTransfer.js.map +1 -0
  103. package/build/tools/collections/processRefund.d.ts +7 -0
  104. package/build/tools/collections/processRefund.d.ts.map +1 -0
  105. package/build/tools/collections/processRefund.js +55 -0
  106. package/build/tools/collections/processRefund.js.map +1 -0
  107. package/build/tools/collections/reserveAccount.d.ts +7 -0
  108. package/build/tools/collections/reserveAccount.d.ts.map +1 -0
  109. package/build/tools/collections/reserveAccount.js +57 -0
  110. package/build/tools/collections/reserveAccount.js.map +1 -0
  111. package/build/tools/directDebit/cancelMandate.d.ts +7 -0
  112. package/build/tools/directDebit/cancelMandate.d.ts.map +1 -0
  113. package/build/tools/directDebit/cancelMandate.js +55 -0
  114. package/build/tools/directDebit/cancelMandate.js.map +1 -0
  115. package/build/tools/directDebit/createMandate.d.ts +7 -0
  116. package/build/tools/directDebit/createMandate.d.ts.map +1 -0
  117. package/build/tools/directDebit/createMandate.js +55 -0
  118. package/build/tools/directDebit/createMandate.js.map +1 -0
  119. package/build/tools/directDebit/debitMandate.d.ts +7 -0
  120. package/build/tools/directDebit/debitMandate.d.ts.map +1 -0
  121. package/build/tools/directDebit/debitMandate.js +55 -0
  122. package/build/tools/directDebit/debitMandate.js.map +1 -0
  123. package/build/tools/directDebit/getMandateDebitStatus.d.ts +7 -0
  124. package/build/tools/directDebit/getMandateDebitStatus.d.ts.map +1 -0
  125. package/build/tools/directDebit/getMandateDebitStatus.js +55 -0
  126. package/build/tools/directDebit/getMandateDebitStatus.js.map +1 -0
  127. package/build/tools/directDebit/getMandateStatus.d.ts +7 -0
  128. package/build/tools/directDebit/getMandateStatus.d.ts.map +1 -0
  129. package/build/tools/directDebit/getMandateStatus.js +55 -0
  130. package/build/tools/directDebit/getMandateStatus.js.map +1 -0
  131. package/build/tools/registry.d.ts +11 -0
  132. package/build/tools/registry.d.ts.map +1 -0
  133. package/build/tools/registry.js +15 -0
  134. package/build/tools/registry.js.map +1 -0
  135. package/build/tools/utilities/getSupportedBanks.d.ts +8 -0
  136. package/build/tools/utilities/getSupportedBanks.d.ts.map +1 -0
  137. package/build/tools/utilities/getSupportedBanks.js +47 -0
  138. package/build/tools/utilities/getSupportedBanks.js.map +1 -0
  139. package/build/tools/utilities/getTransactionList.d.ts +47 -0
  140. package/build/tools/utilities/getTransactionList.d.ts.map +1 -0
  141. package/build/tools/utilities/getTransactionList.js +136 -0
  142. package/build/tools/utilities/getTransactionList.js.map +1 -0
  143. package/build/tools/verification/verifyBankAccount.d.ts +7 -0
  144. package/build/tools/verification/verifyBankAccount.d.ts.map +1 -0
  145. package/build/tools/verification/verifyBankAccount.js +58 -0
  146. package/build/tools/verification/verifyBankAccount.js.map +1 -0
  147. package/build/tools/verification/verifyBvn.d.ts +7 -0
  148. package/build/tools/verification/verifyBvn.d.ts.map +1 -0
  149. package/build/tools/verification/verifyBvn.js +55 -0
  150. package/build/tools/verification/verifyBvn.js.map +1 -0
  151. package/build/tools/verification/verifyBvnInfo.d.ts +7 -0
  152. package/build/tools/verification/verifyBvnInfo.d.ts.map +1 -0
  153. package/build/tools/verification/verifyBvnInfo.js +55 -0
  154. package/build/tools/verification/verifyBvnInfo.js.map +1 -0
  155. package/build/tools/verification/verifyNin.d.ts +7 -0
  156. package/build/tools/verification/verifyNin.d.ts.map +1 -0
  157. package/build/tools/verification/verifyNin.js +55 -0
  158. package/build/tools/verification/verifyNin.js.map +1 -0
  159. package/build/transport/http.d.ts +3 -0
  160. package/build/transport/http.d.ts.map +1 -0
  161. package/build/transport/http.js +71 -0
  162. package/build/transport/http.js.map +1 -0
  163. package/build/transport/stdio.d.ts +3 -0
  164. package/build/transport/stdio.d.ts.map +1 -0
  165. package/build/transport/stdio.js +8 -0
  166. package/build/transport/stdio.js.map +1 -0
  167. package/build/types/mcp.d.ts +11 -0
  168. package/build/types/mcp.d.ts.map +1 -0
  169. package/build/types/mcp.js +7 -0
  170. package/build/types/mcp.js.map +1 -0
  171. package/build/utils/clientContext.d.ts +7 -0
  172. package/build/utils/clientContext.d.ts.map +1 -0
  173. package/build/utils/clientContext.js +24 -0
  174. package/build/utils/clientContext.js.map +1 -0
  175. package/build/utils/errors.d.ts +21 -0
  176. package/build/utils/errors.d.ts.map +1 -0
  177. package/build/utils/errors.js +45 -0
  178. package/build/utils/errors.js.map +1 -0
  179. package/build/utils/format.d.ts +34 -0
  180. package/build/utils/format.d.ts.map +1 -0
  181. package/build/utils/format.js +362 -0
  182. package/build/utils/format.js.map +1 -0
  183. package/build/utils/formatters.d.ts +4 -0
  184. package/build/utils/formatters.d.ts.map +1 -0
  185. package/build/utils/formatters.js +26 -0
  186. package/build/utils/formatters.js.map +1 -0
  187. package/build/utils/logger.d.ts +3 -0
  188. package/build/utils/logger.d.ts.map +1 -0
  189. package/build/utils/logger.js +30 -0
  190. package/build/utils/logger.js.map +1 -0
  191. package/openapi/monnify.yaml +9295 -0
  192. package/package.json +55 -0
package/build/cli.js ADDED
@@ -0,0 +1,39 @@
1
+ #!/usr/bin/env node
2
+ import { Command } from "commander";
3
+ const program = new Command();
4
+ program
5
+ .name("monnify-mcp")
6
+ .description("MCP server for Monnify payment APIs")
7
+ .version("1.0.0")
8
+ .requiredOption("--apiKey <key>", "Monnify API key (from Dashboard → Settings → API Keys)")
9
+ .requiredOption("--secretKey <secret>", "Monnify secret key")
10
+ .requiredOption("--contractCode <code>", "Monnify contract code")
11
+ .option("--env <environment>", "Target environment: sandbox or production", "sandbox")
12
+ .option("--transport <transport>", "Transport mode: stdio or http", "stdio")
13
+ .option("--port <port>", "HTTP port (only used when --transport=http)", "3000")
14
+ .option("--tools <categories>", "Comma-separated list of tool categories to enable: collections,directDebit,verification,utilities")
15
+ .option("--format <format>", "Response format override: auto (default), markdown, or json. Auto detects the client — Claude clients get markdown, engineering tools (VS Code, Copilot, Cursor) get JSON.", "auto")
16
+ .option("--httpToken <token>", "Bearer token to authenticate /mcp requests (only used with --transport=http). Strongly recommended when exposing the server beyond localhost.")
17
+ .parse(process.argv);
18
+ const opts = program.opts();
19
+ process.env["MONNIFY_API_KEY"] = opts.apiKey;
20
+ process.env["MONNIFY_SECRET_KEY"] = opts.secretKey;
21
+ process.env["MONNIFY_CONTRACT_CODE"] = opts.contractCode;
22
+ process.env["MONNIFY_ENV"] = opts.env;
23
+ process.env["MONNIFY_BASE_URL"] =
24
+ opts.env === "production"
25
+ ? "https://app.monnify.com"
26
+ : "https://sandbox.monnify.com";
27
+ process.env["TRANSPORT"] = opts.transport;
28
+ process.env["PORT"] = opts.port;
29
+ if (opts.tools) {
30
+ process.env["MONNIFY_ALLOWED_OPERATIONS"] = opts.tools;
31
+ }
32
+ if (opts.format && opts.format !== "auto") {
33
+ process.env["MONNIFY_RESPONSE_FORMAT"] = opts.format;
34
+ }
35
+ if (opts.httpToken) {
36
+ process.env["MONNIFY_HTTP_TOKEN"] = opts.httpToken;
37
+ }
38
+ await import("./index.js");
39
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,qCAAqC,CAAC;KAClD,OAAO,CAAC,OAAO,CAAC;KAChB,cAAc,CACb,gBAAgB,EAChB,wDAAwD,CACzD;KACA,cAAc,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC5D,cAAc,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;KAChE,MAAM,CACL,qBAAqB,EACrB,2CAA2C,EAC3C,SAAS,CACV;KACA,MAAM,CAAC,yBAAyB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KAC3E,MAAM,CACL,eAAe,EACf,6CAA6C,EAC7C,MAAM,CACP;KACA,MAAM,CACL,sBAAsB,EACtB,mGAAmG,CACpG;KACA,MAAM,CACL,mBAAmB,EACnB,4KAA4K,EAC5K,MAAM,CACP;KACA,MAAM,CACL,qBAAqB,EACrB,+IAA+I,CAChJ;KACA,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAUrB,CAAC;AAEL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAC7C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AACnD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;AACzD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;AACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC7B,IAAI,CAAC,GAAG,KAAK,YAAY;QACvB,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,6BAA6B,CAAC;AACpC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;AAEhC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AACvD,CAAC;AAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { type AxiosInstance } from "axios";
2
+ export declare const monnifyClient: AxiosInstance;
3
+ export declare function apiGet<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
4
+ export declare function apiPost<T>(path: string, body: unknown): Promise<T>;
5
+ export declare function apiPatch<T>(path: string, body?: unknown): Promise<T>;
6
+ export declare function apiDelete<T>(path: string): Promise<T>;
7
+ //# sourceMappingURL=monnifyClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"monnifyClient.d.ts","sourceRoot":"","sources":["../../src/client/monnifyClient.ts"],"names":[],"mappings":"AAAA,OAAc,EACZ,KAAK,aAAa,EAGnB,MAAM,OAAO,CAAC;AA8Hf,eAAO,MAAM,aAAa,eAAiB,CAAC;AAE5C,wBAAsB,MAAM,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAGxE;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAG1E;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG3D"}
@@ -0,0 +1,119 @@
1
+ import axios from "axios";
2
+ import { env } from "../config/env.js";
3
+ import { tokenManager } from "../auth/tokenManager.js";
4
+ import { logger } from "../utils/logger.js";
5
+ import { MonnifyApiError } from "../utils/errors.js";
6
+ const SENSITIVE_FIELDS = new Set([
7
+ "token",
8
+ "accessToken",
9
+ "secretKey",
10
+ "apiKey",
11
+ "bvn",
12
+ "accountNumber",
13
+ "authorizationCode",
14
+ "password",
15
+ ]);
16
+ function redactBody(body) {
17
+ if (!body || typeof body !== "object")
18
+ return body;
19
+ return Object.fromEntries(Object.entries(body).map(([k, v]) => [
20
+ k,
21
+ SENSITIVE_FIELDS.has(k) ? "[REDACTED]" : v,
22
+ ]));
23
+ }
24
+ function shouldRetry(error) {
25
+ return !error.response || error.response.status >= 500;
26
+ }
27
+ function createClient() {
28
+ const instance = axios.create({
29
+ timeout: 30_000,
30
+ headers: { "Content-Type": "application/json" },
31
+ });
32
+ instance.interceptors.request.use(async (config) => {
33
+ config.baseURL = env().MONNIFY_BASE_URL;
34
+ const token = await tokenManager.getToken();
35
+ config.headers["Authorization"] = `Bearer ${token}`;
36
+ const start = Date.now();
37
+ config._startTime = start;
38
+ logger.debug("Monnify request", {
39
+ method: config.method?.toUpperCase(),
40
+ url: config.url,
41
+ });
42
+ return config;
43
+ });
44
+ instance.interceptors.response.use((response) => {
45
+ const config = response.config;
46
+ const duration = config._startTime ? Date.now() - config._startTime : 0;
47
+ logger.info("Monnify response", {
48
+ method: response.config.method?.toUpperCase(),
49
+ url: response.config.url,
50
+ status: response.status,
51
+ duration,
52
+ });
53
+ return response;
54
+ }, async (error) => {
55
+ // Strip auth headers FIRST — before any logging or retry logic
56
+ if (error.config?.headers) {
57
+ delete error.config.headers["Authorization"];
58
+ delete error.config.headers["authorization"];
59
+ }
60
+ const retryCount = error.config?._retryCount ?? 0;
61
+ // Retry 5xx and network errors (max 3, exponential backoff)
62
+ if (retryCount < 3 && shouldRetry(error)) {
63
+ error.config._retryCount =
64
+ retryCount + 1;
65
+ const delay = 500 * Math.pow(2, retryCount);
66
+ logger.warn("Retrying Monnify request", {
67
+ url: error.config?.url,
68
+ attempt: retryCount + 1,
69
+ delay,
70
+ });
71
+ await new Promise((res) => setTimeout(res, delay));
72
+ return instance(error.config);
73
+ }
74
+ // On 401: clear token cache and retry once
75
+ if (error.response?.status === 401 && retryCount === 0) {
76
+ tokenManager.clearCache();
77
+ error.config._retryCount = 1;
78
+ logger.warn("Got 401 — clearing token cache and retrying once");
79
+ return instance(error.config);
80
+ }
81
+ const responseData = error.response?.data;
82
+ const httpStatus = error.response?.status ?? 0;
83
+ logger.error("Monnify API error", {
84
+ url: error.config?.url,
85
+ status: httpStatus,
86
+ responseCode: responseData?.["responseCode"],
87
+ responseMessage: responseData?.["responseMessage"],
88
+ });
89
+ throw new MonnifyApiError(responseData?.["responseCode"] ?? "UNKNOWN", responseData?.["responseMessage"] ?? error.message, httpStatus);
90
+ });
91
+ return instance;
92
+ }
93
+ export const monnifyClient = createClient();
94
+ export async function apiGet(path, params) {
95
+ const cleanParams = {};
96
+ if (params) {
97
+ for (const [k, v] of Object.entries(params)) {
98
+ if (v !== undefined)
99
+ cleanParams[k] = String(v);
100
+ }
101
+ }
102
+ const { data } = await monnifyClient.get(path, {
103
+ params: cleanParams,
104
+ });
105
+ return data.responseBody;
106
+ }
107
+ export async function apiPost(path, body) {
108
+ const { data } = await monnifyClient.post(path, body);
109
+ return data.responseBody;
110
+ }
111
+ export async function apiPatch(path, body) {
112
+ const { data } = await monnifyClient.patch(path, body);
113
+ return data.responseBody;
114
+ }
115
+ export async function apiDelete(path) {
116
+ const { data } = await monnifyClient.delete(path);
117
+ return data.responseBody;
118
+ }
119
+ //# sourceMappingURL=monnifyClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"monnifyClient.js","sourceRoot":"","sources":["../../src/client/monnifyClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAIN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,OAAO;IACP,aAAa;IACb,WAAW;IACX,QAAQ;IACR,KAAK;IACL,eAAe;IACf,mBAAmB;IACnB,UAAU;CACX,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,IAAa;IAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9D,CAAC;QACD,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;KAC3C,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAiB;IACpC,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;QAEpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,MAAgE,CAAC,UAAU,GAAG,KAAK,CAAC;QAErF,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE;YACpC,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAChC,CAAC,QAAQ,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,QAAQ,CAAC,MAEvB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE;YAC7C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG;YACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC,EACD,KAAK,EAAE,KAAiB,EAAE,EAAE;QAC1B,+DAA+D;QAC/D,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,UAAU,GACb,KAAK,CAAC,MAAsC,EAAE,WAAW,IAAI,CAAC,CAAC;QAElE,4DAA4D;QAC5D,IAAI,UAAU,GAAG,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,MAAsC,CAAC,WAAW;gBACvD,UAAU,GAAG,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBACtC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG;gBACtB,OAAO,EAAE,UAAU,GAAG,CAAC;gBACvB,KAAK;aACN,CAAC,CAAC;YACH,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YACnD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAO,CAAC,CAAC;QACjC,CAAC;QAED,2CAA2C;QAC3C,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACvD,YAAY,CAAC,UAAU,EAAE,CAAC;YACzB,KAAK,CAAC,MAAsC,CAAC,WAAW,GAAG,CAAC,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YAChE,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAO,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,IAExB,CAAC;QACd,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;YAChC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG;YACtB,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,YAAY,EAAE,CAAC,cAAc,CAAC;YAC5C,eAAe,EAAE,YAAY,EAAE,CAAC,iBAAiB,CAAC;SACnD,CAAC,CAAC;QAEH,MAAM,IAAI,eAAe,CACtB,YAAY,EAAE,CAAC,cAAc,CAAY,IAAI,SAAS,EACtD,YAAY,EAAE,CAAC,iBAAiB,CAAY,IAAI,KAAK,CAAC,OAAO,EAC9D,UAAU,CACX,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,MAA8D;IAE9D,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,SAAS;gBAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,CAAsB,IAAI,EAAE;QAClE,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;IACH,OAAQ,IAAuC,CAAC,YAAY,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,IAAY,EAAE,IAAa;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAsB,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3E,OAAQ,IAAuC,CAAC,YAAY,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY,EAAE,IAAc;IAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAsB,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,OAAQ,IAAuC,CAAC,YAAY,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,IAAY;IAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,CAAsB,IAAI,CAAC,CAAC;IACvE,OAAQ,IAAuC,CAAC,YAAY,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { z } from "zod";
2
+ declare const EnvSchema: z.ZodObject<{
3
+ MONNIFY_API_KEY: z.ZodString;
4
+ MONNIFY_SECRET_KEY: z.ZodString;
5
+ MONNIFY_CONTRACT_CODE: z.ZodString;
6
+ MONNIFY_BASE_URL: z.ZodDefault<z.ZodString>;
7
+ MONNIFY_ENV: z.ZodDefault<z.ZodEnum<["sandbox", "production"]>>;
8
+ TRANSPORT: z.ZodDefault<z.ZodEnum<["stdio", "http"]>>;
9
+ PORT: z.ZodDefault<z.ZodNumber>;
10
+ MONNIFY_ALLOWED_OPERATIONS: z.ZodOptional<z.ZodString>;
11
+ MONNIFY_HTTP_TOKEN: z.ZodOptional<z.ZodString>;
12
+ MONNIFY_RESPONSE_FORMAT: z.ZodDefault<z.ZodEnum<["auto", "markdown", "json"]>>;
13
+ NODE_ENV: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
14
+ LOG_LEVEL: z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug"]>>;
15
+ }, "strip", z.ZodTypeAny, {
16
+ MONNIFY_API_KEY: string;
17
+ MONNIFY_SECRET_KEY: string;
18
+ MONNIFY_CONTRACT_CODE: string;
19
+ MONNIFY_BASE_URL: string;
20
+ MONNIFY_ENV: "sandbox" | "production";
21
+ TRANSPORT: "stdio" | "http";
22
+ PORT: number;
23
+ MONNIFY_RESPONSE_FORMAT: "auto" | "markdown" | "json";
24
+ NODE_ENV: "production" | "development" | "test";
25
+ LOG_LEVEL: "error" | "warn" | "info" | "debug";
26
+ MONNIFY_ALLOWED_OPERATIONS?: string | undefined;
27
+ MONNIFY_HTTP_TOKEN?: string | undefined;
28
+ }, {
29
+ MONNIFY_API_KEY: string;
30
+ MONNIFY_SECRET_KEY: string;
31
+ MONNIFY_CONTRACT_CODE: string;
32
+ MONNIFY_BASE_URL?: string | undefined;
33
+ MONNIFY_ENV?: "sandbox" | "production" | undefined;
34
+ TRANSPORT?: "stdio" | "http" | undefined;
35
+ PORT?: number | undefined;
36
+ MONNIFY_ALLOWED_OPERATIONS?: string | undefined;
37
+ MONNIFY_HTTP_TOKEN?: string | undefined;
38
+ MONNIFY_RESPONSE_FORMAT?: "auto" | "markdown" | "json" | undefined;
39
+ NODE_ENV?: "production" | "development" | "test" | undefined;
40
+ LOG_LEVEL?: "error" | "warn" | "info" | "debug" | undefined;
41
+ }>;
42
+ export type Env = z.infer<typeof EnvSchema>;
43
+ export declare function validateEnv(): Env;
44
+ export declare const env: () => Env;
45
+ export declare const tryEnv: () => Env | undefined;
46
+ export {};
47
+ //# sourceMappingURL=env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeb,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAI5C,wBAAgB,WAAW,IAAI,GAAG,CAajC;AAED,eAAO,MAAM,GAAG,QAAO,GAItB,CAAC;AAEF,eAAO,MAAM,MAAM,QAAO,GAAG,GAAG,SAAiB,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { z } from "zod";
2
+ import dotenv from "dotenv";
3
+ dotenv.config();
4
+ const EnvSchema = z.object({
5
+ MONNIFY_API_KEY: z.string().min(1, "MONNIFY_API_KEY is required"),
6
+ MONNIFY_SECRET_KEY: z.string().min(1, "MONNIFY_SECRET_KEY is required"),
7
+ MONNIFY_CONTRACT_CODE: z.string().min(1, "MONNIFY_CONTRACT_CODE is required"),
8
+ MONNIFY_BASE_URL: z.string().url().default("https://sandbox.monnify.com"),
9
+ MONNIFY_ENV: z.enum(["sandbox", "production"]).default("sandbox"),
10
+ TRANSPORT: z.enum(["stdio", "http"]).default("stdio"),
11
+ PORT: z.coerce.number().int().min(1).max(65535).default(3000),
12
+ MONNIFY_ALLOWED_OPERATIONS: z.string().optional(),
13
+ MONNIFY_HTTP_TOKEN: z.string().optional(),
14
+ MONNIFY_RESPONSE_FORMAT: z.enum(["auto", "markdown", "json"]).default("auto"),
15
+ NODE_ENV: z
16
+ .enum(["development", "production", "test"])
17
+ .default("development"),
18
+ LOG_LEVEL: z.enum(["error", "warn", "info", "debug"]).default("info"),
19
+ });
20
+ let _env;
21
+ export function validateEnv() {
22
+ const result = EnvSchema.safeParse(process.env);
23
+ if (!result.success) {
24
+ const issues = result.error.issues
25
+ .map((i) => ` ${String(i.path[0])}: ${i.message}`)
26
+ .join("\n");
27
+ process.stderr.write(`\nMissing or invalid environment variables:\n${issues}\n\n`);
28
+ process.exit(1);
29
+ }
30
+ _env = result.data;
31
+ return _env;
32
+ }
33
+ export const env = () => {
34
+ if (!_env)
35
+ throw new Error("validateEnv() must be called before accessing env()");
36
+ return _env;
37
+ };
38
+ export const tryEnv = () => _env;
39
+ //# sourceMappingURL=env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IACjE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IACvE,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC7E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC;IACzE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7D,0BAA0B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,uBAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAC3C,OAAO,CAAC,aAAa,CAAC;IACzB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACtE,CAAC,CAAC;AAIH,IAAI,IAAqB,CAAC;AAE1B,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAClD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,MAAM,MAAM,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,GAAQ,EAAE;IAC3B,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,GAAoB,EAAE,CAAC,IAAI,CAAC"}
@@ -0,0 +1,36 @@
1
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
2
+ export declare const server: Server<{
3
+ method: string;
4
+ params?: {
5
+ [x: string]: unknown;
6
+ _meta?: {
7
+ [x: string]: unknown;
8
+ progressToken?: string | number | undefined;
9
+ "io.modelcontextprotocol/related-task"?: {
10
+ taskId: string;
11
+ } | undefined;
12
+ } | undefined;
13
+ } | undefined;
14
+ }, {
15
+ method: string;
16
+ params?: {
17
+ [x: string]: unknown;
18
+ _meta?: {
19
+ [x: string]: unknown;
20
+ progressToken?: string | number | undefined;
21
+ "io.modelcontextprotocol/related-task"?: {
22
+ taskId: string;
23
+ } | undefined;
24
+ } | undefined;
25
+ } | undefined;
26
+ }, {
27
+ [x: string]: unknown;
28
+ _meta?: {
29
+ [x: string]: unknown;
30
+ progressToken?: string | number | undefined;
31
+ "io.modelcontextprotocol/related-task"?: {
32
+ taskId: string;
33
+ } | undefined;
34
+ } | undefined;
35
+ }>;
36
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA2DnE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGlB,CAAC"}
package/build/index.js ADDED
@@ -0,0 +1,84 @@
1
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
2
+ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
3
+ import { validateEnv, env } from "./config/env.js";
4
+ import { getAllToolDefinitions, dispatchTool } from "./tools/registry.js";
5
+ import { assertEnvironmentConsistency, isOperationAllowed, } from "./security/guards.js";
6
+ import { logger } from "./utils/logger.js";
7
+ import { MonnifyApiError, ValidationError } from "./utils/errors.js";
8
+ import { errorResult } from "./types/mcp.js";
9
+ import { setClientName, setFormatOverride } from "./utils/clientContext.js";
10
+ validateEnv();
11
+ assertEnvironmentConsistency(env());
12
+ const formatEnv = env().MONNIFY_RESPONSE_FORMAT;
13
+ if (formatEnv !== "auto") {
14
+ setFormatOverride(formatEnv);
15
+ }
16
+ if (isOperationAllowed("utilities", env())) {
17
+ await import("./tools/utilities/getSupportedBanks.js");
18
+ }
19
+ if (isOperationAllowed("verification", env())) {
20
+ await import("./tools/verification/verifyBankAccount.js");
21
+ await import("./tools/verification/verifyBvn.js");
22
+ await import("./tools/verification/verifyBvnInfo.js");
23
+ await import("./tools/verification/verifyNin.js");
24
+ }
25
+ if (isOperationAllowed("collections", env())) {
26
+ await import("./tools/collections/initiatePayment.js");
27
+ await import("./tools/collections/reserveAccount.js");
28
+ await import("./tools/collections/getReservedAccount.js");
29
+ await import("./tools/collections/getReservedAccountTransactions.js");
30
+ await import("./tools/collections/deallocateReservedAccount.js");
31
+ await import("./tools/collections/getTransactionStatus.js");
32
+ await import("./tools/collections/getTransactionDetails.js");
33
+ await import("./tools/collections/getAllTransactions.js");
34
+ await import("./tools/collections/createInvoice.js");
35
+ await import("./tools/collections/processRefund.js");
36
+ await import("./tools/collections/payWithBankTransfer.js");
37
+ await import("./tools/collections/chargeCard.js");
38
+ await import("./tools/collections/chargeCardToken.js");
39
+ await import("./tools/collections/authoriseCardOtp.js");
40
+ await import("./tools/collections/authoriseCard3ds.js");
41
+ }
42
+ if (isOperationAllowed("directDebit", env())) {
43
+ await import("./tools/directDebit/createMandate.js");
44
+ await import("./tools/directDebit/getMandateStatus.js");
45
+ await import("./tools/directDebit/debitMandate.js");
46
+ await import("./tools/directDebit/getMandateDebitStatus.js");
47
+ await import("./tools/directDebit/cancelMandate.js");
48
+ }
49
+ export const server = new Server({ name: "monnify-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
50
+ server.oninitialized = () => {
51
+ const clientName = server.getClientVersion()?.name;
52
+ setClientName(clientName);
53
+ logger.info("MCP client connected", { client: clientName ?? "unknown" });
54
+ };
55
+ server.setRequestHandler(ListToolsRequestSchema, async () => ({
56
+ tools: getAllToolDefinitions(),
57
+ }));
58
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
59
+ const { name, arguments: args } = request.params;
60
+ try {
61
+ const result = await dispatchTool(name, args ?? {});
62
+ return { content: result.content, isError: result.isError };
63
+ }
64
+ catch (error) {
65
+ if (error instanceof MonnifyApiError) {
66
+ return { content: [error.toMcpContent()], isError: true };
67
+ }
68
+ if (error instanceof ValidationError) {
69
+ return { content: [error.toMcpContent()], isError: true };
70
+ }
71
+ logger.error("Unhandled tool error", { tool: name, error });
72
+ return errorResult(`Internal error in "${name}". Check server logs.`);
73
+ }
74
+ });
75
+ const transport = env().TRANSPORT;
76
+ if (transport === "http") {
77
+ const { startHttpTransport } = await import("./transport/http.js");
78
+ await startHttpTransport(server);
79
+ }
80
+ else {
81
+ const { startStdioTransport } = await import("./transport/stdio.js");
82
+ await startStdioTransport(server);
83
+ }
84
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { z } from "zod";
2
+ type AnyZodObject = z.ZodObject<z.ZodRawShape>;
3
+ export declare const InitiatePaymentBodySchema: AnyZodObject;
4
+ export declare const ReserveAccountBodySchema: AnyZodObject;
5
+ export declare const CreateInvoiceBodySchema: AnyZodObject;
6
+ export declare const ProcessRefundBodySchema: AnyZodObject;
7
+ export declare const ChargeCardBodySchema: AnyZodObject;
8
+ export declare const AuthoriseCardOtpBodySchema: AnyZodObject;
9
+ export declare const AuthoriseCard3dsBodySchema: AnyZodObject;
10
+ export declare const CreateMandateBodySchema: AnyZodObject;
11
+ export declare const DebitMandateBodySchema: AnyZodObject;
12
+ export declare const VerifyBvnBodySchema: AnyZodObject;
13
+ export declare const CancelMandateBodySchema: z.ZodObject<{
14
+ mandateReference: z.ZodString;
15
+ cancellationReason: z.ZodOptional<z.ZodString>;
16
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
17
+ mandateReference: z.ZodString;
18
+ cancellationReason: z.ZodOptional<z.ZodString>;
19
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
20
+ mandateReference: z.ZodString;
21
+ cancellationReason: z.ZodOptional<z.ZodString>;
22
+ }, z.ZodTypeAny, "passthrough">>;
23
+ export {};
24
+ //# sourceMappingURL=compat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/schemas/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,KAAK,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAI/C,eAAO,MAAM,yBAAyB,cAAqC,CAAC;AAC5E,eAAO,MAAM,wBAAwB,cAAqC,CAAC;AAC3E,eAAO,MAAM,uBAAuB,cAA6B,CAAC;AAClE,eAAO,MAAM,uBAAuB,cAA8B,CAAC;AACnE,eAAO,MAAM,oBAAoB,cAAsB,CAAC;AACxD,eAAO,MAAM,0BAA0B,cAA4B,CAAC;AACpE,eAAO,MAAM,0BAA0B,cAAgC,CAAC;AACxE,eAAO,MAAM,uBAAuB,cAA6B,CAAC;AAClE,eAAO,MAAM,sBAAsB,cAA4B,CAAC;AAChE,eAAO,MAAM,mBAAmB,cAA+B,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;gCAKpB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from "zod";
2
+ import { schemas as _s } from "./generated.js";
3
+ const s = _s;
4
+ export const InitiatePaymentBodySchema = s["InitializeTransactionRequest"];
5
+ export const ReserveAccountBodySchema = s["CreateReservedAccountRequest"];
6
+ export const CreateInvoiceBodySchema = s["CreateInvoiceRequest"];
7
+ export const ProcessRefundBodySchema = s["InitiateRefundRequest"];
8
+ export const ChargeCardBodySchema = s["ChargeRequest"];
9
+ export const AuthoriseCardOtpBodySchema = s["AuthorizeOTPRequest"];
10
+ export const AuthoriseCard3dsBodySchema = s["Authorize3DSCardRequest"];
11
+ export const CreateMandateBodySchema = s["CreateMandateRequest"];
12
+ export const DebitMandateBodySchema = s["DebitMandateRequest"];
13
+ export const VerifyBvnBodySchema = s["BVNVerificationRequest"];
14
+ export const CancelMandateBodySchema = z
15
+ .object({
16
+ mandateReference: z.string().min(1),
17
+ cancellationReason: z.string().optional(),
18
+ })
19
+ .passthrough();
20
+ //# sourceMappingURL=compat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/schemas/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,CAAC,GAAG,EAA6C,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,8BAA8B,CAAE,CAAC;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,8BAA8B,CAAE,CAAC;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,sBAAsB,CAAE,CAAC;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,uBAAuB,CAAE,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,eAAe,CAAE,CAAC;AACxD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,qBAAqB,CAAE,CAAC;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,yBAAyB,CAAE,CAAC;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,sBAAsB,CAAE,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,qBAAqB,CAAE,CAAC;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,wBAAwB,CAAE,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,WAAW,EAAE,CAAC"}