@browserstack/mcp-server 1.2.36-beta.2 → 1.3.0

package/README.md

@@ -41,6 +41,8 @@ Click on the buttons below to install MCP in your respective IDE:
 
 <a href="http://mcp.browserstack.com/one-click-setup?client=vscode"><img src="assets/one-click-vs-code.png" alt="Install in VS Code" width="160" height="80"></a>&nbsp;&nbsp;&nbsp;<a href="http://mcp.browserstack.com/one-click-setup?client=cursor"><img src="assets/one-click-cursor.png" alt="Install in Cursor" width="150" height="70"></a>
 
+> **Note:** The hosted Remote MCP server (`mcp.browserstack.com`) is now fully stateless over Streamable HTTP — any Streamable-HTTP client (Claude, Cursor, VS Code, ChatGPT) connects with no configuration change.
+
 #### Note : Ensure you are using Node version >= `18.0` 
 - Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
 - To Upgrade Node :

package/dist/tools/accessibility.js

@@ -213,6 +213,12 @@ export default function addAccessibilityTools(server, config) {
         query: z
             .string()
             .describe("Any accessibility, a11y, WCAG, or web accessibility question"),
+    }, {
+        title: "Accessibility Expert",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         return await executeAccessibilityRAG(args, server, config);
     });
@@ -227,6 +233,12 @@ export default function addAccessibilityTools(server, config) {
             .boolean()
             .optional()
             .describe("Enable advanced accessibility rules in the scan settings"),
+    }, {
+        title: "Start Accessibility Scan",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
     }, async (args, context) => {
         return await executeAccessibilityScan(args, context, server, config);
     });
@@ -256,6 +268,12 @@ export default function addAccessibilityTools(server, config) {
             .string()
             .optional()
             .describe("CSS selector for submit button (required for form auth)"),
+    }, {
+        title: "Create Accessibility Auth Config",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
     }, async (args) => {
         try {
             const creds = await elicitCredentialsIfSupported(server, { username: args.username, password: args.password }, [
@@ -287,6 +305,12 @@ export default function addAccessibilityTools(server, config) {
     });
     tools.getAccessibilityAuthConfig = server.tool("getAccessibilityAuthConfig", "Retrieve an existing authentication configuration by ID.", {
         configId: z.number().describe("ID of the auth configuration to retrieve"),
+    }, {
+        title: "Get Accessibility Auth Config",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         return await executeGetAuthConfig(args, server, config);
     });
@@ -301,6 +325,12 @@ export default function addAccessibilityTools(server, config) {
             .number()
             .optional()
             .describe("Character offset for pagination (default: 0)"),
+    }, {
+        title: "Fetch Accessibility Issues",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         return await executeFetchAccessibilityIssues(args, server, config);
     });

package/dist/tools/appautomate.js

@@ -207,6 +207,12 @@ export default function addAppAutomationTools(server, config) {
         appPath: z
             .string()
             .describe("The path to the .apk or .ipa file. Required for app installation."),
+    }, {
+        title: "Take App Screenshot",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
     }, async (args) => {
         try {
             trackMCP("takeAppScreenshot", server.server.getClientVersion(), undefined, config);
@@ -226,7 +232,13 @@ export default function addAppAutomationTools(server, config) {
             };
         }
     });
-    tools.runAppTestsOnBrowserStack = server.tool("runAppTestsOnBrowserStack", RUN_APP_AUTOMATE_DESCRIPTION, RUN_APP_AUTOMATE_SCHEMA, async (args) => {
+    tools.runAppTestsOnBrowserStack = server.tool("runAppTestsOnBrowserStack", RUN_APP_AUTOMATE_DESCRIPTION, RUN_APP_AUTOMATE_SCHEMA, {
+        title: "Run App Tests on BrowserStack",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, async (args) => {
         try {
             trackMCP("runAppTestsOnBrowserStack", server.server.getClientVersion(), undefined, config);
             const devicesAsArrays = args.devices.map((device) => [device.platform, device.deviceName, device.osVersion]);
@@ -246,7 +258,13 @@ export default function addAppAutomationTools(server, config) {
             };
         }
     });
-    tools.setupBrowserStackAppAutomateTests = server.tool("setupBrowserStackAppAutomateTests", SETUP_APP_AUTOMATE_DESCRIPTION, SETUP_APP_AUTOMATE_SCHEMA, async (args) => {
+    tools.setupBrowserStackAppAutomateTests = server.tool("setupBrowserStackAppAutomateTests", SETUP_APP_AUTOMATE_DESCRIPTION, SETUP_APP_AUTOMATE_SCHEMA, {
+        title: "Set Up App Automate Tests",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             return await setupAppAutomateHandler(args, config);
         }

package/dist/tools/applive.js

@@ -67,6 +67,12 @@ export default function addAppLiveTools(server, config) {
         appPath: z
             .string()
             .describe("The path to the .ipa or .apk file to install on the device. Always ask the user for the app path, do not assume it."),
+    }, {
+        title: "Run App Live Session",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
     }, async (args) => {
         try {
             trackMCP("runAppLiveSession", server.server.getClientVersion(), undefined, config);

package/dist/tools/automate.js

@@ -58,6 +58,12 @@ export default function addAutomationTools(server, config) {
         sessionType: z
             .enum([SessionType.Automate, SessionType.AppAutomate])
             .describe("Type of BrowserStack session"),
+    }, {
+        title: "Fetch Automation Screenshots",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("fetchAutomationScreenshots", server.server.getClientVersion(), undefined, config);

package/dist/tools/bstack-sdk.js

@@ -5,7 +5,13 @@ import { handleMCPError } from "../lib/utils.js";
 import { trackMCP } from "../lib/instrumentation.js";
 export function registerRunBrowserStackTestsTool(server, config) {
     const tools = {};
-    tools.setupBrowserStackAutomateTests = server.tool("setupBrowserStackAutomateTests", RUN_ON_BROWSERSTACK_DESCRIPTION, RunTestsOnBrowserStackParamsShape, async (args) => {
+    tools.setupBrowserStackAutomateTests = server.tool("setupBrowserStackAutomateTests", RUN_ON_BROWSERSTACK_DESCRIPTION, RunTestsOnBrowserStackParamsShape, {
+        title: "Set Up Automate Tests",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("runTestsOnBrowserStack", server.server.getClientVersion(), config);
             return await runTestsOnBrowserStackHandler(args, config);

package/dist/tools/build-insights.js

@@ -54,6 +54,12 @@ export default function addBuildInsightsTools(server, config) {
     const tools = {};
     tools.fetchBuildInsights = server.tool("fetchBuildInsights", "Fetches insights about a BrowserStack build by combining build details and quality gate results.", {
         buildId: z.string().describe("The build UUID of the BrowserStack build"),
+    }, {
+        title: "Fetch Build Insights",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("fetchBuildInsights", server.server.getClientVersion(), config);

package/dist/tools/get-failure-logs.js

@@ -119,6 +119,12 @@ export default function registerGetFailureLogs(server, config) {
             AppAutomateLogType.CrashLogs,
         ]))
             .describe("The types of logs to fetch."),
+    }, {
+        title: "Get Failure Logs",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("getFailureLogs", server.server.getClientVersion(), undefined, config);

package/dist/tools/live.js

@@ -88,7 +88,13 @@ async function runBrowserSession(rawArgs, config) {
 }
 export default function addBrowserLiveTools(server, config) {
     const tools = {};
-    tools.runBrowserLiveSession = server.tool("runBrowserLiveSession", "Launch a BrowserStack Live session (desktop or mobile).", LiveArgsShape, async (args) => {
+    tools.runBrowserLiveSession = server.tool("runBrowserLiveSession", "Launch a BrowserStack Live session (desktop or mobile).", LiveArgsShape, {
+        title: "Run Browser Live Session",
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, async (args) => {
         try {
             trackMCP("runBrowserLiveSession", server.server.getClientVersion(), undefined, config);
             return await runBrowserSession(args, config);

package/dist/tools/observability.js

@@ -39,6 +39,12 @@ export default function addObservabilityTools(server, config) {
         projectName: z
             .string()
             .describe("Name of the project to get failures for. This is the 'projectName' key in the browserstack.yml file. If not sure, ask the user for the project name."),
+    }, {
+        title: "Get Failures in Last Run",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("getFailuresInLastRun", server.server.getClientVersion(), undefined, config);

package/dist/tools/percy-sdk.js

@@ -30,7 +30,13 @@ export function registerPercyTools(server, config) {
             ],
         };
     });
-    tools.percyVisualTestIntegrationAgent = server.tool("percyVisualTestIntegrationAgent", SIMULATE_PERCY_CHANGE_DESCRIPTION, SetUpPercyParamsShape, async (args) => {
+    tools.percyVisualTestIntegrationAgent = server.tool("percyVisualTestIntegrationAgent", SIMULATE_PERCY_CHANGE_DESCRIPTION, SetUpPercyParamsShape, {
+        title: "Percy Visual Test Integration Agent",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("VisualTestIntegrationAgent", server.server.getClientVersion(), config);
             return simulatePercyChangeHandler(args, config);
@@ -39,7 +45,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("VisualTestIntegrationAgent", server, config, error);
         }
     });
-    tools.setupPercyVisualTesting = server.tool("expandPercyVisualTesting", SETUP_PERCY_DESCRIPTION, SetUpPercyParamsShape, async (args) => {
+    tools.setupPercyVisualTesting = server.tool("expandPercyVisualTesting", SETUP_PERCY_DESCRIPTION, SetUpPercyParamsShape, {
+        title: "Expand Percy Visual Testing",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("setupPercyVisualTesting", server.server.getClientVersion(), config);
             return setUpPercyHandler(args, config);
@@ -48,7 +60,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("setupPercyVisualTesting", server, config, error);
         }
     });
-    tools.addPercySnapshotCommands = server.tool("addPercySnapshotCommands", PERCY_SNAPSHOT_COMMANDS_DESCRIPTION, UpdateTestFileWithInstructionsParams, async (args) => {
+    tools.addPercySnapshotCommands = server.tool("addPercySnapshotCommands", PERCY_SNAPSHOT_COMMANDS_DESCRIPTION, UpdateTestFileWithInstructionsParams, {
+        title: "Add Percy Snapshot Commands",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("addPercySnapshotCommands", server.server.getClientVersion(), config);
             return await updateTestsWithPercyCommands(args);
@@ -57,7 +75,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("addPercySnapshotCommands", server, config, error);
         }
     });
-    tools.listTestFiles = server.tool("listTestFiles", LIST_TEST_FILES_DESCRIPTION, {}, async () => {
+    tools.listTestFiles = server.tool("listTestFiles", LIST_TEST_FILES_DESCRIPTION, {}, {
+        title: "List Test Files",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async () => {
         try {
             trackMCP("listTestFiles", server.server.getClientVersion(), config);
             return addListTestFiles();
@@ -66,7 +90,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("listTestFiles", server, config, error);
         }
     });
-    tools.runPercyScan = server.tool("runPercyScan", "Run a Percy visual test scan. Example prompts : Run this Percy build/scan. Never run percy scan/build without this tool", RunPercyScanParamsShape, async (args) => {
+    tools.runPercyScan = server.tool("runPercyScan", "Run a Percy visual test scan. Example prompts : Run this Percy build/scan. Never run percy scan/build without this tool", RunPercyScanParamsShape, {
+        title: "Run Percy Scan",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("runPercyScan", server.server.getClientVersion(), config);
             return runPercyScan(args);
@@ -75,7 +105,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("runPercyScan", server, config, error);
         }
     });
-    tools.fetchPercyChanges = server.tool("fetchPercyChanges", "Retrieves and summarizes all visual changes detected by Percy AI between the latest and previous builds, helping quickly review what has changed in your project.", FetchPercyChangesParamsShape, async (args) => {
+    tools.fetchPercyChanges = server.tool("fetchPercyChanges", "Retrieves and summarizes all visual changes detected by Percy AI between the latest and previous builds, helping quickly review what has changed in your project.", FetchPercyChangesParamsShape, {
+        title: "Fetch Percy Changes",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("fetchPercyChanges", server.server.getClientVersion(), config);
             return await fetchPercyChanges(args, config);
@@ -84,7 +120,13 @@ export function registerPercyTools(server, config) {
             return handleMCPError("fetchPercyChanges", server, config, error);
         }
     });
-    tools.managePercyBuildApproval = server.tool("managePercyBuildApproval", "Approve or reject a Percy build", ManagePercyBuildApprovalParamsShape, async (args) => {
+    tools.managePercyBuildApproval = server.tool("managePercyBuildApproval", "Approve or reject a Percy build", ManagePercyBuildApprovalParamsShape, {
+        title: "Manage Percy Build Approval",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("managePercyBuildApproval", server.server.getClientVersion(), config);
             return await approveOrDeclinePercyBuild(args, config);

package/dist/tools/rca-agent.js

@@ -130,7 +130,13 @@ export async function listTestIdsTool(args, config) {
 }
 export default function addRCATools(server, config) {
     const tools = {};
-    tools.fetchRCA = server.tool("fetchRCA", "Fetch AI Root Cause Analysis for the current user's failed BrowserStack Automate/App-Automate tests. Suggests fixes only; never auto-apply, require explicit user approval.", FETCH_RCA_PARAMS, async (args) => {
+    tools.fetchRCA = server.tool("fetchRCA", "Fetch AI Root Cause Analysis for the current user's failed BrowserStack Automate/App-Automate tests. Suggests fixes only; never auto-apply, require explicit user approval.", FETCH_RCA_PARAMS, {
+        title: "Fetch Root Cause Analysis",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("fetchRCA", server.server.getClientVersion(), undefined, config);
             return await fetchRCADataTool(args, config);
@@ -139,7 +145,13 @@ export default function addRCATools(server, config) {
             return handleMCPError("fetchRCA", server, config, error);
         }
     });
-    tools.getBuildId = server.tool("getBuildId", "Get the BrowserStack build ID for a given project and build name, scoped to the current user's builds.", GET_BUILD_ID_PARAMS, async (args) => {
+    tools.getBuildId = server.tool("getBuildId", "Get the BrowserStack build ID for a given project and build name, scoped to the current user's builds.", GET_BUILD_ID_PARAMS, {
+        title: "Get Build ID",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("getBuildId", server.server.getClientVersion(), undefined, config);
             return await getBuildIdTool(args, config);
@@ -148,7 +160,13 @@ export default function addRCATools(server, config) {
             return handleMCPError("getBuildId", server, config, error);
         }
     });
-    tools.listBuildId = server.tool("listBuildId", "Get the latest build ID for a project and build name, across all users (no user filter).", GET_BUILD_ID_PARAMS, async (args) => {
+    tools.listBuildId = server.tool("listBuildId", "Get the latest build ID for a project and build name, across all users (no user filter).", GET_BUILD_ID_PARAMS, {
+        title: "List Build IDs",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("listBuildId", server.server.getClientVersion(), undefined, config);
             return await listBuildIdTool(args, config);
@@ -157,7 +175,13 @@ export default function addRCATools(server, config) {
             return handleMCPError("listBuildId", server, config, error);
         }
     });
-    tools.listTestIds = server.tool("listTestIds", "List test IDs from a BrowserStack Automate build, optionally filtered by status", LIST_TEST_IDS_PARAMS, async (args) => {
+    tools.listTestIds = server.tool("listTestIds", "List test IDs from a BrowserStack Automate build, optionally filtered by status", LIST_TEST_IDS_PARAMS, {
+        title: "List Test IDs",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, async (args) => {
         try {
             trackMCP("listTestIds", server.server.getClientVersion(), undefined, config);
             return await listTestIdsTool(args, config);

package/dist/tools/selfheal.js

@@ -443,6 +443,12 @@ export default function addSelfHealTools(server, config) {
             .string()
             .describe("Build UUID. Fetches the build's self-healing report.")
             .optional(),
+    }, {
+        title: "Fetch Self-Healed Selectors",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("fetchSelfHealedSelectors", server.server.getClientVersion(), undefined, config);
@@ -495,6 +501,12 @@ export default function addSelfHealTools(server, config) {
         "(`session_id`, `original_locator`, `healed_locator`, " +
         "`healing_thought`).", {
         sessions: sessionsFieldSchema.describe("Sessions to plan edits for. See tool description for accepted shapes."),
+    }, {
+        title: "Prepare Self-Healing Plan",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
     }, async (args) => {
         try {
             trackMCP("prepareSelfHealingPlan", server.server.getClientVersion(), undefined, config);

package/dist/tools/testmanagement.js

@@ -432,22 +432,124 @@ export async function getSubTestPlanTool(args, config, server) {
  */
 export default function addTestManagementTools(server, config) {
     const tools = {};
-    tools.createProjectOrFolder = server.tool("createProjectOrFolder", "Create a project and/or folder in BrowserStack Test Management.", CreateProjFoldSchema.shape, (args) => createProjectOrFolderTool(args, config, server));
-    tools.createTestCase = server.tool("createTestCase", "Use this tool to create a test case in BrowserStack Test Management.", CreateTestCaseSchema.shape, (args) => createTestCaseTool(args, config, server));
-    tools.updateTestCase = server.tool("updateTestCase", "Update an existing test case in BrowserStack Test Management. Any subset of the following fields may be changed: name, description, preconditions, test_case_steps, owner, priority, case_type, automation_status, status, tags, issues, custom_fields. Only the supplied fields are modified.", UpdateTestCaseSchema.shape, (args) => updateTestCaseTool(args, config, server));
-    tools.listTestCases = server.tool("listTestCases", "List test cases in a project, optionally scoped to a specific folder. Omit folder_id to list all test cases in the project; provide folder_id (discoverable via listFolders) to list only that folder's cases. Supports filters: case_type, priority, pagination.", ListTestCasesSchema.shape, (args) => listTestCasesTool(args, config, server));
-    tools.listFolders = server.tool("listFolders", "List folders in a BrowserStack Test Management project, returning each folder's id and name (plus case counts and sub-folder counts). Pass parent_id to list sub-folders under a specific folder instead of top-level folders.", ListFoldersSchema.shape, (args) => listFoldersTool(args, config, server));
-    tools.listTestCaseTemplates = server.tool("listTestCaseTemplates", "List test-case templates with their numeric template_id. Use the id with createTestCase to apply a custom template (the 'template' slug only selects system templates).", ListTemplatesSchema.shape, (args) => listTemplatesTool(args, config, server));
-    tools.createTestRun = server.tool("createTestRun", "Create a test run in BrowserStack Test Management.", CreateTestRunSchema.shape, (args) => createTestRunTool(args, config, server));
-    tools.listTestRuns = server.tool("listTestRuns", "List test runs in a project with optional filters (date ranges, assignee, state, etc.)", ListTestRunsSchema.shape, (args) => listTestRunsTool(args, config, server));
-    tools.updateTestRun = server.tool("updateTestRun", "Update a test run's metadata and/or add test cases to it.", UpdateTestRunSchema.shape, (args) => updateTestRunTool(args, config, server));
-    tools.addTestResult = server.tool("addTestResult", "Add a test result to a specific test run via BrowserStack Test Management API.", AddTestResultSchema.shape, (args) => addTestResultTool(args, config, server));
-    tools.uploadProductRequirementFile = server.tool("uploadProductRequirementFile", "Upload files (e.g., PDRs, PDFs) to BrowserStack Test Management and retrieve a file mapping ID. This is utilized for generating test cases from files and is part of the Test Case Generator AI Agent in BrowserStack.", UploadFileSchema.shape, (args) => uploadProductRequirementFileTool(args, config, server));
-    tools.createTestCasesFromFile = server.tool("createTestCasesFromFile", "Generate test cases from a file in BrowserStack Test Management using the Test Case Generator AI Agent.", CreateTestCasesFromFileSchema.shape, (args, context) => createTestCasesFromFileTool(args, context, config, server));
-    tools.createLCASteps = server.tool("createLCASteps", "Generate Low Code Automation (LCA) steps for a test case in BrowserStack Test Management using the Low Code Automation Agent.", CreateLCAStepsSchema.shape, (args, context) => createLCAStepsTool(args, context, config, server));
-    tools.listTestPlans = server.tool("listTestPlans", "List test plans in a BrowserStack Test Management project. Returns each plan's identifier (TP-*), name, status, description, dates, and active/closed test-run counts. Supports pagination.", ListTestPlansSchema.shape, (args) => listTestPlansTool(args, config, server));
-    tools.getTestPlan = server.tool("getTestPlan", "Fetch a test plan by identifier (TP-*) from BrowserStack Test Management. Returns plan metadata, the full list of linked test runs, total test-case count across runs, and a status summary — suitable for generating test documentation or QA status reports.", GetTestPlanSchema.shape, (args) => getTestPlanTool(args, config, server));
-    tools.listSubTestPlans = server.tool("listSubTestPlans", "List sub-test-plans under a parent test plan (TP-*) in a Test Management project. Supports pagination.", ListSubTestPlansSchema.shape, (args) => listSubTestPlansTool(args, config, server));
-    tools.getSubTestPlan = server.tool("getSubTestPlan", "Fetch a sub-test-plan (STP-*) under a parent plan (TP-*). Returns metadata and linked test runs.", GetSubTestPlanSchema.shape, (args) => getSubTestPlanTool(args, config, server));
+    tools.createProjectOrFolder = server.tool("createProjectOrFolder", "Create a project and/or folder in BrowserStack Test Management.", CreateProjFoldSchema.shape, {
+        title: "Create Project or Folder",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args) => createProjectOrFolderTool(args, config, server));
+    tools.createTestCase = server.tool("createTestCase", "Use this tool to create a test case in BrowserStack Test Management.", CreateTestCaseSchema.shape, {
+        title: "Create Test Case",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args) => createTestCaseTool(args, config, server));
+    tools.updateTestCase = server.tool("updateTestCase", "Update an existing test case in BrowserStack Test Management. Any subset of the following fields may be changed: name, description, preconditions, test_case_steps, owner, priority, case_type, automation_status, status, tags, issues, custom_fields. Only the supplied fields are modified.", UpdateTestCaseSchema.shape, {
+        title: "Update Test Case",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    }, (args) => updateTestCaseTool(args, config, server));
+    tools.listTestCases = server.tool("listTestCases", "List test cases in a project, optionally scoped to a specific folder. Omit folder_id to list all test cases in the project; provide folder_id (discoverable via listFolders) to list only that folder's cases. Supports filters: case_type, priority, pagination.", ListTestCasesSchema.shape, {
+        title: "List Test Cases",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listTestCasesTool(args, config, server));
+    tools.listFolders = server.tool("listFolders", "List folders in a BrowserStack Test Management project, returning each folder's id and name (plus case counts and sub-folder counts). Pass parent_id to list sub-folders under a specific folder instead of top-level folders.", ListFoldersSchema.shape, {
+        title: "List Folders",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listFoldersTool(args, config, server));
+    tools.listTestCaseTemplates = server.tool("listTestCaseTemplates", "List test-case templates with their numeric template_id. Use the id with createTestCase to apply a custom template (the 'template' slug only selects system templates).", ListTemplatesSchema.shape, {
+        title: "List Test Case Templates",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listTemplatesTool(args, config, server));
+    tools.createTestRun = server.tool("createTestRun", "Create a test run in BrowserStack Test Management.", CreateTestRunSchema.shape, {
+        title: "Create Test Run",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args) => createTestRunTool(args, config, server));
+    tools.listTestRuns = server.tool("listTestRuns", "List test runs in a project with optional filters (date ranges, assignee, state, etc.)", ListTestRunsSchema.shape, {
+        title: "List Test Runs",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listTestRunsTool(args, config, server));
+    tools.updateTestRun = server.tool("updateTestRun", "Update a test run's metadata and/or add test cases to it.", UpdateTestRunSchema.shape, {
+        title: "Update Test Run",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    }, (args) => updateTestRunTool(args, config, server));
+    tools.addTestResult = server.tool("addTestResult", "Add a test result to a specific test run via BrowserStack Test Management API.", AddTestResultSchema.shape, {
+        title: "Add Test Result",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args) => addTestResultTool(args, config, server));
+    tools.uploadProductRequirementFile = server.tool("uploadProductRequirementFile", "Upload files (e.g., PDRs, PDFs) to BrowserStack Test Management and retrieve a file mapping ID. This is utilized for generating test cases from files and is part of the Test Case Generator AI Agent in BrowserStack.", UploadFileSchema.shape, {
+        title: "Upload Product Requirement File",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args) => uploadProductRequirementFileTool(args, config, server));
+    tools.createTestCasesFromFile = server.tool("createTestCasesFromFile", "Generate test cases from a file in BrowserStack Test Management using the Test Case Generator AI Agent.", CreateTestCasesFromFileSchema.shape, {
+        title: "Create Test Cases from File",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args, context) => createTestCasesFromFileTool(args, context, config, server));
+    tools.createLCASteps = server.tool("createLCASteps", "Generate Low Code Automation (LCA) steps for a test case in BrowserStack Test Management using the Low Code Automation Agent.", CreateLCAStepsSchema.shape, {
+        title: "Create LCA Steps",
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    }, (args, context) => createLCAStepsTool(args, context, config, server));
+    tools.listTestPlans = server.tool("listTestPlans", "List test plans in a BrowserStack Test Management project. Returns each plan's identifier (TP-*), name, status, description, dates, and active/closed test-run counts. Supports pagination.", ListTestPlansSchema.shape, {
+        title: "List Test Plans",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listTestPlansTool(args, config, server));
+    tools.getTestPlan = server.tool("getTestPlan", "Fetch a test plan by identifier (TP-*) from BrowserStack Test Management. Returns plan metadata, the full list of linked test runs, total test-case count across runs, and a status summary — suitable for generating test documentation or QA status reports.", GetTestPlanSchema.shape, {
+        title: "Get Test Plan",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => getTestPlanTool(args, config, server));
+    tools.listSubTestPlans = server.tool("listSubTestPlans", "List sub-test-plans under a parent test plan (TP-*) in a Test Management project. Supports pagination.", ListSubTestPlansSchema.shape, {
+        title: "List Sub Test Plans",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => listSubTestPlansTool(args, config, server));
+    tools.getSubTestPlan = server.tool("getSubTestPlan", "Fetch a sub-test-plan (STP-*) under a parent plan (TP-*). Returns metadata and linked test runs.", GetSubTestPlanSchema.shape, {
+        title: "Get Sub Test Plan",
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    }, (args) => getSubTestPlanTool(args, config, server));
     return tools;
 }

package/package.json

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