@airwallex/developer-mcp 0.3.0-beta.10

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Airwallex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,148 @@
+# @airwallex/developer-mcp
+
+The Airwallex Developer Model Context Protocol (MCP) server empowers AI coding agents with the tools they need to assist developers integrating with [Airwallex APIs](https://www.airwallex.com/docs/api#/Introduction). It enables agents to search Airwallex documentation and interact with the sandbox environment for testing and simulation.
+
+---
+
+## Installation
+
+<details>
+  <summary><strong>Cursor</strong></summary>
+
+[![Install Airwallex Developer MCP Server on Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=airwallex-dev&config=eyJlbnYiOnsiQUlSV0FMTEVYX1NBTkRCT1hfQ0xJRU5UX0lEIjoiIiwiQUlSV0FMTEVYX1NBTkRCT1hfQVBJX0tFWSI6IiJ9LCJjb21tYW5kIjoibnB4IC15IEBhaXJ3YWxsZXgvZGV2ZWxvcGVyLW1jcEBsYXRlc3QifQ%3D%3D)
+
+```json
+{
+  "mcpServers": {
+    "airwallex-dev": {
+      "command": "npx",
+      "args": ["-y", "@airwallex/developer-mcp@latest"],
+      "env": {
+        "AIRWALLEX_SANDBOX_CLIENT_ID": "",
+        "AIRWALLEX_SANDBOX_API_KEY": ""
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+  <summary><strong>Claude Code</strong></summary>
+
+```zsh
+claude mcp add-json airwallex-dev '{ "type": "stdio", "command":"npx", "args": ["-y", "@airwallex/developer-mcp@latest"], "env": { "AIRWALLEX_SANDBOX_CLIENT_ID": "", "AIRWALLEX_SANDBOX_API_KEY": "" } }'
+```
+
+</details>
+
+<details>
+  <summary><strong>Gemini CLI</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "airwallex-dev": {
+      "command": "npx",
+      "args": ["-y", "@airwallex/developer-mcp@latest"],
+      "env": {
+        "AIRWALLEX_SANDBOX_CLIENT_ID": "",
+        "AIRWALLEX_SANDBOX_API_KEY": ""
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+  <summary><strong>OpenAI Codex</strong></summary>
+
+```toml
+[mcp_servers.airwallex-dev]
+command = "npx"
+args = ["-y", "@airwallex/developer-mcp@latest"]
+
+[mcp_servers.airwallex-dev.env]
+AIRWALLEX_SANDBOX_CLIENT_ID = ""
+AIRWALLEX_SANDBOX_API_KEY = ""
+```
+
+</details>
+
+---
+
+## Example prompts
+
+_Integrate Airwallex's Drop-in element with this website_
+
+_Using Airwallex, can you find me test card numbers for the 3DS authentication failure case?_
+
+_I tried to make a payout with Airwallex and got this error: amount_below_transfer_method_limit. What does that mean?_
+
+### With sandbox tools
+
+_Can you create a new billing plan on Airwallex called Startup for $29.99/month and create a hosted URL to subscribe to it?_
+
+---
+
+## Environment variables
+
+To access sandbox tools, ensure that your sandbox API credentials are set using the following environment variables. If you don't already have a sandbox account, create one using [this link](https://demo.airwallex.com/signup/sandbox).
+
+| Name                          | Description                                                                                                                                                                                                                                                                                                                                  | Default | Required |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------- |
+| `AIRWALLEX_SANDBOX_API_KEY`   | The API key, either an admin key or a scoped key with limited permissions, generated in the sandbox environment.  Note that the sandbox tools work as expected only if the API key has the required permissions to access the underlying APIs.  Simulation APIs require an admin API key. | N/A     | No       |
+| `AIRWALLEX_SANDBOX_CLIENT_ID` | The client ID associated with the API key generated in the sandbox environment.                                                                                                                                                                                                                                                                 | N/A     | No       |
+| `DISABLE_TELEMETRY`           | Set this variable to `true` to opt out of telemetry.                                                                                                                                                                                                                                                                                                                         | `0`     | No       |
+
+---
+
+## Tools
+
+### Developer tools
+
+
+| Name               | Description                                                                                                                         |
+|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
+| `search_public_docs`    | Search the Airwallex documentation. Covers the following sources: [Product docs](https://www.airwallex.com/docs/), [API reference](https://www.airwallex.com/docs/api), [Airwallex.js](https://www.airwallex.com/docs/js/), Payments [iOS](https://github.com/airwallex/airwallex-payment-ios) and [Android](https://github.com/airwallex/airwallex-payment-android) SDKs                                                 |
+
+### Sandbox tools
+
+All data retrieved and actions performed with the tools below are in the authenticated Sandbox account.
+
+| Name               | Description                                                                                                                         |
+|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
+| `list_global_accounts`    | List all available global accounts |
+| `get_balances` | List balances in all currencies |
+| `simulate_create_deposit` | Simulate a deposit to an available global account | 
+| `list_billing_products` | List available billing products  |
+| `list_billing_prices` | List available billing prices |
+| `create_billing_product` | Create a new billing product |
+| `create_billing_price` | Create a new billing price |
+| `create_billing_checkout` | Create a new hosted billing checkout page |
+| `get_fx_quote` | Get a quote for a FX conversion |
+| `list_transfers` | List transfers initiated |
+| `create_transfer` | Initiate a new transfer to a recipient |
+| `list_beneficiaries` | List available transfer recipients |
+| `simulate_transfer_result` | Simulate the status of a transfer |
+| `create_payment_link` | Create a new payment link |
+| `list_payment_links` | List created payment links |   
+
+
+
+---
+
+## Disclaimer
+
+This MCP server can help minimize hallucinations in Airwallex-related integration code produced by your coding agent but does not eliminate hallucinations entirely. Please always review, validate, and thoroughly test any AI-generated code before deploying it to production.
+
+## Feedback
+
+This MCP server is developed and maintained by the Airwallex Developer Experience team. We welcome your feedback — please contact us at [`developer.support@airwallex.com`](mailto:developer.support@airwallex.com). Remember to mention the AI model your coding agent was connected to.
+
+## Telemetry
+
+Telemetry is enabled by default. To disable telemetry, set the `DISABLE_TELEMETRY` environment variable to `true`. Only anonymous data about MCP tool usage is collected.

package/dist/constants/config.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_URLS = void 0;
+exports.BASE_URLS = {
+    api: "https://api-demo.airwallex.com",
+    docsSearch: "https://demo.airwallex.com/docs/ai",
+    telemetry: "https://o11y-demo.airwallex.com",
+};

package/dist/constants/descriptions.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTIONS = void 0;
+exports.TOOL_DESCRIPTIONS = {
+    CREATE_BILLING_CHECKOUT: `Create a billing checkout session for a single price in the authenticated Sandbox account.
+    
+This tool creates a billing checkout session and returns a hosted checkout URL that can be shared.
+
+EXAMPLES:
+• One-time payment: mode=PAYMENT, price_id=pri_xxx
+• Monthly subscription: mode=SUBSCRIPTION, price_id=pri_xxx`,
+    CREATE_BILLING_PRICE: `Create a new price for a billing product in the authenticated Sandbox account.
+
+EXAMPLES:
+• Ecommerce product: type=ONE_OFF, pricing_model=PER_UNIT
+• Monthly subscription: type=RECURRING, pricing_model=FLAT, recurring_period=1, recurring_period_unit=MONTH
+• Bi-weekly: type=RECURRING, recurring_period=2, recurring_period_unit=WEEK
+• Yearly: type=RECURRING, recurring_period=1, recurring_period_unit=YEAR`,
+    CREATE_BILLING_PRODUCT: `Create a new billing product in the authenticated Sandbox account.`,
+    CREATE_PAYMENT_LINK: `Create a payment link in the authenticated Sandbox account and optionally send it via email to a shopper.`,
+    CREATE_TRANSFER: `Create a new transfer to an existing beneficiary in the authenticated Sandbox account.
+  
+  Either transfer_amount OR source_amount must be provided, but not both.`,
+    GET_ACCOUNT_BALANCES: `Retrieve balances for all currencies in the authenticated Sandbox account.
+
+PRESENTATION REQUIREMENT: When presenting the results to the user, you MUST format the balance data as a clear table showing each currency with its corresponding balance amounts. Create a table with columns for Currency, Available, Pending, Reserved, Total, and Prepayment amounts.
+
+RESPONSE: Amounts returned are NOT in minor units.`,
+    GET_FX_QUOTE: `Get a foreign exchange quote for a currency conversion in the authenticated Sandbox account.`,
+    LIST_BENEFICIARIES: `List all beneficiaries in the authenticated Sandbox account.`,
+    LIST_BILLING_PRICES: `List billing prices in the authenticated Sandbox account.`,
+    LIST_BILLING_PRODUCTS: `List all billing products in the authenticated Sandbox account.`,
+    LIST_GLOBAL_ACCOUNTS: `List all global accounts in the authenticated Sandbox account.`,
+    LIST_PAYMENT_LINKS: `List all payment links in the authenticated Sandbox account.
+
+This tool retrieves a list of all payment links created by the merchant.`,
+    LIST_TRANSFERS: `List all transfers in the authenticated Sandbox account.`,
+    READ_BEST_PRACTICES: `CODE GENERATION ONLY: This tool MUST be called before any other Airwallex tools, but ONLY when the user intent is to generate code. For documentation searches, general questions, or non-code-related tasks, skip this tool and proceed directly with the appropriate tools for the task at hand.
+
+SINGLE USE PER CONVERSATION: You MUST call this tool only ONCE per conversation. The best practices content is static and doesn't need to be re-read multiple times.
+
+This tool reads the Airwallex integration best practices documentation that contains essential guidelines for API usage, payment handling, SDK implementation, and common pitfalls to avoid.`,
+    RETRIEVE_DOCS: `Retrieve relevant sections from the official Airwallex documentation matching the user's question.
+  
+USAGE STRATEGY:
+  DO: Prefer to start with a broad search without specifying any source and then narrow down the search with a specific source when needed
+  DO: For relevant API endpoints or SDK methods in the sections returned, invoke this tool again with the specific source to get more detailed information
+  DO: For API endpoints referenced, always remember to explicitly check how to perform API authentication
+  DO: For SDK methods referenced, always remember to explicitly check how to initialize the SDK
+
+PRIVACY & SECURITY REQUIREMENTS:
+• DON'T: Include PII (Personally Identifiable Information) in questions
+• DON'T: Include account IDs, user IDs, email addresses, or customer data
+• DON'T: Include API keys, tokens, or credentials
+• DON'T: Include transaction IDs, payment references, or financial data
+• DO: Use generic examples like 'how to process payments' instead of specific account details
+• DO: Focus on technical concepts, API endpoints, and implementation patterns
+• DO: API version information is permitted as an exception (e.g., '2023-09-30')`,
+    SIMULATE_DEPOSIT: `Simulate a deposit to a global account in the authenticated Sandbox account.
+
+This tool simulates deposits into your global account for testing payment flows and account balance management.`,
+    SIMULATE_TRANSFER_UPDATE: `Simulate a transfer status update in the authenticated Sandbox account.
+
+TRANSFER STATUS LIFECYCLE:
+To simulate a successful transfer completion, progress through these states in order:
+1. SENT (transfer sent to beneficiary's bank)
+3. PAID (transfer successfully completed - final status)`,
+    VALIDATE_REQUEST_SCHEMA: `Validate generated code that makes API requests to the Airwallex API.
+Validates generated code that involves making API requests to Airwallex API for correctness and quality. 
+  **REQUIRED WORKFLOW**: When you generate any code that involves Airwallex APIs for the user, you MUST: 
+  (1) Generate the code, 
+  (2) Immediately call this validation tool, 
+  (3) Review validation results, 
+  (4) Fix any issues found, 
+  (5) Validate again if changes were made, 
+  (6) Only present code to user after passing validation. 
+  Never skip validation - it ensures that users are protected from broken or unsafe code.
+* This tool does NOT execute the API request or return live data. It ONLY checks if the request made (as a result of running the generated code) is valid according to the schema.
+* If the request requires input, use sensible example values that match the data type used in the code. 
+* If the code uses variables, use placeholder values that match the expected format. 
+* If the request body is dynamically generated, perform a validation for each type of variation
+* DO NOT use real or sensitive data.
+* if AIRWALLEX_API_VERSION is not set, use "latest" as the default version. 
+ 
+This tool validates the request body, headers, query parameters, HTTP method, and route against the Airwallex API schema for the specified version. It helps ensure that requests are correctly formed before sending them to the Airwallex API.`,
+};

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const fs = __importStar(require("fs"));
+const path_1 = __importDefault(require("path"));
+const server_1 = require("./server");
+const version_1 = require("./utils/version");
+(async () => {
+    const appVersion = (0, version_1.getVersion)(__dirname);
+    const bestPracticesPath = path_1.default.join(__dirname, "integration-best-practices.md");
+    const integrationBestPracticesContent = fs.readFileSync(bestPracticesPath, "utf-8");
+    const server = (0, server_1.buildServer)({
+        appVersion,
+        integrationBestPracticesContent: integrationBestPracticesContent,
+    });
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+})();

package/dist/integration-best-practices.md

@@ -0,0 +1,15 @@
+# Airwallex Integration Best Practices
+
+## General
+
+- Check how to authenticate with the API and obtain a bearer token for API authorization using the `search_public_docs` MCP tool with a suitable `source` parameter. DO NOT hallucinate or assume.
+- Check how to initialise the Airwallex.js SDK using the `search_public_docs` MCP tool with a suitable `source` parameter. DO NOT hallucinate or assume.
+- Unless requested explicitly by the user, always use the most recent version of the API
+
+## Payments
+
+- In the Airwallex APIs & SDKs, request fields related to money are NOT represented in minor units by default unless explicitly specified
+- For the Javascript browser library, if the user prefers a direct integration with a CDN, use `https://static.airwallex.com/components/sdk/v1/index.js` and NOT `https://checkout.airwallex.com/assets/elements.bundle.min.js` unless explicitly requested by the user. The latter is a legacy library that is considered deprecated. When the user explicitly asks for it, advise them to consider migrating.
+- For the Javascript browser library, if the user prefers to use a package from the `npm` registry with `npm`, `yarn` or the `pnpm` CLI tools, use `@airwallex/components-sdk` instead of `airwallex-payment-elements` unless explicitly requested by the user. The latter is a legacy package that is considered deprecated. When the user explicitly asks for it, advise them to consider migrating.
+- For a robust and complete payments integration, always consider supporting setting up webhooks.
+- If the payment integration involves redirect-style payment methods, remember to configure a return URL in your payment intent and set up a URL handler on the server for the same. In the URL handler, retrieve the payment intent and check its status. If the status is non-terminal, repeat until a terminal status is observed and decide what to do next based on that. For Drop-in element integrations, you can consider doing this by default since multiple payment methods can be accepted through that integration.

package/dist/server.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildServer = void 0;
+const node_sdk_1 = require("@airwallex/node-sdk");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const config_1 = require("./constants/config");
+const AirTrackerClient_1 = require("./services/AirTrackerClient");
+const createBillingPrice_1 = require("./tools/createBillingPrice");
+const createPaymentLink_1 = require("./tools/createPaymentLink");
+const createTransfer_1 = require("./tools/createTransfer");
+const getFxQuote_1 = require("./tools/getFxQuote");
+const index_1 = require("./tools/index");
+const listBeneficiaries_1 = require("./tools/listBeneficiaries");
+const listPaymentLinks_1 = require("./tools/listPaymentLinks");
+const listTransfers_1 = require("./tools/listTransfers");
+const simulateTransferResult_1 = require("./tools/simulateTransferResult");
+const withTelemetry_1 = require("./utils/withTelemetry");
+const awxEnv = "demo";
+const disableTelemetry = process.env.DISABLE_TELEMETRY === "true" ||
+    process.env.DISABLE_TELEMETRY === "1";
+const buildServer = ({ appVersion, integrationBestPracticesContent, }) => {
+    const server = new mcp_js_1.McpServer({
+        name: "Airwallex",
+        version: appVersion,
+    });
+    const airTrackerClient = new AirTrackerClient_1.AirTrackerClient(config_1.BASE_URLS.telemetry, awxEnv, appVersion);
+    server.registerTool(index_1.retrieveDocsToolConfig.name, index_1.retrieveDocsToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.retrieveDocsToolConfig.name, async (args) => (0, index_1.executeRetrieveDocs)(args, appVersion), { disableTelemetry, telemetryClient: airTrackerClient }));
+    server.registerTool(index_1.readBestPracticesToolConfig.name, index_1.readBestPracticesToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.readBestPracticesToolConfig.name, async () => (0, index_1.executeReadBestPractices)(integrationBestPracticesContent), { disableTelemetry, telemetryClient: airTrackerClient }));
+    if (process.env.AIRWALLEX_SANDBOX_CLIENT_ID &&
+        process.env.AIRWALLEX_SANDBOX_API_KEY) {
+        const airwallex = new node_sdk_1.Airwallex({
+            apiKey: process.env.AIRWALLEX_SANDBOX_API_KEY,
+            clientId: process.env.AIRWALLEX_SANDBOX_CLIENT_ID,
+            env: "demo",
+        });
+        server.registerTool(index_1.listGlobalAccountsToolConfig.name, index_1.listGlobalAccountsToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.listGlobalAccountsToolConfig.name, async () => (0, index_1.executeListGlobalAccounts)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.getAccountBalancesToolConfig.name, index_1.getAccountBalancesToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.getAccountBalancesToolConfig.name, async () => (0, index_1.executeGetAccountBalances)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.simulateDepositToolConfig.name, index_1.simulateDepositToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.simulateDepositToolConfig.name, async (args) => (0, index_1.executeSimulateDeposit)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.listBillingProductsToolConfig.name, index_1.listBillingProductsToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.listBillingProductsToolConfig.name, async () => (0, index_1.executeListBillingProducts)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.listBillingPricesToolConfig.name, index_1.listBillingPricesToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.listBillingPricesToolConfig.name, async (args) => (0, index_1.executeListBillingPrices)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.createBillingProductToolConfig.name, index_1.createBillingProductToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.createBillingProductToolConfig.name, async (args) => (0, index_1.executeCreateBillingProduct)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(createBillingPrice_1.createBillingPriceToolConfig.name, createBillingPrice_1.createBillingPriceToolConfig, (0, withTelemetry_1.withToolTelemetry)(createBillingPrice_1.createBillingPriceToolConfig.name, async (args) => (0, createBillingPrice_1.executeCreateBillingPrice)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(index_1.createBillingCheckoutToolConfig.name, index_1.createBillingCheckoutToolConfig, (0, withTelemetry_1.withToolTelemetry)(index_1.createBillingCheckoutToolConfig.name, async (args) => (0, index_1.executeCreateBillingCheckout)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(getFxQuote_1.getFxQuoteToolConfig.name, getFxQuote_1.getFxQuoteToolConfig, (0, withTelemetry_1.withToolTelemetry)(getFxQuote_1.getFxQuoteToolConfig.name, async (args) => (0, getFxQuote_1.executeGetFxQuote)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(listTransfers_1.listTransfersToolConfig.name, listTransfers_1.listTransfersToolConfig, (0, withTelemetry_1.withToolTelemetry)(listTransfers_1.listTransfersToolConfig.name, async () => (0, listTransfers_1.executeListTransfers)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(createTransfer_1.createTransferToolConfig.name, createTransfer_1.createTransferToolConfig, (0, withTelemetry_1.withToolTelemetry)(createTransfer_1.createTransferToolConfig.name, async (args) => (0, createTransfer_1.executeCreateTransfer)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(listBeneficiaries_1.listBeneficiariesToolConfig.name, listBeneficiaries_1.listBeneficiariesToolConfig, (0, withTelemetry_1.withToolTelemetry)(listBeneficiaries_1.listBeneficiariesToolConfig.name, async () => (0, listBeneficiaries_1.executeListBeneficiaries)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(simulateTransferResult_1.simulateTransferUpdateToolConfig.name, simulateTransferResult_1.simulateTransferUpdateToolConfig, (0, withTelemetry_1.withToolTelemetry)(simulateTransferResult_1.simulateTransferUpdateToolConfig.name, async (args) => (0, simulateTransferResult_1.executeSimulateTransferUpdate)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(createPaymentLink_1.createPaymentLinkToolConfig.name, createPaymentLink_1.createPaymentLinkToolConfig, (0, withTelemetry_1.withToolTelemetry)(createPaymentLink_1.createPaymentLinkToolConfig.name, async (args) => (0, createPaymentLink_1.executeCreatePaymentLink)(airwallex, args), { disableTelemetry, telemetryClient: airTrackerClient }));
+        server.registerTool(listPaymentLinks_1.listPaymentLinksToolConfig.name, listPaymentLinks_1.listPaymentLinksToolConfig, (0, withTelemetry_1.withToolTelemetry)(listPaymentLinks_1.listPaymentLinksToolConfig.name, async () => (0, listPaymentLinks_1.executeListPaymentLinks)(airwallex), { disableTelemetry, telemetryClient: airTrackerClient }));
+    }
+    return server;
+};
+exports.buildServer = buildServer;

package/dist/services/AirTrackerClient.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirTrackerClient = void 0;
+const os_1 = __importDefault(require("os"));
+const uuid_1 = require("uuid");
+const device_1 = require("../utils/device");
+const DEFAULT_COMMON_DATA = {
+    accountId: "unknown",
+    apiVersion: "0.0.0",
+    appName: "awx-dev-mcp-server-local",
+    appVersion: "0.0.0",
+    deviceId: (0, device_1.extractDeviceId)(),
+    env: "unknown",
+    networkType: "unknown",
+    platform: os_1.default.platform(),
+    sessionId: (0, uuid_1.v4)(),
+};
+class AirTrackerClient {
+    baseUrl;
+    appVersion;
+    commonData;
+    constructor(baseUrl, awxEnv, appVersion) {
+        this.baseUrl = baseUrl;
+        this.appVersion = appVersion;
+        this.commonData = {
+            ...DEFAULT_COMMON_DATA,
+            appVersion: this.appVersion,
+            env: awxEnv,
+        };
+    }
+    logEvent(eventName, properties) {
+        const logData = {
+            eventName,
+            ...properties,
+        };
+        fetch(`${this.baseUrl}/airtracker/logs`, {
+            body: JSON.stringify({
+                commonData: this.commonData,
+                data: [{ ...logData, severity: "info" }],
+            }),
+            headers: {
+                "Content-Type": "application/json",
+                "User-Agent": "",
+            },
+            method: "POST",
+            signal: AbortSignal.timeout(2000),
+        })
+            .then(async (response) => {
+            if (!response.ok) {
+                console.error(`HTTP error! status: ${response.status}, ${await response.text()}`);
+            }
+        })
+            .catch((error) => {
+            console.error(`Error logging event ${eventName}:`, error.message);
+        });
+    }
+}
+exports.AirTrackerClient = AirTrackerClient;

package/dist/tools/createBillingCheckout.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBillingCheckoutToolConfig = exports.createBillingCheckoutSchema = void 0;
+exports.executeCreateBillingCheckout = executeCreateBillingCheckout;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+const descriptions_1 = require("../constants/descriptions");
+exports.createBillingCheckoutSchema = zod_1.z.object({
+    mode: zod_1.z.enum(["PAYMENT", "SUBSCRIPTION"], {
+        errorMap: () => ({
+            message: "Mode must be either PAYMENT or SUBSCRIPTION",
+        }),
+    }),
+    price_id: zod_1.z.string().min(1, "Price ID is required"),
+    quantity: zod_1.z
+        .number()
+        .int()
+        .positive("Quantity must be a positive integer")
+        .default(1),
+    success_url: zod_1.z
+        .string()
+        .url("Success URL must be a valid URL")
+        .default("https://demo.airwallex.com")
+        .optional(),
+});
+async function executeCreateBillingCheckout(airwallex, args) {
+    try {
+        const requestId = (0, uuid_1.v4)();
+        const requestBody = {
+            line_items: [
+                {
+                    price_id: args.price_id,
+                    quantity: args.quantity,
+                },
+            ],
+            mode: args.mode,
+            request_id: requestId,
+            success_url: args.success_url,
+        };
+        if (args.mode === "SUBSCRIPTION") {
+            requestBody.subscription_data = {};
+        }
+        else if (args.mode === "PAYMENT") {
+            requestBody.invoice_data = {};
+        }
+        const response = (await airwallex.post("/api/v1/billing_checkouts/create", requestBody));
+        return {
+            content: [
+                {
+                    text: JSON.stringify(response, null, 2),
+                    type: "text",
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const statusCode = error?.status || error?.statusCode || 500;
+        const errorMessage = error?.message || "Unknown error occurred";
+        throw new Error(`Failed to create billing checkout (${statusCode}): ${errorMessage}`);
+    }
+}
+exports.createBillingCheckoutToolConfig = {
+    annotations: {
+        openWorldHint: true,
+        readOnlyHint: false,
+        title: "Create billing checkout",
+    },
+    description: descriptions_1.TOOL_DESCRIPTIONS.CREATE_BILLING_CHECKOUT,
+    inputSchema: exports.createBillingCheckoutSchema,
+    name: "create_billing_checkout",
+};

package/dist/tools/createBillingPrice.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBillingPriceToolConfig = exports.createBillingPriceSchema = void 0;
+exports.executeCreateBillingPrice = executeCreateBillingPrice;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+const descriptions_1 = require("../constants/descriptions");
+exports.createBillingPriceSchema = zod_1.z
+    .object({
+    amount: zod_1.z.number().positive("Amount must be positive"),
+    currency: zod_1.z
+        .string()
+        .length(3, "Currency must be a 3-letter ISO-4217 code")
+        .toUpperCase(),
+    pricing_model: zod_1.z
+        .enum(["FLAT", "PER_UNIT"], {
+        errorMap: () => ({
+            message: "Pricing model must be either FLAT or PER_UNIT",
+        }),
+    })
+        .describe("PER_UNIT multiplies by quantity, FLAT does not. Prefer PER_UNIT for ONE_OFF and FLAT for RECURRING."),
+    product_id: zod_1.z.string().min(1, "Product ID is required"),
+    recurring_period: zod_1.z
+        .number()
+        .int()
+        .positive("Recurring period must be a positive integer")
+        .optional(),
+    recurring_period_unit: zod_1.z
+        .enum(["DAY", "WEEK", "MONTH", "YEAR"], {
+        errorMap: () => ({
+            message: "Recurring period unit must be one of: DAY, WEEK, MONTH, YEAR",
+        }),
+    })
+        .optional(),
+    type: zod_1.z.enum(["ONE_OFF", "RECURRING"], {
+        errorMap: () => ({ message: "Type must be either ONE_OFF or RECURRING" }),
+    }),
+})
+    .refine((data) => {
+    if (data.type === "RECURRING") {
+        return (data.recurring_period !== undefined &&
+            data.recurring_period_unit !== undefined);
+    }
+    return true;
+}, {
+    message: "recurring_period and recurring_period_unit are required when type is RECURRING",
+    path: ["recurring_period"],
+})
+    .refine((data) => {
+    if (data.type === "ONE_OFF") {
+        return (data.recurring_period === undefined &&
+            data.recurring_period_unit === undefined);
+    }
+    return true;
+}, {
+    message: "recurring_period and recurring_period_unit must not be provided when type is ONE_OFF",
+    path: ["recurring_period"],
+});
+async function executeCreateBillingPrice(airwallex, args) {
+    try {
+        const requestId = (0, uuid_1.v4)();
+        const requestBody = {
+            currency: args.currency,
+            pricing_model: args.pricing_model,
+            product_id: args.product_id,
+            request_id: requestId,
+            type: args.type,
+        };
+        if (args.pricing_model === "FLAT") {
+            requestBody.flat_amount = args.amount;
+        }
+        else {
+            requestBody.unit_amount = args.amount;
+        }
+        if (args.type === "RECURRING") {
+            requestBody.recurring = {
+                period: args.recurring_period,
+                period_unit: args.recurring_period_unit,
+            };
+        }
+        const response = (await airwallex.post("/api/v1/prices/create", requestBody));
+        return {
+            content: [
+                {
+                    text: JSON.stringify(response, null, 2),
+                    type: "text",
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const statusCode = error?.status || error?.statusCode || 500;
+        const errorMessage = error?.message || "Unknown error occurred";
+        throw new Error(`Failed to create billing price (${statusCode}): ${errorMessage}`);
+    }
+}
+exports.createBillingPriceToolConfig = {
+    annotations: {
+        openWorldHint: true,
+        readOnlyHint: false,
+        title: "Create billing price",
+    },
+    description: descriptions_1.TOOL_DESCRIPTIONS.CREATE_BILLING_PRICE,
+    inputSchema: exports.createBillingPriceSchema,
+    name: "create_billing_price",
+};