appium-mcp 1.88.5 → 1.90.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.90.0](https://github.com/appium/appium-mcp/compare/v1.89.0...v1.90.0) (2026-07-28)
+
+### Features
+
+* avoid duplicate page source UI payloads ([#477](https://github.com/appium/appium-mcp/issues/477)) ([b8370df](https://github.com/appium/appium-mcp/commit/b8370df42e6f6f46e043ba31b0935bede44465a3))
+
+## [1.89.0](https://github.com/appium/appium-mcp/compare/v1.88.5...v1.89.0) (2026-07-26)
+
+### Features
+
+* add payload-free tool result size telemetry ([#476](https://github.com/appium/appium-mcp/issues/476)) ([ca0262d](https://github.com/appium/appium-mcp/commit/ca0262d38a18747f08c1f08c94099c7b82150272))
+
 ## [1.88.5](https://github.com/appium/appium-mcp/compare/v1.88.4...v1.88.5) (2026-07-26)
 
 ### Performance Improvements

package/README.md

@@ -149,6 +149,7 @@ This will automatically configure the MCP server for use with Claude Code. Make
 | `CAPABILITIES_CONFIG`                     | Optional                               | Absolute path to a `capabilities.json` file with per-platform capability presets                                                                                                                                                                                                                                                                   |
 | `SCREENSHOTS_DIR`                         | Optional                               | Directory where screenshots and screen recordings are saved. Defaults to the current working directory                                                                                                                                                                                                                                             |
 | `NO_UI`                                   | Optional                               | Set to `true` or `1` to disable HTML UI components — faster responses, fewer tokens. See [NO_UI Mode](#no_ui-mode)                                                                                                                                                                                                                                 |
+| `APPIUM_MCP_APPS_ENABLED`                 | Optional                               | MCP Apps static UI mode. Enabled by default. Set to `false` or `0` to force the embedded UI compatibility fallback. See [MCP Apps Mode](#mcp-apps-mode)                                                                                                                                                                                            |
 | `APPIUM_MCP_ON_CLIENT_DISCONNECT`         | Optional                               | Session cleanup when the MCP client disconnects: `delete_all` (default) deletes **MCP-owned** Appium sessions (`safeDeleteAllSessions`); `skip` keeps those sessions across disconnects (e.g. HTTP/stream clients that reconnect). Attached/remote sessions are not removed by this path. See [MCP disconnect behavior](#mcp-disconnect-behavior). |
 | `APPIUM_MCP_WDA_APP_PATH`                 | Optional                               | Absolute path to a pre-extracted `WebDriverAgentRunner-Runner.app` bundle. When set, `prepare_ios_simulator` skips all GitHub downloads and uses this bundle directly — useful in environments where external downloads are blocked                                                                                                                |
 | `REMOTE_SERVER_URL_ALLOW_REGEX`           | Optional                               | Regex pattern that remote Appium server URLs must match. Defaults to `^https?://`                                                                                                                                                                                                                                                                  |
@@ -189,6 +190,8 @@ OTEL_TRACES_SAMPLER=parentbased_always_on
 
 When enabled, appium-mcp creates spans for MCP tool calls, prompt loads, resource reads, and resource template reads. Error status is recorded for thrown operation errors and MCP tool results marked with `isError`. Span attributes intentionally avoid raw screenshots, XML page source, prompts, credentials, and other high-cardinality or sensitive payloads.
 
+Tool spans include payload-free result-size attributes: `mcp.tool.result.content_count`, `content_types`, `text_chars`, `resource_count`, `resource_text_chars`, `image_count`, `audio_count`, `base64_chars`, and `base64_bytes_estimate` (all prefixed with `mcp.tool.result.`). `content_types` contains only known MCP types or `other`; payload values, resource URIs, MIME types, and unknown type strings are never recorded. Sizes are counted directly from known result fields without serializing or copying the complete result.
+
 For local trace inspection, use the Jaeger setup in `tools/telemetry`:
 
 ```bash
@@ -326,6 +329,30 @@ More models benchmarked can be found [here](src/tests/benchmark_model/TEST_REPOR
 
 ### Performance Optimization
 
+#### MCP Apps Mode
+
+`appium_get_page_source` uses a static MCP App inspector by default when the client advertises MCP Apps support.
+The XML remains in the normal text result for the LLM, while the inspector reads that same result instead of
+receiving a duplicated XML copy.
+
+For clients with unreliable MCP Apps rendering, set `APPIUM_MCP_APPS_ENABLED` to `false` or `0`:
+
+```json
+{
+  "appium-mcp": {
+    "env": {
+      "APPIUM_MCP_APPS_ENABLED": "false"
+    }
+  }
+}
+```
+
+This keeps interactive UI enabled but forces the previous embedded page-source inspector. The compatibility mode
+duplicates the XML inside the inspector HTML and therefore uses more result tokens and bandwidth. With a synthetic
+95,000-character page source, the static mode reduced the result from approximately 267 KB to 95 KB (about 64%).
+
+`NO_UI=true` or `NO_UI=1` takes precedence over this setting and disables both static and embedded UI.
+
 #### NO_UI Mode
 
 Set the `NO_UI` environment variable to `true` or `1` to disable UI components and improve performance:

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,GAAG,QAGpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,GAAG,QAMpD"}

package/dist/resources/index.js

@@ -1,8 +1,13 @@
 import log from '../logger.js';
+import { isMcpAppsEnabled } from '../ui/mcp-apps.js';
 // Export all resources
 import javaTemplatesResource from './java/template.js';
+import pageSourceInspectorResource from './page-source-inspector.js';
 export default function registerResources(server) {
     javaTemplatesResource(server);
+    if (isMcpAppsEnabled()) {
+        pageSourceInspectorResource(server);
+    }
     log.info('All resources registered');
 }
 //# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAW;IACnD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,oBAAoB,CAAC;AACvD,OAAO,2BAA2B,MAAM,4BAA4B,CAAC;AAErE,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAW;IACnD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACvC,CAAC"}

package/dist/resources/page-source-inspector.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from 'fastmcp';
+export declare const PAGE_SOURCE_INSPECTOR_URI = "ui://appium-mcp/page-source-inspector";
+export default function pageSourceInspectorResource(server: FastMCP): void;
+//# sourceMappingURL=page-source-inspector.d.ts.map

package/dist/resources/page-source-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-source-inspector.d.ts","sourceRoot":"","sources":["../../src/resources/page-source-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAKrC,eAAO,MAAM,yBAAyB,0CAA0C,CAAC;AAEjF,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUzE"}

package/dist/resources/page-source-inspector.js

@@ -0,0 +1,15 @@
+import { MCP_APP_MIME_TYPE } from '../ui/mcp-apps.js';
+import { createPageSourceInspectorAppUI } from '../ui/page-source-inspector-app.js';
+export const PAGE_SOURCE_INSPECTOR_URI = 'ui://appium-mcp/page-source-inspector';
+export default function pageSourceInspectorResource(server) {
+    server.addResource({
+        uri: PAGE_SOURCE_INSPECTOR_URI,
+        name: 'Appium Page Source Inspector',
+        description: 'Interactive inspector for appium_get_page_source results',
+        mimeType: MCP_APP_MIME_TYPE,
+        async load() {
+            return { text: createPageSourceInspectorAppUI() };
+        },
+    });
+}
+//# sourceMappingURL=page-source-inspector.js.map

package/dist/resources/page-source-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-source-inspector.js","sourceRoot":"","sources":["../../src/resources/page-source-inspector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAC,8BAA8B,EAAC,MAAM,oCAAoC,CAAC;AAElF,MAAM,CAAC,MAAM,yBAAyB,GAAG,uCAAuC,CAAC;AAEjF,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,MAAe;IACjE,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,CAAC,IAAI;YACR,OAAO,EAAC,IAAI,EAAE,8BAA8B,EAAE,EAAC,CAAC;QAClD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/telemetry/wrapOperations.d.ts

@@ -25,6 +25,14 @@ export declare function installTelemetryWrappers(server: FastMCP): void;
  * @returns A new tool definition with telemetry spans around the execute function.
  */
 export declare function wrapToolWithTelemetry(toolDef: ToolDef): ToolDef;
+/**
+ * Builds payload-free size attributes for a tool result.
+ *
+ * This intentionally counts known MCP content fields directly instead of
+ * serializing the whole result. Large page sources, UI HTML, and base64 data
+ * therefore are not copied or recorded in telemetry.
+ */
+export declare function safeToolResultSizeAttributes(result: unknown): Record<string, number | string[]>;
 export declare function safeInputValueAttributes(args: unknown): Record<string, string | number | boolean | string[]>;
 export {};
 //# sourceMappingURL=wrapOperations.d.ts.map

package/dist/telemetry/wrapOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapOperations.d.ts","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAMrC,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAUjD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwB9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAoB/D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAmB5G"}
+{"version":3,"file":"wrapOperations.d.ts","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAMrC,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAYjD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwB9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAwE/F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAmB5G"}

package/dist/telemetry/wrapOperations.js

@@ -7,6 +7,7 @@
 import { isSensitiveKey } from '../utils/sensitive.js';
 import { isArgumentValueTelemetryEnabled, safeAttributeValue, safeInputKeys, safeSessionId } from './attributes.js';
 import { getActiveSpan, SpanStatusCode, withSpan } from './tracer.js';
+const SAFE_TOOL_CONTENT_TYPES = new Set(['audio', 'image', 'resource', 'resource_link', 'text']);
 /**
  * Installs telemetry wrappers on the given FastMCP server instance. This should be
  * called early in the server setup process, before registering any tools, prompts,
@@ -50,14 +51,88 @@ export function wrapToolWithTelemetry(toolDef) {
         ...toolDef,
         execute: async (args, context) => withSpan(`tools/call ${toolName}`, toolAttributes(toolName, args), async () => {
             const result = await execute(args, context);
+            const span = getActiveSpan();
+            span?.setAttributes(safeToolResultSizeAttributes(result));
             if (isErrorResult(result)) {
-                getActiveSpan()?.setStatus({ code: SpanStatusCode.ERROR });
-                getActiveSpan()?.setAttribute('mcp.tool.result.is_error', true);
+                span?.setStatus({ code: SpanStatusCode.ERROR });
+                span?.setAttribute('mcp.tool.result.is_error', true);
             }
             return result;
         }),
     };
 }
+/**
+ * Builds payload-free size attributes for a tool result.
+ *
+ * This intentionally counts known MCP content fields directly instead of
+ * serializing the whole result. Large page sources, UI HTML, and base64 data
+ * therefore are not copied or recorded in telemetry.
+ */
+export function safeToolResultSizeAttributes(result) {
+    if (typeof result === 'string') {
+        return { 'mcp.tool.result.text_chars': result.length };
+    }
+    if (!isRecord(result) || !Array.isArray(result.content)) {
+        return {};
+    }
+    const contentTypes = new Set();
+    let textChars = 0;
+    let resourceCount = 0;
+    let resourceTextChars = 0;
+    let imageCount = 0;
+    let audioCount = 0;
+    let base64Chars = 0;
+    let base64BytesEstimate = 0;
+    for (const content of result.content) {
+        if (!isRecord(content)) {
+            contentTypes.add('other');
+            continue;
+        }
+        const contentType = typeof content.type === 'string' && SAFE_TOOL_CONTENT_TYPES.has(content.type) ? content.type : 'other';
+        contentTypes.add(contentType);
+        if (contentType === 'text' && typeof content.text === 'string') {
+            textChars += content.text.length;
+            continue;
+        }
+        if (contentType === 'image' || contentType === 'audio') {
+            if (contentType === 'image') {
+                imageCount += 1;
+            }
+            else {
+                audioCount += 1;
+            }
+            if (typeof content.data === 'string') {
+                base64Chars += content.data.length;
+                base64BytesEstimate += estimateBase64DecodedBytes(content.data);
+            }
+            continue;
+        }
+        if (contentType === 'resource') {
+            resourceCount += 1;
+            if (isRecord(content.resource)) {
+                if (typeof content.resource.text === 'string') {
+                    resourceTextChars += content.resource.text.length;
+                }
+                if (typeof content.resource.blob === 'string') {
+                    base64Chars += content.resource.blob.length;
+                    base64BytesEstimate += estimateBase64DecodedBytes(content.resource.blob);
+                }
+            }
+        }
+    }
+    const attributes = {
+        'mcp.tool.result.content_count': result.content.length,
+        'mcp.tool.result.content_types': [...contentTypes].sort(),
+        'mcp.tool.result.text_chars': textChars,
+        'mcp.tool.result.resource_count': resourceCount,
+        'mcp.tool.result.resource_text_chars': resourceTextChars,
+        'mcp.tool.result.image_count': imageCount,
+        'mcp.tool.result.audio_count': audioCount,
+        'mcp.tool.result.base64_chars': base64Chars,
+        'mcp.tool.result.base64_bytes_estimate': base64BytesEstimate,
+    };
+    return attributes;
+}
 export function safeInputValueAttributes(args) {
     if (!isArgumentValueTelemetryEnabled()) {
         return {};
@@ -150,4 +225,24 @@ function inputKeyAttributes(args) {
 function isErrorResult(result) {
     return (!!result && typeof result === 'object' && 'isError' in result && result.isError === true);
 }
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function estimateBase64DecodedBytes(value) {
+    const commaIndex = value.indexOf(',');
+    const hasDataUriPrefix = commaIndex >= 7 && value.slice(commaIndex - 7, commaIndex).toLowerCase() === ';base64';
+    const contentStart = hasDataUriPrefix ? commaIndex + 1 : 0;
+    const encodedLength = value.length - contentStart;
+    if (encodedLength <= 0) {
+        return 0;
+    }
+    let padding = 0;
+    if (value.endsWith('==')) {
+        padding = 2;
+    }
+    else if (value.endsWith('=')) {
+        padding = 1;
+    }
+    return Math.max(0, Math.floor((encodedLength * 3) / 4) - padding);
+}
 //# sourceMappingURL=wrapOperations.js.map

package/dist/telemetry/wrapOperations.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapOperations.js","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wrapOperations.js","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAC,+BAA+B,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAC,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAC,MAAM,aAAa,CAAC;AAYpE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjG;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAe;IACtD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAuB,CAAC;IAE1E,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,eAAe,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAuB,CAAC;IAE/G,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC3C,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAyB,CAAC;QAChF,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,SAAoB,EAAE,EAAE,CAC3C,iBAAiB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAyB,CAAC;IACnF,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAA2B,CAAC;QACtF,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,WAAwB,EAAE,EAAE,CACjD,mBAAmB,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAA2B,CAAC;IAC3F,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,2BAA2B,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAmC,CAAC;QAC9G,MAAM,CAAC,mBAAmB,GAAG,CAAC,CAAC,mBAAwC,EAAE,EAAE,CACzE,2BAA2B,CACzB,iCAAiC,CAAC,mBAAmB,CAAC,CACvD,CAAmC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAkC,CAAC;IAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;IAEhD,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,cAAc,QAAQ,EAAE,EAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;YAC7B,IAAI,EAAE,aAAa,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1D,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,IAAI,EAAE,SAAS,CAAC,EAAC,IAAI,EAAE,cAAc,CAAC,KAAK,EAAC,CAAC,CAAC;gBAC9C,IAAI,EAAE,YAAY,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;KACL,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAe;IAC1D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAC,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GACf,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACzG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE9B,IAAI,WAAW,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACjC,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YACvD,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC5B,UAAU,IAAI,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,UAAU,IAAI,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;gBACnC,mBAAmB,IAAI,0BAA0B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClE,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/B,aAAa,IAAI,CAAC,CAAC;YACnB,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,IAAI,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC9C,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;gBACpD,CAAC;gBACD,IAAI,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC9C,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;oBAC5C,mBAAmB,IAAI,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAsC;QACpD,+BAA+B,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QACtD,+BAA+B,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE;QACzD,4BAA4B,EAAE,SAAS;QACvC,gCAAgC,EAAE,aAAa;QAC/C,qCAAqC,EAAE,iBAAiB;QACxD,6BAA6B,EAAE,UAAU;QACzC,6BAA6B,EAAE,UAAU;QACzC,8BAA8B,EAAE,WAAW;QAC3C,uCAAuC,EAAE,mBAAmB;KAC7D,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,IAAI,CAAC,+BAA+B,EAAE,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAyD,EAAE,CAAC;IAE5E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,0FAA0F;QAC1F,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,UAAU,CAAC,mBAAmB,GAAG,EAAE,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAAC,SAAoB;IACnD,MAAM,IAAI,GAAG,SAAS,CAAC,IAA8B,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,IAAI,gBAAgB,CAAC;IAEtD,OAAO;QACL,GAAG,SAAS;QACZ,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CACzB,QAAQ,CACN,eAAe,UAAU,EAAE,EAC3B;YACE,iBAAiB,EAAE,UAAU;YAC7B,GAAG,eAAe,CAAC,IAAI,CAAC;SACzB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CACvB;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,WAAwB;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAgC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,kBAAkB,CAAC;IAElD,OAAO;QACL,GAAG,WAAW;QACd,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,QAAQ,CACN,gBAAgB,EAChB;YACE,kBAAkB,EAAE,GAAG;SACxB,EACD,GAAG,EAAE,CAAC,IAAI,EAAE,CACb;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CAAC,mBAAwC;IACjF,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAwC,CAAC;IAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,2BAA2B,CAAC;IAE/F,OAAO;QACL,GAAG,mBAAmB;QACtB,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CACzB,QAAQ,CACN,gBAAgB,EAChB;YACE,2BAA2B,EAAE,WAAW;YACxC,GAAG,eAAe,CAAC,IAAI,CAAC;SACzB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CACvB;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,IAAa;IACrD,MAAM,UAAU,GAAsC;QACpD,eAAe,EAAE,QAAQ;KAC1B,CAAC;IAEF,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,GAAG,eAAe,CAAC,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACpC,OAAO;QACL,GAAG,kBAAkB,CAAC,IAAI,CAAC;QAC3B,GAAG,wBAAwB,CAAC,IAAI,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAC,gBAAgB,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,OAAO,CACL,CAAC,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,IAAK,MAA8B,CAAC,OAAO,KAAK,IAAI,CAClH,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,gBAAgB,GAAG,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC;IAChH,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IAClD,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AACpE,CAAC"}

package/dist/tools/interactions/get-page-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-page-source.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/get-page-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AAOpD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA0C3D"}
+{"version":3,"file":"get-page-source.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/get-page-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AASpD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+C3D"}

package/dist/tools/interactions/get-page-source.js

@@ -1,20 +1,24 @@
 import { z } from 'zod';
 import { getPageSource as _getPageSource } from '../../command.js';
+import { PAGE_SOURCE_INSPECTOR_URI } from '../../resources/page-source-inspector.js';
+import { clientSupportsMcpApps, isMcpAppsEnabled } from '../../ui/mcp-apps.js';
 import { createUIResource, createPageSourceInspectorUI, addUIResourceToResponse } from '../../ui/mcp-ui-utils.js';
 import { resolveDriver, textResult, errorResult, toolErrorMessage } from '../tool-response.js';
 export default function getPageSource(server) {
+    const mcpAppsEnabled = isMcpAppsEnabled();
     const pageSourceSchema = z.object({
         sessionId: z.string().optional().describe('Session ID to target. If omitted, uses the active session.'),
     });
     server.addTool({
         name: 'appium_get_page_source',
         description: 'Get the page source (XML) from the current screen',
+        _meta: mcpAppsEnabled ? { ui: { resourceUri: PAGE_SOURCE_INSPECTOR_URI } } : undefined,
         parameters: pageSourceSchema,
         annotations: {
             readOnlyHint: true,
             openWorldHint: false,
         },
-        execute: async (args, _context) => {
+        execute: async (args, context) => {
             const resolved = await resolveDriver(args.sessionId);
             if (!resolved.ok) {
                 return resolved.result;
@@ -26,8 +30,13 @@ export default function getPageSource(server) {
                     return errorResult('Page source is empty or null');
                 }
                 const textResponse = textResult('Page source retrieved successfully: \n' + '```xml ' + pageSource + '```');
+                // MCP Apps-capable clients fetch the static inspector once and pass
+                // this existing text result to it, avoiding a second copy of the XML.
+                if (mcpAppsEnabled && clientSupportsMcpApps(server, context)) {
+                    return textResponse;
+                }
                 // Add interactive page source inspector UI
-                return addUIResourceToResponse(textResponse, () => createUIResource(`ui://appium-mcp/page-source-inspector/${Date.now()}`, createPageSourceInspectorUI(pageSource)));
+                return addUIResourceToResponse(textResponse, () => createUIResource(`${PAGE_SOURCE_INSPECTOR_URI}/${Date.now()}`, createPageSourceInspectorUI(pageSource)));
             }
             catch (err) {
                 return errorResult(`Failed to get page source. Error: ${toolErrorMessage(err)}`);

package/dist/tools/interactions/get-page-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-page-source.js","sourceRoot":"","sources":["../../../src/tools/interactions/get-page-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,aAAa,IAAI,cAAc,EAAC,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAC,gBAAgB,EAAE,2BAA2B,EAAE,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAChH,OAAO,EAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAE7F,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAe;IACnD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KACxG,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAsC,EACtC,QAA6C,EACrB,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,MAAM,EAAC,MAAM,EAAC,GAAG,QAAQ,CAAC;YAE1B,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,WAAW,CAAC,8BAA8B,CAAC,CAAC;gBACrD,CAAC;gBAED,MAAM,YAAY,GAAG,UAAU,CAAC,wCAAwC,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;gBAE3G,2CAA2C;gBAC3C,OAAO,uBAAuB,CAAC,YAAY,EAAE,GAAG,EAAE,CAChD,gBAAgB,CACd,yCAAyC,IAAI,CAAC,GAAG,EAAE,EAAE,EACrD,2BAA2B,CAAC,UAAU,CAAC,CACxC,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,WAAW,CAAC,qCAAqC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"get-page-source.js","sourceRoot":"","sources":["../../../src/tools/interactions/get-page-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,aAAa,IAAI,cAAc,EAAC,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAC,yBAAyB,EAAC,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAC,qBAAqB,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAC,gBAAgB,EAAE,2BAA2B,EAAE,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAChH,OAAO,EAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAE7F,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAe;IACnD,MAAM,cAAc,GAAG,gBAAgB,EAAE,CAAC;IAC1C,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KACxG,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,mDAAmD;QAChE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAC,EAAE,EAAE,EAAC,WAAW,EAAE,yBAAyB,EAAC,EAAC,CAAC,CAAC,CAAC,SAAS;QAClF,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAsC,EACtC,OAA4C,EACpB,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,MAAM,EAAC,MAAM,EAAC,GAAG,QAAQ,CAAC;YAE1B,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,WAAW,CAAC,8BAA8B,CAAC,CAAC;gBACrD,CAAC;gBAED,MAAM,YAAY,GAAG,UAAU,CAAC,wCAAwC,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;gBAE3G,oEAAoE;gBACpE,sEAAsE;gBACtE,IAAI,cAAc,IAAI,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;oBAC7D,OAAO,YAAY,CAAC;gBACtB,CAAC;gBAED,2CAA2C;gBAC3C,OAAO,uBAAuB,CAAC,YAAY,EAAE,GAAG,EAAE,CAChD,gBAAgB,CAAC,GAAG,yBAAyB,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC,CACxG,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,WAAW,CAAC,qCAAqC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/ui/mcp-apps.d.ts

@@ -0,0 +1,15 @@
+import type { FastMCP } from 'fastmcp';
+export declare const MCP_APPS_EXTENSION_ID = "io.modelcontextprotocol/ui";
+export declare const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
+export declare function isUIEnabled(): boolean;
+/**
+ * MCP Apps are enabled by default when UI is enabled. Set
+ * APPIUM_MCP_APPS_ENABLED=false or 0 to force the embedded UI compatibility
+ * path for clients whose MCP Apps renderer is unreliable.
+ */
+export declare function isMcpAppsEnabled(): boolean;
+export declare function supportsMcpAppsCapability(capabilities: unknown): boolean;
+export declare function clientSupportsMcpApps(server: Pick<FastMCP, 'sessions'>, context: {
+    sessionId?: string;
+} | undefined): boolean;
+//# sourceMappingURL=mcp-apps.d.ts.map

package/dist/ui/mcp-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-apps.d.ts","sourceRoot":"","sources":["../../src/ui/mcp-apps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAErC,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAiBxE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EACjC,OAAO,EAAE;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,GACxC,OAAO,CAST"}

package/dist/ui/mcp-apps.js

@@ -0,0 +1,44 @@
+export const MCP_APPS_EXTENSION_ID = 'io.modelcontextprotocol/ui';
+export const MCP_APP_MIME_TYPE = 'text/html;profile=mcp-app';
+export function isUIEnabled() {
+    return process.env.NO_UI !== 'true' && process.env.NO_UI !== '1';
+}
+/**
+ * MCP Apps are enabled by default when UI is enabled. Set
+ * APPIUM_MCP_APPS_ENABLED=false or 0 to force the embedded UI compatibility
+ * path for clients whose MCP Apps renderer is unreliable.
+ */
+export function isMcpAppsEnabled() {
+    const configuredValue = process.env.APPIUM_MCP_APPS_ENABLED;
+    return isUIEnabled() && configuredValue !== 'false' && configuredValue !== '0';
+}
+export function supportsMcpAppsCapability(capabilities) {
+    if (!isRecord(capabilities) || !isRecord(capabilities.extensions)) {
+        return false;
+    }
+    const uiCapability = capabilities.extensions[MCP_APPS_EXTENSION_ID];
+    if (!isRecord(uiCapability) || !Array.isArray(uiCapability.mimeTypes)) {
+        return false;
+    }
+    return uiCapability.mimeTypes.some((mimeType) => {
+        if (typeof mimeType !== 'string') {
+            return false;
+        }
+        return normalizeMimeType(mimeType) === MCP_APP_MIME_TYPE;
+    });
+}
+export function clientSupportsMcpApps(server, context) {
+    const session = context?.sessionId !== undefined
+        ? server.sessions.find((candidate) => candidate.sessionId === context.sessionId)
+        : server.sessions.length === 1
+            ? server.sessions[0]
+            : undefined;
+    return supportsMcpAppsCapability(session?.clientCapabilities);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function normalizeMimeType(mimeType) {
+    return mimeType.replace(/[\s"]/g, '').toLowerCase();
+}
+//# sourceMappingURL=mcp-apps.js.map

package/dist/ui/mcp-apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-apps.js","sourceRoot":"","sources":["../../src/ui/mcp-apps.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE7D,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC5D,OAAO,WAAW,EAAE,IAAI,eAAe,KAAK,OAAO,IAAI,eAAe,KAAK,GAAG,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,YAAqB;IAC7D,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,iBAAiB,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAiC,EACjC,OAAyC;IAEzC,MAAM,OAAO,GACX,OAAO,EAAE,SAAS,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC;QAChF,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACpB,CAAC,CAAC,SAAS,CAAC;IAElB,OAAO,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACtD,CAAC"}

package/dist/ui/page-source-inspector-app.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Static MCP App used by appium_get_page_source.
+ *
+ * The page source is read from the tool's existing text result, so it is sent
+ * to the client only once instead of being duplicated inside inline HTML.
+ */
+export declare function createPageSourceInspectorAppUI(): string;
+//# sourceMappingURL=page-source-inspector-app.d.ts.map

package/dist/ui/page-source-inspector-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-source-inspector-app.d.ts","sourceRoot":"","sources":["../../src/ui/page-source-inspector-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAkPvD"}

package/dist/ui/page-source-inspector-app.js

@@ -0,0 +1,250 @@
+/**
+ * Static MCP App used by appium_get_page_source.
+ *
+ * The page source is read from the tool's existing text result, so it is sent
+ * to the client only once instead of being duplicated inside inline HTML.
+ */
+export function createPageSourceInspectorAppUI() {
+    return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Page Source Inspector</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      overflow: hidden;
+      background: #1e1e1e;
+      color: #d4d4d4;
+      font-family: Monaco, Menlo, "Courier New", monospace;
+    }
+    .toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      padding: 12px 16px;
+      border-bottom: 1px solid #3e3e3e;
+      background: #2d2d2d;
+    }
+    .toolbar-left, .toolbar-right {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+    }
+    .title { font-size: 14px; font-weight: 500; }
+    .info { color: #999; font-size: 12px; }
+    .btn {
+      padding: 6px 12px;
+      border: 0;
+      border-radius: 4px;
+      background: #007aff;
+      color: #fff;
+      cursor: pointer;
+      font: 13px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    .btn:hover { background: #0056b3; }
+    .btn-secondary { background: #444; }
+    .btn-secondary:hover { background: #555; }
+    .search-box {
+      width: 200px;
+      padding: 6px 12px;
+      border: 1px solid #555;
+      border-radius: 4px;
+      outline: none;
+      background: #3e3e3e;
+      color: #d4d4d4;
+      font-size: 13px;
+    }
+    .search-box:focus { border-color: #007aff; }
+    .viewer {
+      height: calc(100vh - 50px);
+      overflow: auto;
+      padding: 16px;
+    }
+    .xml-content {
+      margin: 0;
+      white-space: pre;
+      color: #d4d4d4;
+      font-size: 13px;
+      line-height: 1.6;
+    }
+    mark {
+      border-radius: 2px;
+      background: #ffd54f;
+      color: #1e1e1e;
+    }
+    .empty {
+      color: #999;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+  </style>
+</head>
+<body>
+  <div class="toolbar">
+    <div class="toolbar-left">
+      <span class="title">📄 Page Source Inspector</span>
+      <span class="info" id="sourceInfo">Waiting for page source…</span>
+    </div>
+    <div class="toolbar-right">
+      <input type="text" class="search-box" id="searchBox" placeholder="Search…">
+      <button class="btn btn-secondary" id="copyButton">Copy</button>
+      <button class="btn btn-secondary" id="formatButton">Format</button>
+      <button class="btn" id="generateButton">Generate Locators</button>
+    </div>
+  </div>
+  <div class="viewer">
+    <pre class="xml-content empty" id="xmlContent">Waiting for page source…</pre>
+  </div>
+  <script>
+    (() => {
+      const PAGE_SOURCE_PREFIX = 'Page source retrieved successfully: \\n\\\`\\\`\\\`xml ';
+      const xmlContent = document.getElementById('xmlContent');
+      const sourceInfo = document.getElementById('sourceInfo');
+      const searchBox = document.getElementById('searchBox');
+      let source = '';
+      let nextRequestId = 1;
+      const pendingRequests = new Map();
+
+      function sendRequest(method, params) {
+        const id = nextRequestId++;
+        window.parent.postMessage({jsonrpc: '2.0', id, method, params}, '*');
+        return new Promise((resolve, reject) => pendingRequests.set(id, {resolve, reject}));
+      }
+
+      function sendNotification(method, params) {
+        window.parent.postMessage({jsonrpc: '2.0', method, params}, '*');
+      }
+
+      function sourceFromToolResult(result) {
+        const textBlock = result && Array.isArray(result.content)
+          ? result.content.find((item) => item && item.type === 'text' && typeof item.text === 'string')
+          : undefined;
+        if (!textBlock) {
+          return '';
+        }
+
+        let text = textBlock.text;
+        if (text.startsWith(PAGE_SOURCE_PREFIX) && text.endsWith('\`\`\`')) {
+          text = text.slice(PAGE_SOURCE_PREFIX.length, -3);
+        }
+        return text;
+      }
+
+      function appendHighlightedText(container, text, query) {
+        const lowerText = text.toLowerCase();
+        const lowerQuery = query.toLowerCase();
+        let position = 0;
+
+        while (position < text.length) {
+          const matchIndex = lowerText.indexOf(lowerQuery, position);
+          if (matchIndex === -1) {
+            container.appendChild(document.createTextNode(text.slice(position)));
+            return;
+          }
+          if (matchIndex > position) {
+            container.appendChild(document.createTextNode(text.slice(position, matchIndex)));
+          }
+          const mark = document.createElement('mark');
+          mark.textContent = text.slice(matchIndex, matchIndex + query.length);
+          container.appendChild(mark);
+          position = matchIndex + query.length;
+        }
+      }
+
+      function renderSource() {
+        const query = searchBox.value.trim();
+        xmlContent.textContent = '';
+        xmlContent.classList.toggle('empty', source.length === 0);
+        if (!source) {
+          xmlContent.textContent = 'No page source was returned.';
+        } else if (!query) {
+          xmlContent.textContent = source;
+        } else {
+          appendHighlightedText(xmlContent, source, query);
+        }
+        sourceInfo.textContent = source.length + ' characters';
+      }
+
+      function setSource(nextSource) {
+        source = nextSource;
+        renderSource();
+      }
+
+      function formatXML() {
+        if (!source) return;
+        try {
+          const parser = new DOMParser();
+          const documentNode = parser.parseFromString(source, 'text/xml');
+          if (documentNode.querySelector('parsererror')) {
+            throw new Error('Invalid XML');
+          }
+          source = new XMLSerializer().serializeToString(documentNode);
+          renderSource();
+        } catch {
+          window.alert('Failed to format XML');
+        }
+      }
+
+      async function copyToClipboard() {
+        if (!source) return;
+        try {
+          await navigator.clipboard.writeText(source);
+        } catch {
+          window.alert('Failed to copy page source');
+        }
+      }
+
+      async function generateLocators() {
+        try {
+          await sendRequest('tools/call', {name: 'generate_locators', arguments: {}});
+        } catch {
+          window.alert('Failed to generate locators');
+        }
+      }
+
+      window.addEventListener('message', (event) => {
+        if (event.source !== window.parent) return;
+        const message = event.data;
+        if (!message || message.jsonrpc !== '2.0') return;
+
+        if (message.id !== undefined && pendingRequests.has(message.id)) {
+          const pending = pendingRequests.get(message.id);
+          pendingRequests.delete(message.id);
+          if (message.error) {
+            pending.reject(new Error(message.error.message || 'MCP App request failed'));
+          } else {
+            pending.resolve(message.result);
+          }
+          return;
+        }
+
+        if (message.method === 'ui/notifications/tool-result') {
+          setSource(sourceFromToolResult(message.params));
+        }
+      });
+
+      searchBox.addEventListener('input', renderSource);
+      document.getElementById('copyButton').addEventListener('click', copyToClipboard);
+      document.getElementById('formatButton').addEventListener('click', formatXML);
+      document.getElementById('generateButton').addEventListener('click', generateLocators);
+
+      sendRequest('ui/initialize', {
+        protocolVersion: '2026-01-26',
+        appInfo: {name: 'Appium Page Source Inspector', version: '1.0.0'},
+        appCapabilities: {availableDisplayModes: ['inline', 'fullscreen']},
+      })
+        .then(() => sendNotification('ui/notifications/initialized', {}))
+        .catch(() => {
+          sourceInfo.textContent = 'Unable to initialize inspector';
+        });
+    })();
+  </script>
+</body>
+</html>
+  `;
+}
+//# sourceMappingURL=page-source-inspector-app.js.map

package/dist/ui/page-source-inspector-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-source-inspector-app.js","sourceRoot":"","sources":["../../src/ui/page-source-inspector-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgPN,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-mcp",
-  "version": "1.88.5",
+  "version": "1.90.0",
   "description": "Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation",
   "bugs": {
     "url": "https://github.com/appium/appium-mcp/issues"

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.appium/appium-mcp",
   "title": "MCP Appium - Mobile Development and Automation Server",
   "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
-  "version": "1.88.5",
+  "version": "1.90.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "appium-mcp",
-      "version": "1.88.5",
+      "version": "1.90.0",
       "transport": {
         "type": "stdio"
       }

package/src/resources/index.ts

@@ -1,8 +1,13 @@
 import log from '../logger.js';
+import {isMcpAppsEnabled} from '../ui/mcp-apps.js';
 // Export all resources
 import javaTemplatesResource from './java/template.js';
+import pageSourceInspectorResource from './page-source-inspector.js';
 
 export default function registerResources(server: any) {
   javaTemplatesResource(server);
+  if (isMcpAppsEnabled()) {
+    pageSourceInspectorResource(server);
+  }
   log.info('All resources registered');
 }

package/src/resources/page-source-inspector.ts

@@ -0,0 +1,18 @@
+import type {FastMCP} from 'fastmcp';
+
+import {MCP_APP_MIME_TYPE} from '../ui/mcp-apps.js';
+import {createPageSourceInspectorAppUI} from '../ui/page-source-inspector-app.js';
+
+export const PAGE_SOURCE_INSPECTOR_URI = 'ui://appium-mcp/page-source-inspector';
+
+export default function pageSourceInspectorResource(server: FastMCP): void {
+  server.addResource({
+    uri: PAGE_SOURCE_INSPECTOR_URI,
+    name: 'Appium Page Source Inspector',
+    description: 'Interactive inspector for appium_get_page_source results',
+    mimeType: MCP_APP_MIME_TYPE,
+    async load() {
+      return {text: createPageSourceInspectorAppUI()};
+    },
+  });
+}

package/src/telemetry/wrapOperations.ts

@@ -21,6 +21,8 @@ type PromptLoad = NonNullable<PromptDef['load']>;
 type ResourceLoad = NonNullable<ResourceDef['load']>;
 type ResourceTemplateLoad = NonNullable<ResourceTemplateDef['load']>;
 
+const SAFE_TOOL_CONTENT_TYPES = new Set(['audio', 'image', 'resource', 'resource_link', 'text']);
+
 /**
  * Installs telemetry wrappers on the given FastMCP server instance. This should be
  * called early in the server setup process, before registering any tools, prompts,
@@ -77,15 +79,98 @@ export function wrapToolWithTelemetry(toolDef: ToolDef): ToolDef {
     execute: async (args, context) =>
       withSpan(`tools/call ${toolName}`, toolAttributes(toolName, args), async () => {
         const result = await execute(args, context);
+        const span = getActiveSpan();
+        span?.setAttributes(safeToolResultSizeAttributes(result));
         if (isErrorResult(result)) {
-          getActiveSpan()?.setStatus({code: SpanStatusCode.ERROR});
-          getActiveSpan()?.setAttribute('mcp.tool.result.is_error', true);
+          span?.setStatus({code: SpanStatusCode.ERROR});
+          span?.setAttribute('mcp.tool.result.is_error', true);
         }
         return result;
       }),
   };
 }
 
+/**
+ * Builds payload-free size attributes for a tool result.
+ *
+ * This intentionally counts known MCP content fields directly instead of
+ * serializing the whole result. Large page sources, UI HTML, and base64 data
+ * therefore are not copied or recorded in telemetry.
+ */
+export function safeToolResultSizeAttributes(result: unknown): Record<string, number | string[]> {
+  if (typeof result === 'string') {
+    return {'mcp.tool.result.text_chars': result.length};
+  }
+  if (!isRecord(result) || !Array.isArray(result.content)) {
+    return {};
+  }
+
+  const contentTypes = new Set<string>();
+  let textChars = 0;
+  let resourceCount = 0;
+  let resourceTextChars = 0;
+  let imageCount = 0;
+  let audioCount = 0;
+  let base64Chars = 0;
+  let base64BytesEstimate = 0;
+
+  for (const content of result.content) {
+    if (!isRecord(content)) {
+      contentTypes.add('other');
+      continue;
+    }
+
+    const contentType =
+      typeof content.type === 'string' && SAFE_TOOL_CONTENT_TYPES.has(content.type) ? content.type : 'other';
+    contentTypes.add(contentType);
+
+    if (contentType === 'text' && typeof content.text === 'string') {
+      textChars += content.text.length;
+      continue;
+    }
+
+    if (contentType === 'image' || contentType === 'audio') {
+      if (contentType === 'image') {
+        imageCount += 1;
+      } else {
+        audioCount += 1;
+      }
+      if (typeof content.data === 'string') {
+        base64Chars += content.data.length;
+        base64BytesEstimate += estimateBase64DecodedBytes(content.data);
+      }
+      continue;
+    }
+
+    if (contentType === 'resource') {
+      resourceCount += 1;
+      if (isRecord(content.resource)) {
+        if (typeof content.resource.text === 'string') {
+          resourceTextChars += content.resource.text.length;
+        }
+        if (typeof content.resource.blob === 'string') {
+          base64Chars += content.resource.blob.length;
+          base64BytesEstimate += estimateBase64DecodedBytes(content.resource.blob);
+        }
+      }
+    }
+  }
+
+  const attributes: Record<string, number | string[]> = {
+    'mcp.tool.result.content_count': result.content.length,
+    'mcp.tool.result.content_types': [...contentTypes].sort(),
+    'mcp.tool.result.text_chars': textChars,
+    'mcp.tool.result.resource_count': resourceCount,
+    'mcp.tool.result.resource_text_chars': resourceTextChars,
+    'mcp.tool.result.image_count': imageCount,
+    'mcp.tool.result.audio_count': audioCount,
+    'mcp.tool.result.base64_chars': base64Chars,
+    'mcp.tool.result.base64_bytes_estimate': base64BytesEstimate,
+  };
+
+  return attributes;
+}
+
 export function safeInputValueAttributes(args: unknown): Record<string, string | number | boolean | string[]> {
   if (!isArgumentValueTelemetryEnabled()) {
     return {};
@@ -213,3 +298,25 @@ function isErrorResult(result: unknown): boolean {
     !!result && typeof result === 'object' && 'isError' in result && (result as {isError?: unknown}).isError === true
   );
 }
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+function estimateBase64DecodedBytes(value: string): number {
+  const commaIndex = value.indexOf(',');
+  const hasDataUriPrefix = commaIndex >= 7 && value.slice(commaIndex - 7, commaIndex).toLowerCase() === ';base64';
+  const contentStart = hasDataUriPrefix ? commaIndex + 1 : 0;
+  const encodedLength = value.length - contentStart;
+  if (encodedLength <= 0) {
+    return 0;
+  }
+
+  let padding = 0;
+  if (value.endsWith('==')) {
+    padding = 2;
+  } else if (value.endsWith('=')) {
+    padding = 1;
+  }
+  return Math.max(0, Math.floor((encodedLength * 3) / 4) - padding);
+}

package/src/tools/interactions/get-page-source.ts

@@ -2,16 +2,20 @@ import type {ContentResult, FastMCP} from 'fastmcp';
 import {z} from 'zod';
 
 import {getPageSource as _getPageSource} from '../../command.js';
+import {PAGE_SOURCE_INSPECTOR_URI} from '../../resources/page-source-inspector.js';
+import {clientSupportsMcpApps, isMcpAppsEnabled} from '../../ui/mcp-apps.js';
 import {createUIResource, createPageSourceInspectorUI, addUIResourceToResponse} from '../../ui/mcp-ui-utils.js';
 import {resolveDriver, textResult, errorResult, toolErrorMessage} from '../tool-response.js';
 
 export default function getPageSource(server: FastMCP): void {
+  const mcpAppsEnabled = isMcpAppsEnabled();
   const pageSourceSchema = z.object({
     sessionId: z.string().optional().describe('Session ID to target. If omitted, uses the active session.'),
   });
   server.addTool({
     name: 'appium_get_page_source',
     description: 'Get the page source (XML) from the current screen',
+    _meta: mcpAppsEnabled ? {ui: {resourceUri: PAGE_SOURCE_INSPECTOR_URI}} : undefined,
     parameters: pageSourceSchema,
     annotations: {
       readOnlyHint: true,
@@ -19,7 +23,7 @@ export default function getPageSource(server: FastMCP): void {
     },
     execute: async (
       args: z.infer<typeof pageSourceSchema>,
-      _context: Record<string, unknown> | undefined,
+      context: Record<string, unknown> | undefined,
     ): Promise<ContentResult> => {
       const resolved = await resolveDriver(args.sessionId);
       if (!resolved.ok) {
@@ -35,12 +39,15 @@ export default function getPageSource(server: FastMCP): void {
 
         const textResponse = textResult('Page source retrieved successfully: \n' + '```xml ' + pageSource + '```');
 
+        // MCP Apps-capable clients fetch the static inspector once and pass
+        // this existing text result to it, avoiding a second copy of the XML.
+        if (mcpAppsEnabled && clientSupportsMcpApps(server, context)) {
+          return textResponse;
+        }
+
         // Add interactive page source inspector UI
         return addUIResourceToResponse(textResponse, () =>
-          createUIResource(
-            `ui://appium-mcp/page-source-inspector/${Date.now()}`,
-            createPageSourceInspectorUI(pageSource),
-          ),
+          createUIResource(`${PAGE_SOURCE_INSPECTOR_URI}/${Date.now()}`, createPageSourceInspectorUI(pageSource)),
         );
       } catch (err: unknown) {
         return errorResult(`Failed to get page source. Error: ${toolErrorMessage(err)}`);

package/src/ui/mcp-apps.ts

@@ -0,0 +1,59 @@
+import type {FastMCP} from 'fastmcp';
+
+export const MCP_APPS_EXTENSION_ID = 'io.modelcontextprotocol/ui';
+export const MCP_APP_MIME_TYPE = 'text/html;profile=mcp-app';
+
+export function isUIEnabled(): boolean {
+  return process.env.NO_UI !== 'true' && process.env.NO_UI !== '1';
+}
+
+/**
+ * MCP Apps are enabled by default when UI is enabled. Set
+ * APPIUM_MCP_APPS_ENABLED=false or 0 to force the embedded UI compatibility
+ * path for clients whose MCP Apps renderer is unreliable.
+ */
+export function isMcpAppsEnabled(): boolean {
+  const configuredValue = process.env.APPIUM_MCP_APPS_ENABLED;
+  return isUIEnabled() && configuredValue !== 'false' && configuredValue !== '0';
+}
+
+export function supportsMcpAppsCapability(capabilities: unknown): boolean {
+  if (!isRecord(capabilities) || !isRecord(capabilities.extensions)) {
+    return false;
+  }
+
+  const uiCapability = capabilities.extensions[MCP_APPS_EXTENSION_ID];
+  if (!isRecord(uiCapability) || !Array.isArray(uiCapability.mimeTypes)) {
+    return false;
+  }
+
+  return uiCapability.mimeTypes.some((mimeType) => {
+    if (typeof mimeType !== 'string') {
+      return false;
+    }
+
+    return normalizeMimeType(mimeType) === MCP_APP_MIME_TYPE;
+  });
+}
+
+export function clientSupportsMcpApps(
+  server: Pick<FastMCP, 'sessions'>,
+  context: {sessionId?: string} | undefined,
+): boolean {
+  const session =
+    context?.sessionId !== undefined
+      ? server.sessions.find((candidate) => candidate.sessionId === context.sessionId)
+      : server.sessions.length === 1
+        ? server.sessions[0]
+        : undefined;
+
+  return supportsMcpAppsCapability(session?.clientCapabilities);
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}
+
+function normalizeMimeType(mimeType: string): string {
+  return mimeType.replace(/[\s"]/g, '').toLowerCase();
+}

package/src/ui/page-source-inspector-app.ts

@@ -0,0 +1,249 @@
+/**
+ * Static MCP App used by appium_get_page_source.
+ *
+ * The page source is read from the tool's existing text result, so it is sent
+ * to the client only once instead of being duplicated inside inline HTML.
+ */
+export function createPageSourceInspectorAppUI(): string {
+  return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Page Source Inspector</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      overflow: hidden;
+      background: #1e1e1e;
+      color: #d4d4d4;
+      font-family: Monaco, Menlo, "Courier New", monospace;
+    }
+    .toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      padding: 12px 16px;
+      border-bottom: 1px solid #3e3e3e;
+      background: #2d2d2d;
+    }
+    .toolbar-left, .toolbar-right {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+    }
+    .title { font-size: 14px; font-weight: 500; }
+    .info { color: #999; font-size: 12px; }
+    .btn {
+      padding: 6px 12px;
+      border: 0;
+      border-radius: 4px;
+      background: #007aff;
+      color: #fff;
+      cursor: pointer;
+      font: 13px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    .btn:hover { background: #0056b3; }
+    .btn-secondary { background: #444; }
+    .btn-secondary:hover { background: #555; }
+    .search-box {
+      width: 200px;
+      padding: 6px 12px;
+      border: 1px solid #555;
+      border-radius: 4px;
+      outline: none;
+      background: #3e3e3e;
+      color: #d4d4d4;
+      font-size: 13px;
+    }
+    .search-box:focus { border-color: #007aff; }
+    .viewer {
+      height: calc(100vh - 50px);
+      overflow: auto;
+      padding: 16px;
+    }
+    .xml-content {
+      margin: 0;
+      white-space: pre;
+      color: #d4d4d4;
+      font-size: 13px;
+      line-height: 1.6;
+    }
+    mark {
+      border-radius: 2px;
+      background: #ffd54f;
+      color: #1e1e1e;
+    }
+    .empty {
+      color: #999;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+  </style>
+</head>
+<body>
+  <div class="toolbar">
+    <div class="toolbar-left">
+      <span class="title">📄 Page Source Inspector</span>
+      <span class="info" id="sourceInfo">Waiting for page source…</span>
+    </div>
+    <div class="toolbar-right">
+      <input type="text" class="search-box" id="searchBox" placeholder="Search…">
+      <button class="btn btn-secondary" id="copyButton">Copy</button>
+      <button class="btn btn-secondary" id="formatButton">Format</button>
+      <button class="btn" id="generateButton">Generate Locators</button>
+    </div>
+  </div>
+  <div class="viewer">
+    <pre class="xml-content empty" id="xmlContent">Waiting for page source…</pre>
+  </div>
+  <script>
+    (() => {
+      const PAGE_SOURCE_PREFIX = 'Page source retrieved successfully: \\n\\\`\\\`\\\`xml ';
+      const xmlContent = document.getElementById('xmlContent');
+      const sourceInfo = document.getElementById('sourceInfo');
+      const searchBox = document.getElementById('searchBox');
+      let source = '';
+      let nextRequestId = 1;
+      const pendingRequests = new Map();
+
+      function sendRequest(method, params) {
+        const id = nextRequestId++;
+        window.parent.postMessage({jsonrpc: '2.0', id, method, params}, '*');
+        return new Promise((resolve, reject) => pendingRequests.set(id, {resolve, reject}));
+      }
+
+      function sendNotification(method, params) {
+        window.parent.postMessage({jsonrpc: '2.0', method, params}, '*');
+      }
+
+      function sourceFromToolResult(result) {
+        const textBlock = result && Array.isArray(result.content)
+          ? result.content.find((item) => item && item.type === 'text' && typeof item.text === 'string')
+          : undefined;
+        if (!textBlock) {
+          return '';
+        }
+
+        let text = textBlock.text;
+        if (text.startsWith(PAGE_SOURCE_PREFIX) && text.endsWith('\`\`\`')) {
+          text = text.slice(PAGE_SOURCE_PREFIX.length, -3);
+        }
+        return text;
+      }
+
+      function appendHighlightedText(container, text, query) {
+        const lowerText = text.toLowerCase();
+        const lowerQuery = query.toLowerCase();
+        let position = 0;
+
+        while (position < text.length) {
+          const matchIndex = lowerText.indexOf(lowerQuery, position);
+          if (matchIndex === -1) {
+            container.appendChild(document.createTextNode(text.slice(position)));
+            return;
+          }
+          if (matchIndex > position) {
+            container.appendChild(document.createTextNode(text.slice(position, matchIndex)));
+          }
+          const mark = document.createElement('mark');
+          mark.textContent = text.slice(matchIndex, matchIndex + query.length);
+          container.appendChild(mark);
+          position = matchIndex + query.length;
+        }
+      }
+
+      function renderSource() {
+        const query = searchBox.value.trim();
+        xmlContent.textContent = '';
+        xmlContent.classList.toggle('empty', source.length === 0);
+        if (!source) {
+          xmlContent.textContent = 'No page source was returned.';
+        } else if (!query) {
+          xmlContent.textContent = source;
+        } else {
+          appendHighlightedText(xmlContent, source, query);
+        }
+        sourceInfo.textContent = source.length + ' characters';
+      }
+
+      function setSource(nextSource) {
+        source = nextSource;
+        renderSource();
+      }
+
+      function formatXML() {
+        if (!source) return;
+        try {
+          const parser = new DOMParser();
+          const documentNode = parser.parseFromString(source, 'text/xml');
+          if (documentNode.querySelector('parsererror')) {
+            throw new Error('Invalid XML');
+          }
+          source = new XMLSerializer().serializeToString(documentNode);
+          renderSource();
+        } catch {
+          window.alert('Failed to format XML');
+        }
+      }
+
+      async function copyToClipboard() {
+        if (!source) return;
+        try {
+          await navigator.clipboard.writeText(source);
+        } catch {
+          window.alert('Failed to copy page source');
+        }
+      }
+
+      async function generateLocators() {
+        try {
+          await sendRequest('tools/call', {name: 'generate_locators', arguments: {}});
+        } catch {
+          window.alert('Failed to generate locators');
+        }
+      }
+
+      window.addEventListener('message', (event) => {
+        if (event.source !== window.parent) return;
+        const message = event.data;
+        if (!message || message.jsonrpc !== '2.0') return;
+
+        if (message.id !== undefined && pendingRequests.has(message.id)) {
+          const pending = pendingRequests.get(message.id);
+          pendingRequests.delete(message.id);
+          if (message.error) {
+            pending.reject(new Error(message.error.message || 'MCP App request failed'));
+          } else {
+            pending.resolve(message.result);
+          }
+          return;
+        }
+
+        if (message.method === 'ui/notifications/tool-result') {
+          setSource(sourceFromToolResult(message.params));
+        }
+      });
+
+      searchBox.addEventListener('input', renderSource);
+      document.getElementById('copyButton').addEventListener('click', copyToClipboard);
+      document.getElementById('formatButton').addEventListener('click', formatXML);
+      document.getElementById('generateButton').addEventListener('click', generateLocators);
+
+      sendRequest('ui/initialize', {
+        protocolVersion: '2026-01-26',
+        appInfo: {name: 'Appium Page Source Inspector', version: '1.0.0'},
+        appCapabilities: {availableDisplayModes: ['inline', 'fullscreen']},
+      })
+        .then(() => sendNotification('ui/notifications/initialized', {}))
+        .catch(() => {
+          sourceInfo.textContent = 'Unable to initialize inspector';
+        });
+    })();
+  </script>
+</body>
+</html>
+  `;
+}