mobile-device-mcp 0.2.1 → 0.2.2

package/LICENSE

@@ -0,0 +1,83 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Saransh Bamania
+Licensed Work:        mobile-device-mcp v0.2.1
+                      The Licensed Work is (c) 2026 Saransh Bamania.
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided your use does not include offering the
+                      Licensed Work to third parties as a commercial
+                      product or service, or using it as part of a
+                      paid device testing or automation platform.
+                      Individual and non-commercial use is always permitted.
+Change Date:          2030-03-23
+Change License:       Apache License, Version 2.0
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided under this License:
+
+1. To specify as the Change License the Apache License, Version 2.0, which
+   is a license compatible with GPL Version 2.0 or later.
+
+2. To specify as the Additional Use Grant the text set forth above.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/dist/license.d.ts

@@ -0,0 +1,25 @@
+export type LicenseTier = "free" | "pro";
+export interface LicenseInfo {
+    tier: LicenseTier;
+    valid: boolean;
+}
+/** Tools included in the free tier */
+export declare const FREE_TOOLS: Set<string>;
+/** Upgrade message shown when a free user calls a pro tool */
+export declare const PRO_UPGRADE_MESSAGE: {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+/**
+ * Validate the license key.
+ *
+ * Current implementation: presence check.
+ * Future: integrate with Keygen.sh or xPay for real validation.
+ */
+export declare function validateLicense(): LicenseInfo;
+/** Log the license tier on startup */
+export declare function logLicenseStatus(info: LicenseInfo): void;
+//# sourceMappingURL=license.d.ts.map

package/dist/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,sCAAsC;AACtC,eAAO,MAAM,UAAU,aAoBrB,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB;;;;;;CAe/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAU7C;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAMxD"}

package/dist/license.js

@@ -0,0 +1,68 @@
+// ============================================================
+// License key validation and tier management
+// ============================================================
+const PREFIX = "[mobile-device-mcp]";
+/** Tools included in the free tier */
+export const FREE_TOOLS = new Set([
+    // Device info (3)
+    "list_devices",
+    "get_device_info",
+    "get_screen_size",
+    // Screenshots & UI tree (2)
+    "take_screenshot",
+    "get_ui_elements",
+    // Basic interaction (6)
+    "tap",
+    "double_tap",
+    "long_press",
+    "swipe",
+    "type_text",
+    "press_key",
+    // Basic app management (2)
+    "list_apps",
+    "get_current_app",
+    // Logs (1)
+    "get_logs",
+]);
+/** Upgrade message shown when a free user calls a pro tool */
+export const PRO_UPGRADE_MESSAGE = {
+    content: [
+        {
+            type: "text",
+            text: [
+                "This is a Pro feature. Upgrade to unlock all 49 tools including AI vision, Flutter inspection, test generation, and more.",
+                "",
+                "Get your license key at: https://github.com/saranshbamania/mobile-device-mcp#pro",
+                "",
+                "Then add to your .mcp.json:",
+                '  "MOBILE_MCP_LICENSE_KEY": "your-key-here"',
+            ].join("\n"),
+        },
+    ],
+    isError: true,
+};
+/**
+ * Validate the license key.
+ *
+ * Current implementation: presence check.
+ * Future: integrate with Keygen.sh or xPay for real validation.
+ */
+export function validateLicense() {
+    const key = process.env.MOBILE_MCP_LICENSE_KEY;
+    if (!key || key.trim() === "") {
+        return { tier: "free", valid: true };
+    }
+    // TODO: Replace with Keygen.sh API validation when payment is set up
+    // For now, any non-empty key is treated as valid pro license
+    return { tier: "pro", valid: true };
+}
+/** Log the license tier on startup */
+export function logLicenseStatus(info) {
+    if (info.tier === "pro") {
+        process.stderr.write(`${PREFIX} License: Pro (all 49 tools enabled)\n`);
+    }
+    else {
+        process.stderr.write(`${PREFIX} License: Free (14 tools — upgrade to Pro for all 49)\n`);
+    }
+}
+//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6CAA6C;AAC7C,+DAA+D;AAE/D,MAAM,MAAM,GAAG,qBAAqB,CAAC;AASrC,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,4BAA4B;IAC5B,iBAAiB;IACjB,iBAAiB;IACjB,wBAAwB;IACxB,KAAK;IACL,YAAY;IACZ,YAAY;IACZ,OAAO;IACP,WAAW;IACX,WAAW;IACX,2BAA2B;IAC3B,WAAW;IACX,iBAAiB;IACjB,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE;QACP;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE;gBACJ,2HAA2H;gBAC3H,EAAE;gBACF,kFAAkF;gBAClF,EAAE;gBACF,6BAA6B;gBAC7B,6CAA6C;aAC9C,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;KACF;IACD,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAE/C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,qEAAqE;IACrE,6DAA6D;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,wCAAwC,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,yDAAyD,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY/C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAoCA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAwCA"}

package/dist/server.js

@@ -10,8 +10,9 @@ import { registerAllTools } from "./tools/index.js";
 import { AIClient } from "./ai/client.js";
 import { ScreenAnalyzer } from "./ai/analyzer.js";
 import { ActionRecorder } from "./recording/recorder.js";
+import { validateLicense, logLicenseStatus } from "./license.js";
 /** Server version — matches package.json */
-const SERVER_VERSION = "0.1.0";
+const SERVER_VERSION = "0.2.1";
 /**
  * Create a configured MCP server ready to start.
  *
@@ -41,7 +42,10 @@ export function createServer(config) {
         }, flutterDriver);
     }
     const recorder = new ActionRecorder();
-    registerAllTools(server, () => driver, () => analyzer, () => flutterDriver, () => driver, () => recorder, () => iosDriver);
+    // Validate license and gate pro tools
+    const license = validateLicense();
+    logLicenseStatus(license);
+    registerAllTools(server, () => driver, () => analyzer, () => flutterDriver, () => driver, () => recorder, () => iosDriver, license);
     async function start() {
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uDAAuD;AACvD,+DAA+D;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAI/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAExD,qCAAqC;IACrC,IAAI,SAAS,GAA8B,IAAI,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACvC,CAAC;IAED,mCAAmC;IACnC,IAAI,QAAQ,GAA0B,IAAI,CAAC;IAC3C,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,QAAQ,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE;YACzD,MAAM,EAAE,MAAM,CAAC,gBAAgB;YAC/B,OAAO,EAAE,MAAM,CAAC,iBAAiB;YACjC,QAAQ,EAAE,MAAM,CAAC,kBAAkB;SACpC,EAAE,aAAa,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAEtC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAE3H,KAAK,UAAU,KAAK;QAClB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uDAAuD;AACvD,+DAA+D;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,4CAA4C;AAC5C,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAI/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAExD,qCAAqC;IACrC,IAAI,SAAS,GAA8B,IAAI,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACvC,CAAC;IAED,mCAAmC;IACnC,IAAI,QAAQ,GAA0B,IAAI,CAAC;IAC3C,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,QAAQ,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE;YACzD,MAAM,EAAE,MAAM,CAAC,gBAAgB;YAC/B,OAAO,EAAE,MAAM,CAAC,iBAAiB;YACjC,QAAQ,EAAE,MAAM,CAAC,kBAAkB;SACpC,EAAE,aAAa,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAEtC,sCAAsC;IACtC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE1B,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEpI,KAAK,UAAU,KAAK;QAClB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/tools/index.d.ts

@@ -14,6 +14,7 @@ import type { ScreenAnalyzer } from "../ai/analyzer.js";
 import type { FlutterDriver } from "../drivers/flutter/index.js";
 import type { ActionRecorder } from "../recording/recorder.js";
 import type { IOSSimulatorDriver } from "../drivers/ios/index.js";
+import type { LicenseInfo } from "../license.js";
 export { registerDeviceTools, registerScreenTools, registerInteractionTools, registerAppTools, registerLogTools, registerFlutterTools, registerVideoTools, registerRecordingTools, registerIOSTools, };
 /**
  * Register every MCP tool with the server.
@@ -26,5 +27,5 @@ export { registerDeviceTools, registerScreenTools, registerInteractionTools, reg
  *                      if AI features are disabled.
  * @param getFlutter  — A factory/getter that returns the FlutterDriver.
  */
-export declare function registerAllTools(server: McpServer, getDriver: () => DeviceDriver, getAnalyzer: () => ScreenAnalyzer | null, getFlutter: () => FlutterDriver, getAndroidDriver?: () => AndroidDriver, getRecorder?: () => ActionRecorder, getIOSDriver?: () => IOSSimulatorDriver | null): void;
+export declare function registerAllTools(server: McpServer, getDriver: () => DeviceDriver, getAnalyzer: () => ScreenAnalyzer | null, getFlutter: () => FlutterDriver, getAndroidDriver?: () => AndroidDriver, getRecorder?: () => ActionRecorder, getIOSDriver?: () => IOSSimulatorDriver | null, license?: LicenseInfo): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,GACjB,CAAC;AA8CF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,YAAY,EAC7B,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,EACxC,UAAU,EAAE,MAAM,aAAa,EAC/B,gBAAgB,CAAC,EAAE,MAAM,aAAa,EACtC,WAAW,CAAC,EAAE,MAAM,cAAc,EAClC,YAAY,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,GAC7C,IAAI,CAoBN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,GACjB,CAAC;AAgFF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,YAAY,EAC7B,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,EACxC,UAAU,EAAE,MAAM,aAAa,EAC/B,gBAAgB,CAAC,EAAE,MAAM,aAAa,EACtC,WAAW,CAAC,EAAE,MAAM,cAAc,EAClC,YAAY,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,EAC9C,OAAO,CAAC,EAAE,WAAW,GACpB,IAAI,CAyBN"}

package/dist/tools/index.js

@@ -12,6 +12,7 @@ import { registerFlutterTools } from "./flutter-tools.js";
 import { registerVideoTools } from "./video-tools.js";
 import { registerRecordingTools } from "./recording-tools.js";
 import { registerIOSTools } from "./ios-tools.js";
+import { FREE_TOOLS, PRO_UPGRADE_MESSAGE } from "../license.js";
 export { registerDeviceTools, registerScreenTools, registerInteractionTools, registerAppTools, registerLogTools, registerFlutterTools, registerVideoTools, registerRecordingTools, registerIOSTools, };
 // Tools that are part of the recording system itself — don't record these
 const RECORDING_TOOLS = new Set([
@@ -19,6 +20,34 @@ const RECORDING_TOOLS = new Set([
     "stop_test_recording",
     "get_recorded_actions",
 ]);
+/**
+ * Create a proxy that intercepts registerTool calls for pro tools.
+ * If the user is on the free tier, pro tools are still registered
+ * (so they appear in the tool list) but return an upgrade message.
+ */
+function createLicenseProxy(server) {
+    const originalRegisterTool = server.registerTool.bind(server);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool = (name, config, cb) => {
+        if (FREE_TOOLS.has(name)) {
+            return originalRegisterTool(name, config, cb);
+        }
+        // Pro tool on free tier: register it with [PRO] tag but gate the handler
+        const proConfig = {
+            ...config,
+            title: config.title ? `${config.title} [Pro]` : undefined,
+            description: config.description
+                ? `[Pro] ${config.description}`
+                : undefined,
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const gatedCb = async (..._args) => {
+            return PRO_UPGRADE_MESSAGE;
+        };
+        return originalRegisterTool(name, proConfig, gatedCb);
+    };
+    return server;
+}
 /**
  * Create a proxy around McpServer that intercepts registerTool calls
  * to auto-record tool invocations when the ActionRecorder is active.
@@ -61,9 +90,13 @@ function createRecordingProxy(server, getRecorder) {
  *                      if AI features are disabled.
  * @param getFlutter  — A factory/getter that returns the FlutterDriver.
  */
-export function registerAllTools(server, getDriver, getAnalyzer, getFlutter, getAndroidDriver, getRecorder, getIOSDriver) {
-    // Wrap server with recording proxy if recorder is available
-    const registrationServer = getRecorder ? createRecordingProxy(server, getRecorder) : server;
+export function registerAllTools(server, getDriver, getAnalyzer, getFlutter, getAndroidDriver, getRecorder, getIOSDriver, license) {
+    // Wrap server with license gating proxy if on free tier
+    let registrationServer = license && license.tier === "free"
+        ? createLicenseProxy(server)
+        : server;
+    // Wrap with recording proxy if recorder is available
+    registrationServer = getRecorder ? createRecordingProxy(registrationServer, getRecorder) : registrationServer;
     registerDeviceTools(registrationServer, getDriver);
     registerScreenTools(registrationServer, getDriver);
     registerInteractionTools(registrationServer, getDriver);

package/dist/tools/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-device-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "MCP server that gives AI coding assistants (Claude, Cursor, Windsurf) the ability to see and interact with Android mobile devices via ADB — AI-powered visual inspection, element finding, and device automation",
   "type": "module",
   "main": "dist/index.js",
@@ -69,5 +69,5 @@
     "screen-analysis",
     "ui-automation"
   ],
-  "license": "MIT"
+  "license": "BUSL-1.1"
 }