feat(server): add MCP tool annotations to all tools for marketplace compliance

src/tools/accessibility.ts

@@ -442,6 +442,13 @@ export default function addAccessibilityTools(
           "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);
     },
@@ -462,6 +469,13 @@ export default function addAccessibilityTools(
         .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);
     },
@@ -499,6 +513,13 @@ export default function addAccessibilityTools(
         .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(
@@ -558,6 +579,13 @@ export default function addAccessibilityTools(
     {
       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);
     },
@@ -578,6 +606,13 @@ export default function addAccessibilityTools(
         .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);
     },

src/tools/appautomate.ts

@@ -336,6 +336,13 @@ export default function addAppAutomationTools(
           "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(
@@ -371,6 +378,13 @@ export default function addAppAutomationTools(
     "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(
@@ -412,6 +426,13 @@ export default function addAppAutomationTools(
     "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);

src/tools/applive.ts

@@ -106,6 +106,13 @@ export default function addAppLiveTools(
           "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(

src/tools/automate.ts

@@ -84,6 +84,13 @@ export default function addAutomationTools(
         .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(

src/tools/bstack-sdk.ts

@@ -16,6 +16,13 @@ export function registerRunBrowserStackTestsTool(
     "setupBrowserStackAutomateTests",
     RUN_ON_BROWSERSTACK_DESCRIPTION,
     RunTestsOnBrowserStackParamsShape,
+    {
+      title: "Set Up Automate Tests",
+      readOnlyHint: true,
+      openWorldHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+    },
     async (args) => {
       try {
         trackMCP(

src/tools/build-insights.ts

@@ -77,6 +77,13 @@ export default function addBuildInsightsTools(
     {
       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(

src/tools/get-failure-logs.ts

@@ -202,6 +202,13 @@ export default function registerGetFailureLogs(
         )
         .describe("The types of logs to fetch."),
     },
+    {
+      title: "Get Failure Logs",
+      readOnlyHint: true,
+      openWorldHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+    },
     async (args) => {
       try {
         trackMCP(

src/tools/live.ts

@@ -128,6 +128,13 @@ export default function addBrowserLiveTools(
     "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(

src/tools/observability.ts

@@ -71,6 +71,13 @@ export default function addObservabilityTools(
           "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(

src/tools/percy-sdk.ts

@@ -59,6 +59,13 @@ export function registerPercyTools(
     "percyVisualTestIntegrationAgent",
     SIMULATE_PERCY_CHANGE_DESCRIPTION,
     SetUpPercyParamsShape,
+    {
+      title: "Percy Visual Test Integration Agent",
+      readOnlyHint: true,
+      openWorldHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+    },
     async (args) => {
       try {
         trackMCP(
@@ -82,6 +89,13 @@ export function registerPercyTools(
     "expandPercyVisualTesting",
     SETUP_PERCY_DESCRIPTION,
     SetUpPercyParamsShape,
+    {
+      title: "Expand Percy Visual Testing",
+      readOnlyHint: true,
+      openWorldHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+    },
     async (args) => {
       try {
         trackMCP(
@@ -100,6 +114,13 @@ export function registerPercyTools(
     "addPercySnapshotCommands",
     PERCY_SNAPSHOT_COMMANDS_DESCRIPTION,
     UpdateTestFileWithInstructionsParams,
+    {
+      title: "Add Percy Snapshot Commands",
+      readOnlyHint: true,
+      openWorldHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+    },
     async (args) => {
       try {
         trackMCP(
@@ -123,6 +144,13 @@ export function registerPercyTools(
     "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);
@@ -137,6 +165,13 @@ export function registerPercyTools(
     "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);
@@ -151,6 +186,13 @@ export function registerPercyTools(
     "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(
@@ -169,6 +211,13 @@ export function registerPercyTools(
     "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(

src/tools/rca-agent.ts

@@ -189,6 +189,13 @@ export default function addRCATools(
     "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(
@@ -208,6 +215,13 @@ export default function addRCATools(
     "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(
@@ -227,6 +241,13 @@ export default function addRCATools(
     "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(
@@ -246,6 +267,13 @@ export default function addRCATools(
     "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(

src/tools/selfheal.ts

@@ -596,6 +596,13 @@ export default function addSelfHealTools(
         .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(
@@ -670,6 +677,13 @@ export default function addSelfHealTools(
         "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(