@browserstack/mcp-server 2.3.0-beta.2 → 2.3.0-beta.3

package/capability/{automate.capability-index.json → devicecontrol.capability-index.json}

@@ -2,8 +2,8 @@
  "schema_version": 1,
  "version": "0.1",
  "build_id": "automate-authored",
- "automate": {
-  "summary": "BrowserStack Automate: drive a real desktop or mobile browser page by page. The account side lists every operating system, browser and version combination available, reports parallel-session capacity, and keeps each session's record \u2014 status, shareable link, video, and console, network and profiling logs \u2014 after the browser is released. The session side opens a browser on a chosen combination and drives it: navigate, go back and forward, reload, read the page HTML and element text, find elements by CSS or XPath, click, type, clear, run JavaScript, screenshot the viewport, resize the window, move between tabs and iframes, and read cookies. Web pages are RUN here \u2014 unlike Test Management, which authors cases, and Test Reporting, which records results pushed in from a runner. Mobile APPS are not here: those are App Automate, which drives an installed app rather than a browser. Scrolling is done through execute_script, there is no capability that waits, and element ids go stale as soon as the page navigates or re-renders. A session holds a browser until it is ended.",
+ "devicecontrol": {
+  "summary": "Device control: drive a real desktop or mobile browser page by page. The account side lists every operating system, browser and version combination available, reports parallel-session capacity, and keeps each session's record \u2014 status, shareable link, video, and console, network and profiling logs \u2014 after the browser is released. The session side opens a browser on a chosen combination and drives it: navigate, go back and forward, reload, read the page HTML and element text, find elements by CSS or XPath, click, type, clear, run JavaScript, screenshot the viewport, resize the window, move between tabs and iframes, and read cookies. Web pages are RUN here \u2014 unlike Test Management, which authors cases, and Test Reporting, which records results pushed in from a runner. Mobile APPS are not here: those are mobile device control, which drives an installed app rather than a browser. Scrolling is done through execute_script, there is no capability that waits, and element ids go stale as soon as the page navigates or re-renders. A session holds a browser until it is ended.",
   "routing_terms": [
    "automate",
    "browser",
@@ -31,7 +31,9 @@
    "network logs",
    "har",
    "browser session",
-   "cross browser"
+   "cross browser",
+   "device control",
+   "browser control"
   ],
   "base_url": "https://hub.browserstack.com",
   "hosts": {
@@ -204,7 +206,7 @@
       "type": "string",
       "maxLength": 255,
       "description": "Short explanation shown beside the status.",
-      "example": "Cart totalled correctly after adding two items"
+      "example": "The page behaved as expected"
      }
     ],
     "returns": [
@@ -364,14 +366,14 @@
       "type": "string",
       "json_path": "/capabilities/alwaysMatch/bstack:options/projectName",
       "description": "Groups sessions on the dashboard.",
-      "example": "Checkout flows"
+      "example": "Web checkout"
      },
      {
       "name": "build_name",
       "type": "string",
       "json_path": "/capabilities/alwaysMatch/bstack:options/buildName",
       "description": "Build the session is filed under.",
-      "example": "agent-exploration"
+      "example": "nightly"
      },
      {
       "name": "session_name",
@@ -379,7 +381,7 @@
       "maxLength": 255,
       "json_path": "/capabilities/alwaysMatch/bstack:options/sessionName",
       "description": "Name shown for this session.",
-      "example": "cart totals"
+      "example": "sign in and add to basket"
      }
     ],
     "returns": [
@@ -425,7 +427,7 @@
       "required": true,
       "format": "uri",
       "description": "Absolute URL including the scheme.",
-      "example": "https://www.bstackdemo.com/"
+      "example": "https://www.example.com/products"
      }
     ],
     "returns": [
@@ -691,7 +693,7 @@
       "type": "string",
       "required": true,
       "description": "The selector itself, interpreted according to using.",
-      "example": ".shelf-item__buy-btn"
+      "example": "#add-to-cart"
      }
     ],
     "returns": [
@@ -748,7 +750,7 @@
       "type": "string",
       "required": true,
       "description": "The selector itself, interpreted according to using.",
-      "example": ".shelf-item__buy-btn"
+      "example": ".product-card"
      }
     ],
     "returns": [
@@ -791,7 +793,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      }
     ],
     "returns": [
@@ -836,7 +838,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      }
     ],
     "body": [
@@ -845,7 +847,7 @@
       "type": "string",
       "required": true,
       "description": "The characters to type. End with \\n to submit.",
-      "example": "BrowserStack"
+      "example": "hello"
      }
     ],
     "returns": [
@@ -888,7 +890,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      }
     ],
     "returns": [
@@ -931,7 +933,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      }
     ],
     "returns": [
@@ -974,7 +976,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      },
      {
       "name": "name",
@@ -1023,14 +1025,14 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      },
      {
       "name": "name",
       "type": "string",
       "required": true,
       "description": "The attribute to read.",
-      "example": "class"
+      "example": "href"
      }
     ],
     "returns": [
@@ -1072,7 +1074,7 @@
       "type": "string",
       "required": true,
       "description": "Element id from find_element.",
-      "example": "f.31006BCEEF25A5A489371DAD0726B51F.d.B5F92408.e.13"
+      "example": "f.00000000000000000000000000000000.d.0000000000000000.e.1"
      }
     ],
     "returns": [
@@ -1379,7 +1381,7 @@
       "type": "string",
       "required": true,
       "description": "Handle from list_window_handles.",
-      "example": "2FFCF2904DC789DD82BACEF48E43AE93"
+      "example": "00000000000000000000000000000000"
      }
     ],
     "returns": [

package/capability/{appautomate.capability-index.json → mobiledevicecontrol.capability-index.json}

@@ -2,8 +2,8 @@
  "schema_version": 1,
  "version": "0.1",
  "build_id": "appautomate-demo",
- "appautomate": {
-  "summary": "BrowserStack App Automate: run a real Android or iOS device and drive the app on it step by step. The account side lists the devices this account can use, including private ones, uploads and lists app builds, reports parallel-session capacity, and keeps each session's record \u2014 status, shareable link and video \u2014 after the device is released. The session side starts a device with an installed build and drives it: read the UI tree, find and tap elements, type, swipe, screenshot, press keys, rotate, switch between the native app and a web view, push and pull files, move the simulated GPS, change the network profile, launch, close and uninstall apps, answer biometric prompts and feed images to the camera. Apps are RUN here \u2014 unlike Test Management, which authors cases, and Test Reporting, which records results pushed in from a runner. Web browsers are not here, and neither is App Live: it has no API an agent can drive, so agent sessions run on App Automate and consume its minutes. A build must exist before a session starts and can only be uploaded from a public link, never a file on disk \u2014 so media for camera injection must come from elsewhere. The default Appium server is 1.x and rejects every `mobile:` command; ask for 2.19.0.",
+ "mobiledevicecontrol": {
+  "summary": "Mobile device control: run a real Android or iOS device and drive the app on it step by step. The account side lists the devices this account can use, including private ones, uploads and lists app builds, reports parallel-session capacity, and keeps each session's record \u2014 status, shareable link and video \u2014 after the device is released. The session side starts a device with an installed build and drives it: read the UI tree, find and tap elements, type, swipe, screenshot, press keys, rotate, switch between the native app and a web view, push and pull files, move the simulated GPS, change the network profile, launch, close and uninstall apps, answer biometric prompts and feed images to the camera. Apps are RUN here \u2014 unlike Test Management, which authors cases, and Test Reporting, which records results pushed in from a runner. Browsers are not here \u2014 those are device control, which drives a page rather than an installed app \u2014 and neither is App Live: it has no API an agent can drive, so agent sessions run on App Automate and consume its minutes. A build must exist before a session starts and can only be uploaded from a public link, never a file on disk \u2014 so media for camera injection must come from elsewhere. The default Appium server is 1.x and rejects every `mobile:` command; ask for 2.19.0.",
   "routing_terms": [
    "app automate",
    "appium",
@@ -51,7 +51,10 @@
    "os build",
    "upload apk",
    "upload ipa",
-   "local build"
+   "local build",
+   "mobile device control",
+   "device control",
+   "drive a device"
   ],
   "base_url": "https://hub-cloud.browserstack.com",
   "auth": {
@@ -72,7 +75,7 @@
      "The session ends itself after idle_timeout seconds with no command (90 by default, 300 at most) and after 2 hours in total. Keep calling, or call get_window_rect as a cheap keep-alive, while deciding the next step.",
      "Every session occupies a device and consumes App Automate minutes until it ends: always finish with execute_script setSessionStatus and then delete_session.",
      "To let a person watch the device live while the agent drives it, set interactive_debugging true and leave video on; they then open the running session on the App Automate dashboard and start the interactive session there. That window is two-way: a person's taps and scrolls reach the same device, so ask them to watch only, or re-read the page source before every action.",
-     "device_name and platform_version must be a combination App Automate offers; an unknown pair fails with a session-not-created error naming the capability.",
+     "device_name and platform_version must be a combination mobile device control offers; an unknown pair fails with a session-not-created error naming the capability.",
      "Set appium_version to 2.19.0 for any session that will use execute_script with a `mobile:` command; the default server is 1.x and answers those with a 404 listing the commands it does know.",
      "enable_biometric, enable_camera_image_injection and upload_media only take effect when set here \u2014 none of them can be turned on once the session is running.",
      "Credentials belong in the Authorization header, never inside bstack:options: capabilities are echoed back in session-not-created errors.",
@@ -145,21 +148,21 @@
       "type": "string",
       "json_path": "/capabilities/alwaysMatch/bstack:options/projectName",
       "description": "Groups sessions on the App Automate dashboard.",
-      "example": "Checkout flows"
+      "example": "Mobile checkout"
      },
      {
       "name": "build_name",
       "type": "string",
       "json_path": "/capabilities/alwaysMatch/bstack:options/buildName",
       "description": "Build the session is filed under on the dashboard.",
-      "example": "agent-exploration"
+      "example": "nightly"
      },
      {
       "name": "session_name",
       "type": "string",
       "json_path": "/capabilities/alwaysMatch/bstack:options/sessionName",
       "description": "Name shown for this session on the dashboard.",
-      "example": "Add a product to the cart"
+      "example": "sign in and add to basket"
      },
      {
       "name": "interactive_debugging",
@@ -387,7 +390,7 @@
       "type": "string",
       "required": true,
       "description": "The selector itself, interpreted according to using.",
-      "example": "nav-cart"
+      "example": "cart-button"
      }
     ],
     "returns": [
@@ -483,7 +486,7 @@
       "type": "string",
       "required": true,
       "description": "The characters to type.",
-      "example": "Galaxy S20"
+      "example": "hello"
      }
     ],
     "returns": [
@@ -1121,7 +1124,7 @@
       "type": "string",
       "maxLength": 255,
       "description": "Short explanation shown beside the status.",
-      "example": "Checkout completed and the cart showed the right total"
+      "example": "The app behaved as expected"
      }
     ],
     "returns": [
@@ -2681,7 +2684,7 @@
       "type": "string",
       "required": true,
       "description": "The selector itself, interpreted according to using.",
-      "example": "nav-cart"
+      "example": "cart-button"
      }
     ],
     "returns": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "2.3.0-beta.2",
+  "version": "2.3.0-beta.3",
   "description": "BrowserStack's Official MCP Server",
   "mcpName": "io.github.browserstack/mcp-server",
   "main": "dist/index.js",