Sauce Labs

You can use the Sauce Labs MCP Server to connect your large language model (LLM) client with Sauce Labs’ device cloud, enabling natural language interactions for account management, device discovery, test analysis, builds, storage, and RDC workflows. This MCP setup provides two specialized servers that you can run together for full Sauce Labs integration and streamlined testing operations.

How to use

You will run two MCP endpoints locally or remotely and point your LLM client to them. Use the core server for general Sauce Labs API access including accounts, devices, jobs, builds, storage, and tunnels. Use the RDC OpenAPI server to automatically discover RDC endpoints and support Real Device Cloud workflows. Operate both servers from your LLM client to enable comprehensive Sauce Labs interactions in conversations.

How to install

Prerequisites: You need Python 3.10 or newer and the pip package manager. You also need a Sauce Labs account with API access and an LLM client such as Gemini CLI, Claude Desktop, Goose, or another compatible client.

Step 1: Install the MCP package. Run the following command to install both servers and expose their command-line entry points.

pip install sauce-api-mcp

Step 2: Verify the installation by confirming the executables are available on your system.

which sauce-api-mcp
which sauce-api-mcp-rdc

Additional setup and configuration

Step 3: Create or update your MCP client configuration to include both MCP servers and your Sauce Labs credentials. You will configure the two MCP servers with their respective commands and credentials in your client’s MCP configuration.

Example configuration you can adapt for your MCP client (both servers included):

{
  "mcpServers": {
    "sauce-api-mcp-core": {
      "command": "sauce-api-mcp",
      "env": {
        "SAUCE_USERNAME": "your-sauce-username",
        "SAUCE_ACCESS_KEY": "your-sauce-access-key"
      }
    },
    "sauce-api-mcp-rdc": {
      "command": "sauce-api-mcp-rdc",
      "env": {
        "SAUCE_USERNAME": "your-sauce-username",
        "SAUCE_ACCESS_KEY": "your-sauce-access-key"
      }
    }
  }
}

Available tools

get_account_info

Retrieve current user account information including plan and usage details.

lookup_users

Find users within your organization and retrieve their basic profiles.

get_user

Get detailed information for a specific user.

lookup_teams

Find teams in your organization and retrieve team metadata.

get_team

Get details about a specific team and its members.

list_team_members

List all members of a specific team.

get_devices_status

List all available devices and their current status across data centers.

get_specific_device

Provide detailed information about a chosen device.

get_private_devices

List private devices available to your account.

get_recent_jobs

Retrieve your most recent test jobs for quick analysis.

get_job_details

Obtain comprehensive details about a particular job, including logs and assets.

get_real_device_jobs

List active jobs running on real devices.

get_specific_real_device_job

Get detailed information for a specific real device job.

get_specific_real_device_job_asset

Download assets for a real device job such as logs, videos, or screenshots.

lookup_builds

Search for builds using multiple filters.

get_build

Get detailed information about a specific build.

lookup_jobs_in_build

List all jobs that belong to a particular build.

get_storage_files

List files uploaded to storage, such as applications and test artifacts.

get_storage_groups

List storage groups for organizing uploaded assets.

get_storage_groups_settings

Get settings for specific storage groups.

get_tunnels_for_user

List active Sauce Connect tunnels for your account.

get_tunnel_information

Get details about a specific tunnel and its configuration.

get_current_jobs_for_tunnel

See which jobs are using a given tunnel.

get_test_assets

Retrieve test artifacts like logs, videos, and screenshots.

get_log_json_file

Access structured JSON logs from test runs.