Hosting

remote

Transport

Streamable HTTP

Endpoint

https://mcp.saucelabs.com

Authentication

HTTP Basic Auth with Sauce Labs username and access key. Tool availability additionally depends on organization role and product entitlements.

Requirements

• Sauce Labs account, username, and access key
• Know account data center; optional region header
• Private Devices and Real Device Access API concurrency for device interaction tools
• Sauce AI for Test Authoring paid add-on (Enterprise accounts) for test authoring tools

Setup steps

1. Find username and access key in Sauce Labs dashboard.
2. Add remote MCP URL https://mcp.saucelabs.com in a compatible client and configure HTTP Basic authentication with username/access key.
3. Set X-Sauce-Region to US_WEST, US_EAST, or EU_CENTRAL if account is outside default region.
4. For Claude Code, docs show `claude mcp add --transport http sauce-labs https://mcp.saucelabs.com` with Authorization Basic and X-Sauce-Region headers.
5. Verify by asking for account information or active region; this read-only check does not require private-device entitlement.

116 tool names and descriptions are transcribed from Sauce Labs’ current first-party MCP Tools reference. This is the documented product-wide reference: actual tools returned in an account session vary by account role, product entitlements, and paid add-ons. No Sauce credentials were available for a personalized runtime tools/list query.

• get_account_info

  Retrieve your Sauce Labs account details and concurrency limits.

  01
• get_user

  Look up details for a specific user.

  02
• get_my_active_team

  Show the team your account is currently acting under.

  03
• lookup_teams

  Search the teams in your organization.

  04
• get_active_region

  Report which Sauce Labs data center the server is connected to.

  05
• get_team

  Retrieve the full profile of a team by its ID.

  06
• list_team_members

  List all members of a team.

  07
• lookup_users

  Search the organization for users, filtered by name, email, role, status, or team.

  08
• get_service_account

  Get the details of a service account by ID.

  09
• lookup_service_accounts

  List the service accounts in your organization.

  10
• listDevices

  List real devices in the catalog, with optional filters for OS, version, and form factor.

  11
• listDeviceStatus

  Show the live status (available, in use, cleaning, offline) of devices.

  12
• get_specific_device

  Retrieve the full descriptor for a single device.

  13
• createSession

  Start a real-device session on a chosen device and return a session you reference in later calls.

  14
• listSessions

  List your active real-device sessions.

  15
• deleteSession

  End an active session and release the device.

  16
• take_screenshot

  Capture a PNG screenshot of the current device screen.

  17
• openUrl

  Open a URL on the device.

  18
• applyDeviceSettings

  Change device settings such as orientation, locale, or animations.

  19
• executeShellCommand

  Run an ADB shell command on an Android device.

  20
• get_source_android

  Read the Android UI source (text, resource-id, bounds) to find elements. Android only.

  21
• get_source_ios

  Read the iOS UI element tree (labels, types, and coordinates). iOS only.

  22
• tap_android

  Tap an Android element by selector (text, content-desc, or resource-id). Android only.

  23
• tap_ios

  Tap an iOS element by its accessibility label. iOS only.

  24
• tap_at_ios

  Tap an iOS screen coordinate when no unique label is available. iOS only.

  25
• type_text_ios

  Type text into the focused iOS field. iOS only.

  26
• swipe_ios

  Swipe or scroll between two screen coordinates. iOS only.

  27
• installApp

  Install an app from Sauce Storage onto the device.

  28
• launchApp

  Launch an installed app on the device.

  29
• uninstallApp

  Remove an installed app from the device.

  30
• listAppInstallations

  List apps currently installed in the session.

  31
• waitForAppInstallation

  Wait until an app finishes installing.

  32
• listFiles

  List files in a directory on the device.

  33
• statFile

  Get metadata for a file on the device.

  34
• removeFile

  Delete a file on the device.

  35
• setNetworkConditions

  Apply custom network conditions (latency, bandwidth, packet loss) to the device.

  36
• setNetworkProfile

  Apply a predefined network profile to the device.

  37
• listNetworkProfiles

  List the available network profiles.

  38
• startNetworkCapture

  Begin capturing the device's network traffic.

  39
• stopNetworkCapture

  Stop the active network capture.

  40
• resetNetworkConditions

  Remove all network throttling and restore normal connectivity.

  41
• startAppiumServer

  Start a hosted Appium server co-located with the device and return its URL. Optionally pin an Appium version.

  42
• getAppiumServerStatus

  Report the hosted Appium server's status and endpoint URL for a session.

  43
• listAppiumVersions

  List the Appium versions available for real devices.

  44
• launchWebDriverAgent

  Launch WebDriverAgent (WDA) on an iOS device for Appium-based automation. iOS only.

  45
• getWebDriverAgentStatus

  Report WebDriverAgent's state, and its ports once it is running. iOS only.

  46
• get_recent_jobs

  List your most recent jobs.

  47
• get_job_details

  Retrieve the details and result of a specific job.

  48
• get_real_device_jobs

  List real-device jobs.

  49
• get_specific_real_device_job

  Retrieve the details of a specific real-device job.

  50
• get_test_assets

  List the assets attached to a job.

  51
• get_artifact_file

  Retrieve a specific artifact file from a job.

  52
• get_network_har_file

  Retrieve a job's captured network traffic as a HAR file.

  53
• filter_har_data

  Filter a HAR capture down to the entries you care about.

  54
• lookup_builds

  Search your builds.

  55
• get_build

  Retrieve the details of a specific build.

  56
• get_specific_real_device_job_asset

  Download a specific asset (device logs, Appium logs, video, screenshots, HAR, or crash data) from a real-device job.

  57
• get_log_json_file

  Retrieve the structured JSON command log of a virtual-device test.

  58
• get_build_for_job

  Find the build a specific job belongs to.

  59
• lookup_jobs_in_build

  List the jobs in a build, with optional status filters.

  60
• get_test_cases

  List test cases with pass, fail, and error counts, rates, and durations, sorted by run count, failure rate, or duration.

  61
• get_test_case_stats

  Summarize how many test cases are consistently passing, failing, or erroring.

  62
• get_errors

  List the distinct error messages in a time window, ranked by how often each occurred.

  63
• get_error_trends

  Compare error counts with the previous period to find new or rising errors.

  64
• get_failing_tests

  List the tests whose failures Failure Analysis matched to a known root cause.

  65
• get_root_causes

  List the root causes Failure Analysis detected, with the jobs and tests each one affected.

  66
• get_coverage

  Break down test runs by device, browser, or OS, with run counts and total duration.

  67
• get_org_concurrency

  Show your organization's peak concurrency over time, its limits, and each team's share.

  68
• get_team_concurrency

  Show peak concurrency over time for one or more teams.

  69
• get_org_visual_usage

  Show your organization's Sauce Visual snapshot usage over a date range.

  70
• get_team_visual_usage

  Show Sauce Visual snapshot usage for one or more teams over a date range.

  71
• ask_insights

  Answer a plain-English question about your jobs and builds with a table of results. Use it when no other Insights tool fits.

  72
• upload_file_to_storage

  Upload an app build to Sauce Storage.

  73
• get_storage_files

  List the app builds in Sauce Storage.

  74
• get_storage_groups

  List the storage groups (apps grouped by identifier).

  75
• get_storage_groups_settings

  Get the settings for a storage app group.

  76
• get_tunnel_information

  Retrieve details for a specific tunnel.

  77
• get_tunnels_for_user

  List the tunnels owned by a user.

  78
• get_current_jobs_for_tunnel

  List the jobs currently running through a tunnel.

  79
• get_tunnel_version_downloads

  Get the download URLs for a specific Sauce Connect version.

  80
• generate_test_case

  Generate a test case from a natural-language intent against a web URL or a mobile app in Sauce Storage.

  81
• Get_test_case_generation_status

  Check the status of an asynchronous generation task and get the resulting test case ID when it completes.

  82
• List_test_cases

  List and search your saved test cases, with filters for search term, date range, user, team, and suite.

  83
• List_distinct_test_case_tags

  List every distinct tag in use across your organization's test cases.

  84
• Get_a_test_case

  Retrieve the full details and steps of a single test case.

  85
• Rename_a_test_case

  Rename an existing test case.

  86
• Delete_a_test_case

  Delete a test case.

  87
• List_valid_code_generation_targets_for_a_test_case

  List the language/framework targets available for a given test case (depends on its platform).

  88
• Generate_source_code_for_a_test_case

  Generate source code for the latest revision of a test case in a chosen target (e.g. javascript_webdriverio ).

  89
• Run_a_test_case

  Start a run of a test case against one or more browser/device targets, optionally under a build name and Sauce Connect tunnel.

  90
• Get_a_test_case_run

  Retrieve the status and result of a specific test case run.

  91
• List_test_case_runs

  List the runs for a test case.

  92
• Get_artifact_file

  Retrieve an artifact file (such as a screenshot or log) produced by a test case run.

  93
• Create_a_test_suite

  Create a test suite, optionally with a name, tags, and an initial set of test cases.

  94
• List_test_suites

  List your test suites.

  95
• Get_a_test_suite

  Retrieve the details of a single test suite, including its test cases.

  96
• Update_a_test_suite

  Update a suite: rename it, change tags, or add and remove test cases.

  97
• Delete_a_test_suite

  Delete a test suite.

  98
• Run_all_test_cases_in_a_suite

  Queue runs for every test case in a suite, optionally under a shared build name.

  99
• Create_a_test_schedule

  Create a schedule that runs one or more suites on a cron cadence in a given timezone, with optional start/end dates and a max run count.

  100
• List_test_schedules

  List your test schedules.

  101
• Get_a_test_schedule

  Retrieve the details of a single schedule.

  102
• Update_a_test_schedule

  Update a schedule: change its cadence, suites, run owner, or enable or pause it.

  103
• Delete_a_test_schedule

  Delete a schedule.

  104
• List_variables

  Return a paginated list of variables, with optional filters for scope and name. For secret variables, the value is left out.

  105
• Get_a_single_variable

  Return a single variable by its ID. For a secret variable, the value is not returned.

  106
• Create_a_variable

  Create a variable in a scope, optionally marked as secret. A secret's value is stored separately and is never returned when you list or retrieve variables.

  107
• Update_a_variable

  Change a variable's name, value, description, or secret setting. Only the team that owns the variable can update it.

  108
• Delete_a_variable

  Delete a variable. If the variable is secret, its stored value is deleted too. Only the team that owns the variable can delete it.

  109
• error_reporting_get_context

  Returns the caller's environment: universe and the projects the authenticated account can see. Call first in a session to resolve which project subsequent queries target.

  110
• error_reporting_list_attributes

  Lists the attributes available on a project—the fields a query can filter, group, or fold on. Call before constructing any filtered or grouped query so filters use real attribute names.

  111
• error_reporting_list_groups

  Returns crash groups for a project over a time window, ranked with error counts, first/last seen, and affected users. The entry point for "what's broken right now."

  112
• error_reporting_list_instances

  Returns individual error objects, one row each, with selected attribute columns. Use when raw events matter rather than the aggregate—for example, slicing by version, device, or user.

  113
• error_reporting_get_group

  Returns a single crash group in depth, beyond what the ranked list carries. Use after list_groups to investigate one group.

  114
• error_reporting_get_instance

  Returns one error object in full: the crashing thread's callstack, its attributes, and the attachments available on it. The main triage tool.

  115
• error_reporting_get_attachment

  Fetches one file attached to an error object—most usefully the SDK breadcrumbs. Call after get_instance surfaces the attachment list.

  116

• Tool availability depends on organization role, account permissions, product subscriptions, and paid add-ons. Dedicated devices and Real Device Access API concurrency are required for many device tools; Test Authoring, AI Insights, and Error Reporting have separate entitlement requirements.

• official tool reference

  Current Sauce Labs docs list the product-wide tool reference, including account/team, real-device, jobs, insights, storage, tunnels, test-authoring, variable and error-reporting tools.

• official setup guide

  Publisher setup guide documents the hosted endpoint, Streamable HTTP, and HTTP Basic authentication with Sauce Labs username and access key.

Documentation checked 2026-10-28T13:41:09.000Z. Connection has not been runtime tested.