MCP Tools#

TestZeus exposes 114 tools through its FastMCP server, so MCP clients like Claude Desktop and Cursor can call TestZeus as native tools — best when you want your AI client to run and inspect tests directly.

Source: test-zeus-ai/testzeus-mcp-server · auto-generated from this repo on every build (nightly + on source change) — to change this page, change the code

Add the MCP server#

Install it:

pip install testzeus-mcp-server   # or: uv tool install testzeus-mcp-server

Then register it with your client. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "testzeus": {
      "command": "testzeus-mcp-server",
      "env": {
        "TESTZEUS_EMAIL": "you@example.com",
        "TESTZEUS_PASSWORD": "your-password",
        "TESTZEUS_BASE_URL": "https://prod.testzeus.app/api"
      }
    }
  }
}

Restart the client and the tools below become available. In Cursor, add the same server under Settings → MCP.

Or in Claude Code — one command#

claude mcp add testzeus \
  -e TESTZEUS_EMAIL=you@example.com \
  -e TESTZEUS_PASSWORD=your-password \
  -e TESTZEUS_BASE_URL=https://prod.testzeus.app/api \
  -- testzeus-mcp-server

Full setup and every env var: repo README.

Example — ask in plain language#

Once it’s connected, just talk to your client; it picks the right tools automatically:

You: “What tests do I have? Run the login test and show me any failures.”

Assistant: lists your tests, calls run_test, then reports pass/fail with logs.

All available tools are listed below.

`add_connected_environment_code_file`#

Add a code file to a connected environment.

Parameter	Type
`connected_environment_id`	`str`
`file_path`	`str`

`add_connected_environment_metadata_file`#

Add a metadata file to a connected environment.

Parameter	Type
`connected_environment_id`	`str`
`file_path`	`str`

`add_environment_file`#

Add a environment file.

Parameter	Type
`environment_id`	`str`
`file_path`	`str`

`add_hypermind_code_block_file`#

Add a code file to a hypermind code block.

Parameter	Type
`code_block_id`	`str`
`file_path`	`str`

`add_test_data_file`#

Add a test data file.

Parameter	Type
`test_data_id`	`str`
`file_path`	`str`

`cancel_adversary_run`#

Cancel a running adversarial simulation group.

Parameter	Type
`group_id`	`str`

`cancel_test_run_group`#

Cancel all running test runs in a test run group.

Parameter	Type
`test_run_group_id_or_name`	`str`

`cancel_test_suite_run`#

Cancel a running test suite run.

Parameter	Type
`test_suite_run_id`	`str`

`create_connected_environment`#

Create a new connected environment.

Parameter	Type
`name`	`str`
`connection`	`str
`tags`	`list[str]
`metadata`	`dict[str, Any]

`create_environment`#

Create a new environment. Returns the created record, including its ID.

device_type controls which fields are allowed / shown:

‘browser’ (default): supporting_data_files, connected_environments, email_manager (do not pass mobile_supporting_data_file or mobile_device)
‘mobile-android’/’mobile-ios’: mobile_supporting_data_file, mobile_device (do not pass supporting_data_files or connected_environments)

mobile_device is a device_pool ID or device_name (use list_device_pool to discover). data_content is a JSON object (or JSON string) in the format: {“items”: [{“key”: “name”, “value”: “val”, “type”: “variable|secret”}]} tags/connected_environments/email_manager must be names of existing records, or IDs. agent_grounding_prompt is a JSON object with ‘test_creation’ and/or ‘test_execution’ string keys; missing keys default to “”.

Parameter	Type
`name`	`str`
`device_type`	`Literal['browser', 'mobile-android', 'mobile-ios']`
`data_content`	`dict[str, Any]
`tags`	`list[str]
`supporting_data_files`	`str
`mobile_supporting_data_file`	`str
`mobile_device`	`str
`connected_environments`	`list[str]
`email_manager`	`list[str]
`source_code_integrations`	`list[str]
`agent_grounding_prompt`	`dict[str, Any]

`create_extension`#

Create a new extension.

Parameter	Type
`name`	`str`
`data_content`	`str
`submit`	`bool`
`metadata`	`dict[str, Any]

`create_hypermind_code_block`#

Create a new hypermind code block.

Parameter	Type
`name`	`str`
`status`	`Literal['draft', 'ready', 'deleted']`
`tags`	`list[str]

`create_knowledge_base`#

Create a new knowledge base.

Parameter	Type
`name`	`str`
`source`	`str
`description`	`str
`status`	`Literal['draft', 'ready', 'deleted']`

`create_notification_channel`#

Create a new notification channel.

Args: name: Name of the notification channel emails: List of email addresses (required) webhooks: List of webhook URLs (optional) is_active: Set as active notification channel (default: True) is_default: Set as default notification channel (default: True)

Returns: JSON string with created channel details

Parameter	Type
`name`	`str`
`emails`	`list[str]`
`webhooks`	`list[str]
`is_active`	`bool`
`is_default`	`bool`

`create_tags`#

Create a single tag. Returns the created tag, including its ID.

Parameter	Type
`name`	`str`
`value`	`str

`create_test`#

Create a new test in TestZeus.

testing_type defaults to ‘web’. When set to ‘mobile’, an environment reference is required.

Parameter	Type
`name`	`str`
`test_feature`	`str`
`testing_type`	`Literal['web', 'mobile']`
`status`	`str`
`test_data`	`list[str]
`tags`	`list[str]
`environment`	`str
`test_params`	`dict[str, Any]
`output_schema`	`dict[str, Any]
`execution_mode`	`Literal['lenient', 'strict']`

`create_test_data`#

Create a new test data record. Returns the created record, including its ID.

content is a JSON object (or JSON string) in the format: {“items”: [{“key”: “name”, “value”: “val”, “type”: “variable|secret”}]} tags must be names of existing tags, or tag IDs. agent_grounding_prompt is a JSON object with ‘test_creation’ and/or ‘test_execution’ string keys; missing keys default to “”.

Parameter	Type
`name`	`str`
`content`	`dict[str, Any]
`tags`	`list[str]
`supporting_data_files`	`str
`agent_grounding_prompt`	`dict[str, Any]

`create_test_report_schedule`#

Create a new test report schedule.

Args: name: Name of the test report schedule is_active: Set as active test report schedule (default: True) filter_name_pattern: Filter using TestRun name pattern filter_time_intervals: Filter using time intervals (mutually exclusive with cron_expression) example: {“start_time”: “2025-01-01 00:00:00”, “end_time”: “2025-01-01 01:00:00”} cron_expression: Cron expression (mutually exclusive with filter_time_intervals) filter_tags: Filter using tag names (mutually exclusive with filter_tag_pattern) filter_tag_pattern: Filter using tag pattern (mutually exclusive with filter_tags) filter_env: Filter using environment names (mutually exclusive with filter_env_pattern) filter_env_pattern: Filter using environment pattern (mutually exclusive with filter_env) filter_test_data: Filter using test data names (mutually exclusive with filter_test_data_pattern) filter_test_data_pattern: Filter test data pattern (mutually exclusive with filter_test_data) notification_channels: List of notification channel names

Returns: JSON string with created schedule details

Parameter	Type
`name`	`str`
`is_active`	`bool`
`filter_name_pattern`	`str
`filter_time_intervals`	`dict[str, str]
`cron_expression`	`str
`filter_tags`	`list[str]
`filter_tag_pattern`	`str
`filter_env`	`list[str]
`filter_env_pattern`	`str
`filter_test_data`	`list[str]
`filter_test_data_pattern`	`str
`notification_channels`	`list[str]

`create_test_run_group`#

Create and execute a new test runs in TestZeus.

Parameter	Type
`name`	`str`
`test_ids`	`list[str]
`environment`	`str
`tags`	`list[str]
`notification_channels`	`list[str]

`create_test_suite`#

Create a new test suite.

Parameter	Type
`name`	`str`
`workflow_definition`	`dict[str, Any]`
`default_inputs`	`dict[str, Any]
`input_schema`	`list[dict[str, Any]]
`status`	`str`
`execution_mode`	`Literal['lenient', 'strict']`
`environment`	`str
`tags`	`list[str]
`notification_channels`	`list[str]

`create_test_suite_run`#

Create a new test suite run in lenient mode.

Parameter	Type
`name`	`str`
`test_suite`	`str`
`input_values`	`dict[str, Any]
`environment`	`str
`notification_channels`	`list[str]

`create_test_suite_schedule`#

Create a new test suite schedule (cron-based).

Parameter	Type
`name`	`str`
`test_suite`	`str`
`cron_expression`	`str`
`environment`	`str
`is_active`	`bool`
`notification_channels`	`list[str]
`display_name`	`str
`input_values`	`dict[str, Any]

`delete_connected_environment`#

Delete a connected environment.

Parameter	Type
`connected_env_id`	`str`

`delete_environment`#

Delete an environment by its 15-character ID or exact name.

The response identifies exactly which environment was deleted (name and ID).

Parameter	Type
`environment_id`	`str`

`delete_extension`#

Delete an extension.

Parameter	Type
`extension_id`	`str`

`delete_hypermind_code_block`#

Delete a hypermind code block.

Parameter	Type
`code_block_id`	`str`

`delete_knowledge_base`#

Delete a knowledge base.

Parameter	Type
`knowledge_base_id`	`str`

`delete_notification_channel`#

Delete a notification channel.

Parameter	Type
`channel_id_or_name`	`str`

`delete_tag`#

Delete a tag by its 15-character ID or exact name.

The response identifies exactly which tag was deleted (name and ID).

Parameter	Type
`tag_id`	`str`

`delete_test`#

Delete a test (sets status to deleted).

Parameter	Type
`test_id_or_name`	`str`

`delete_test_data`#

Delete a test data record by its 15-character ID or exact name.

The response identifies exactly which record was deleted (name and ID).

Parameter	Type
`test_data_id`	`str`

`delete_test_report_run`#

Delete a test report run.

Parameter	Type
`report_id_or_name`	`str`

`delete_test_report_schedule`#

Delete a test report schedule (sets status to deleted).

Parameter	Type
`schedule_id_or_name`	`str`

`delete_test_run`#

Delete a test run.

Parameter	Type
`test_run_id`	`str`

`delete_test_run_group`#

Delete a test run group (sets status to deleted).

Parameter	Type
`test_run_group_id_or_name`	`str`

`delete_test_suite`#

Delete a test suite.

Parameter	Type
`test_suite_id_or_name`	`str`

`delete_test_suite_schedule`#

Delete a test suite schedule.

Parameter	Type
`schedule_id`	`str`

`download_test_report`#

Download a test report file.

Args: report_id_or_name: ID or name of the test report run output_dir: Directory to save the downloaded file (default: “downloads”) format: Report format to download (“ctrf”, “pdf”, “csv”, or “zip”)

Returns: JSON string with download details

Parameter	Type
`report_id_or_name`	`str`
`output_dir`	`str`
`format`	`str`

`download_test_run_group_attachments`#

Download all attachments for all test runs in a test run group.

Parameter	Type
`test_run_group_id_or_name`	`str`
`output_dir`	`str`

`download_test_run_group_report`#

Download the report for a test run group.

Parameter	Type
`test_run_group_id_or_name`	`str`
`output_dir`	`str`
`format`	`Literal['ctrf', 'pdf', 'csv', 'zip']`

`generate_adversary_pathways`#

Start an AI pathway-generation job for a Salesforce agent profile.

Parameter	Type
`agent_profile`	`str`
`directional_prompt`	`str`
`name`	`str
`agent_name`	`str
`num_pathways`	`int
`allow_destructive`	`bool`

`generate_test`#

Generate test case(s) from a natural-language prompt using the TestZeus AI generator.

Creates a tests_ai_generator record; with submit=True the platform runs generation.

Parameter	Type
`user_prompt`	`str`
`test_feature`	`str
`environment`	`str
`test_data`	`list[str]
`num_of_testcases`	`int
`reasoning_effort`	`Literal['low', 'medium', 'high']`
`submit`	`bool`

`get_adversary_agent`#

Get details for a single Agent Harness agent by ID.

Parameter	Type
`agent_id`	`str`

`get_adversary_run_status`#

Get status and results for an adversarial simulation run group.

Parameter	Type
`group_id`	`str`

`get_connected_environment`#

Get a specific connected environment by ID or name.

Parameter	Type
`connected_env_id_or_name`	`str`

`get_dependent_test_suites`#

Get test suites that reference a test.

Parameter	Type
`test_id`	`str`

`get_device_pool_entry`#

Get a specific device from the pool by ID.

Parameter	Type
`device_id`	`str`

`get_environment`#

Get a specific environment by ID or name.

Parameter	Type
`environment_id_or_name`	`str`

`get_extension`#

Get a specific extension by ID or name.

Parameter	Type
`extension_id_or_name`	`str`

`get_hypermind_code_block`#

Get a specific hypermind code block by ID or name.

Parameter	Type
`code_block_id_or_name`	`str`

`get_knowledge_base`#

Get a specific knowledge base by ID or name.

Parameter	Type
`knowledge_base_id_or_name`	`str`

`get_notification_channel`#

Get a specific notification channel by ID or name.

Parameter	Type
`channel_id_or_name`	`str`

`get_salesforce_run_as_profiles`#

Get Salesforce user profiles for the Run-As-User (RBAC) picker.

Parameter	Type
`connection_id`	`str`

`get_tag`#

Get a specific tag by its 15-character ID or exact name.

Parameter	Type
`tag_id`	`str`

`get_test`#

Get a specific test by ID or name.

Parameter	Type
`test_id_or_name`	`str`

`get_test_data`#

Get a specific test data record by its 15-character ID or exact name.

Secret-typed values in the data content are masked in the output.

Parameter	Type
`test_data_id`	`str`

`get_test_input_params`#

Get merged input params and defaults for a test.

Parameter	Type
`test_id`	`str`

`get_test_report_run`#

Get a specific test report run by ID or name.

Parameter	Type
`report_id_or_name`	`str`

`get_test_report_schedule`#

Get a specific test report schedule by ID or name.

Parameter	Type
`schedule_id_or_name`	`str`

`get_test_run`#

Get a specific test run by ID.

Parameter	Type
`test_run_id`	`str`

`get_test_run_group`#

Get a specific test run group by ID or name.

Parameter	Type
`test_run_group_id_or_name`	`str`

`get_test_suite`#

Get a specific test suite by ID or name.

Parameter	Type
`test_suite_id_or_name`	`str`

`get_test_suite_node_run`#

Get a specific test suite node run by ID.

Parameter	Type
`node_run_id`	`str`

`get_test_suite_run`#

Get a specific test suite run by ID.

Parameter	Type
`test_suite_run_id`	`str`

`get_test_suite_schedule`#

Get a specific test suite schedule by ID or name.

Parameter	Type
`schedule_id_or_name`	`str`

`get_user_integration`#

Get a specific user integration by ID or name.

Parameter	Type
`integration_id_or_name`	`str`

`list_adversary_agents`#

List agents available for adversarial (Agent Harness) testing.

Parameter	Type
`page`	`int`
`per_page`	`int`
`status`	`str
`search`	`str

`list_adversary_pathways`#

List adversarial test pathways, optionally scoped to a single agent.

Parameter	Type
`agent_id`	`str
`page`	`int`
`per_page`	`int`

`list_connected_environments`#

List all connected environments in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_device_pool`#

List available devices in the device pool.

Devices can be filtered by platform (android/ios), cloud_provider (browserstack/saucelabs/local), device_type (real/virtual), and is_active (true/false).

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_environments`#

List environments with pagination, sorting, and filtering.

Secret-typed values in data content are masked in the output.

Args: page: 1-based page number. per_page: Items per page (max 100). filters: Exact match: {“name”: “staging”}. Partial match and other operators use the operator form: {“name”: {“operator”: “~”, “value”: “stag”}}. Operators: =, !=, >, >=, <, <=, ~ (contains), !~ (not contains). A list ORs values. Group with {“$and”: […]} / {“$or”: […]}. sort: Field name to sort by; prefix with ‘-’ for descending (e.g. “-created”).

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_extensions`#

List all extensions in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_hypermind_code_blocks`#

List all hypermind code blocks in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_knowledge_bases`#

List all knowledge bases in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_notification_channels`#

List all notification channels in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_tags`#

List tags with pagination, sorting, and filtering.

Args: page: 1-based page number. per_page: Items per page (max 100). filters: Exact match: {“name”: “smoke”}. Partial match and other operators use the operator form: {“name”: {“operator”: “~”, “value”: “smoke”}}. Operators: =, !=, >, >=, <, <=, ~ (contains), !~ (not contains). A list ORs values: {“name”: [“a”, “b”]}. Group with {“$and”: […]} / {“$or”: […]}. sort: Field name to sort by; prefix with ‘-’ for descending (e.g. “-created”).

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_data`#

List test data with pagination, sorting, and filtering.

Secret-typed values in data content are masked in the output.

Args: page: 1-based page number. per_page: Items per page (max 100). filters: Exact match: {“name”: “smoke-data”}. Partial match and other operators use the operator form: {“name”: {“operator”: “~”, “value”: “smoke”}}. Operators: =, !=, >, >=, <, <=, ~ (contains), !~ (not contains). A list ORs values. Group with {“$and”: […]} / {“$or”: […]}. sort: Field name to sort by; prefix with ‘-’ for descending (e.g. “-created”).

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_report_runs`#

List all test report runs in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_report_schedules`#

List all test report schedules in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_run_groups`#

List all test run groups in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_runs`#

List all test runs in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_suite_node_runs`#

List all test suite node runs in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_suite_runs`#

List all test suite runs in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_suite_schedules`#

List all test suite schedules in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_test_suites`#

List all test suites in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_tests`#

List all tests in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`list_user_integrations`#

List all user integrations in TestZeus.

Parameter	Type
`page`	`int`
`per_page`	`int`
`filters`	`dict[str, Any]
`sort`	`str

`pause_test_suite_run`#

Pause a running test suite run.

Parameter	Type
`test_suite_run_id`	`str`
`mode`	`Literal['graceful', 'immediate']`
`reason`	`str

`remove_all_connected_environment_code_files`#

Remove all code files from a connected environment.

Parameter	Type
`connected_environment_id`	`str`

`remove_all_connected_environment_metadata_files`#

Remove all metadata files from a connected environment.

Parameter	Type
`connected_environment_id`	`str`

`remove_all_environment_files`#

Remove all environment files.

Parameter	Type
`environment_id`	`str`

`remove_all_hypermind_code_block_files`#

Remove all code files from a hypermind code block.

Parameter	Type
`code_block_id`	`str`

`remove_all_test_data_files`#

Remove all test data files.

Parameter	Type
`test_data_id`	`str`

`remove_connected_environment_code_file`#

Remove a code file from a connected environment.

Parameter	Type
`connected_environment_id`	`str`
`file_name`	`str`

`remove_connected_environment_metadata_file`#

Remove a metadata file from a connected environment.

Parameter	Type
`connected_environment_id`	`str`
`file_name`	`str`

`remove_environment_file`#

Remove a environment file.

file_path may be the stored file name, the original upload name, or a local path to the originally uploaded file.

Parameter	Type
`environment_id`	`str`
`file_path`	`str`

`remove_hypermind_code_block_file`#

Remove a code file from a hypermind code block.

Parameter	Type
`code_block_id`	`str`
`file_path`	`str`

`remove_notification_config`#

Remove a configuration from a notification channel.

Args: channel_id_or_name: ID or name of the notification channel config_type: Type of configuration to remove (‘webhook’ or ‘slack’)

Returns: JSON string with updated channel details

Parameter	Type
`channel_id_or_name`	`str`
`config_type`	`str`

`remove_test_data_file`#

Remove a test data file.

file_path may be the stored file name, the original upload name, or a local path to the originally uploaded file.

Parameter	Type
`test_data_id`	`str`
`file_path`	`str`

`resume_test_suite_run`#

Resume a paused test suite run.

Parameter	Type
`test_suite_run_id`	`str`

`run_adversary_simulation`#

Start an adversarial simulation run (creates a pathways group).

Parameter	Type
`agent_id`	`str`
`pathway_ids`	`list[str]`
`name`	`str
`agent_name`	`str
`run_as_profile`	`str

`run_test`#

Execute tests and start a test run group.

Parameter	Type
`name`	`str`
`test_ids`	`list[str]`
`environment`	`str
`tags`	`list[str]
`notification_channels`	`list[str]

`update_connected_environment`#

Update a connected environment.

Parameter	Type
`connected_env_id`	`str`
`name`	`str
`connection`	`str
`tags`	`list[str]
`metadata`	`dict[str, Any]

`update_environment`#

Update an environment by its 15-character ID or exact name.

At least one field must be provided. device_type controls which fields are allowed / shown:

‘browser’: supporting_data_files, connected_environments, email_manager (do not pass mobile_supporting_data_file or mobile_device)
‘mobile-android’/’mobile-ios’: mobile_supporting_data_file, mobile_device (do not pass supporting_data_files or connected_environments)

mobile_device is a device_pool ID or device_name (use list_device_pool to discover). data_content is a JSON object (or JSON string) in the format: {“items”: [{“key”: “name”, “value”: “val”, “type”: “variable|secret”}]} agent_grounding_prompt is a JSON object with ‘test_creation’ and/or ‘test_execution’ string keys; keys not provided keep their current value.

Parameter	Type
`environment_id`	`str`
`name`	`str
`device_type`	`Literal[‘browser’, ‘mobile-android’, ‘mobile-ios’]
`data_content`	`dict[str, Any]
`tags`	`list[str]
`supporting_data_files`	`str
`mobile_supporting_data_file`	`str
`mobile_device`	`str
`connected_environments`	`list[str]
`email_manager`	`list[str]
`source_code_integrations`	`list[str]
`agent_grounding_prompt`	`dict[str, Any]

`update_extension`#

Update an extension.

Parameter	Type
`extension_id`	`str`
`name`	`str
`data_content`	`str
`submit`	`bool
`metadata`	`dict[str, Any]

`update_hypermind_code_block`#

Update a hypermind code block.

Parameter	Type
`code_block_id`	`str`
`name`	`str
`status`	`Literal[‘draft’, ‘ready’, ‘deleted’]
`tags`	`list[str]

`update_knowledge_base`#

Update a knowledge base.

Parameter	Type
`knowledge_base_id`	`str`
`name`	`str
`source`	`str
`description`	`str
`status`	`Literal[‘draft’, ‘ready’, ‘deleted’]

`update_notification_channel`#

Update an existing notification channel.

Args: channel_id_or_name: ID or name of the notification channel to update name: New name for the channel emails: List of email addresses webhooks: List of webhook URLs is_active: Set as active/inactive is_default: Set as default/non-default

Returns: JSON string with updated channel details

Parameter	Type
`channel_id_or_name`	`str`
`name`	`str
`emails`	`list[str]
`webhooks`	`list[str]
`is_active`	`bool
`is_default`	`bool

`update_tag`#

Update a tag’s name and/or value by its 15-character ID or exact name.

At least one of name or value must be provided. Pass value=”” to clear the value.

Parameter	Type
`tag_id`	`str`
`name`	`str
`value`	`str

`update_test`#

Update an existing test in TestZeus.

When testing_type is set to ‘mobile’, an environment reference is required.

Parameter	Type
`test_id_or_name`	`str`
`name`	`str
`test_feature`	`str
`testing_type`	`Literal[‘web’, ‘mobile’]
`status`	`str
`test_data`	`list[str]
`tags`	`list[str]
`environment`	`str
`test_params`	`dict[str, Any]
`output_schema`	`dict[str, Any]
`execution_mode`	`Literal[‘lenient’, ‘strict’]

`update_test_data`#

Update a test data record by its 15-character ID or exact name.

At least one field must be provided. content is a JSON object (or JSON string) in the format: {“items”: [{“key”: “name”, “value”: “val”, “type”: “variable|secret”}]} tags must be names of existing tags, or tag IDs. agent_grounding_prompt is a JSON object with ‘test_creation’ and/or ‘test_execution’ string keys; keys not provided keep their current value.

Parameter	Type
`test_data_id`	`str`
`name`	`str
`content`	`dict[str, Any]
`tags`	`list[str]
`supporting_data_files`	`str
`agent_grounding_prompt`	`dict[str, Any]

`update_test_report_schedule`#

Update an existing test report schedule.

Args: schedule_id_or_name: ID or name of the test report schedule to update name: New name for the schedule is_active: Set as active/inactive filter_name_pattern: Filter using TestRun name pattern filter_time_intervals: Filter using time intervals (mutually exclusive with cron_expression) cron_expression: Cron expression (mutually exclusive with filter_time_intervals) filter_tags: Filter using tag names (mutually exclusive with filter_tag_pattern) filter_tag_pattern: Filter using tag pattern (mutually exclusive with filter_tags) filter_env: Filter using environment names (mutually exclusive with filter_env_pattern) filter_env_pattern: Filter using environment pattern (mutually exclusive with filter_env) filter_test_data: Filter using test data names (mutually exclusive with filter_test_data_pattern) filter_test_data_pattern: Filter test data pattern (mutually exclusive with filter_test_data) notification_channels: List of notification channel names

Returns: JSON string with updated schedule details

Parameter	Type
`schedule_id_or_name`	`str`
`name`	`str
`is_active`	`bool
`filter_name_pattern`	`str
`filter_time_intervals`	`dict[str, str]
`cron_expression`	`str
`filter_tags`	`list[str]
`filter_tag_pattern`	`str
`filter_env`	`list[str]
`filter_env_pattern`	`str
`filter_test_data`	`list[str]
`filter_test_data_pattern`	`str
`notification_channels`	`list[str]

`update_test_suite`#

Update an existing test suite.

Parameter	Type
`test_suite_id_or_name`	`str`
`name`	`str
`workflow_definition`	`dict[str, Any]
`default_inputs`	`dict[str, Any]
`input_schema`	`list[dict[str, Any]]
`status`	`str
`execution_mode`	`Literal[‘lenient’, ‘strict’]
`environment`	`str
`tags`	`list[str]
`notification_channels`	`list[str]

`update_test_suite_schedule`#

Update a test suite schedule.

Parameter	Type
`schedule_id`	`str`
`name`	`str
`test_suite`	`str
`cron_expression`	`str
`environment`	`str
`is_active`	`bool
`notification_channels`	`list[str]
`display_name`	`str
`input_values`	`dict[str, Any]

MCP Tools#

Add the MCP server#

Or in Claude Code — one command#

Example — ask in plain language#

add_connected_environment_code_file#

add_connected_environment_metadata_file#

add_environment_file#

add_hypermind_code_block_file#

add_test_data_file#

cancel_adversary_run#

cancel_test_run_group#

cancel_test_suite_run#

create_connected_environment#

create_environment#

create_extension#

create_hypermind_code_block#

create_knowledge_base#

create_notification_channel#

create_tags#

create_test#

create_test_data#

create_test_report_schedule#

create_test_run_group#

create_test_suite#

create_test_suite_run#

create_test_suite_schedule#

delete_connected_environment#

delete_environment#

delete_extension#

delete_hypermind_code_block#

delete_knowledge_base#

delete_notification_channel#

delete_tag#

delete_test#

delete_test_data#

delete_test_report_run#

delete_test_report_schedule#

delete_test_run#

delete_test_run_group#

delete_test_suite#

delete_test_suite_schedule#

download_test_report#

download_test_run_group_attachments#

download_test_run_group_report#

generate_adversary_pathways#

generate_test#

get_adversary_agent#

get_adversary_run_status#

get_connected_environment#

get_dependent_test_suites#

get_device_pool_entry#

get_environment#

get_extension#

get_hypermind_code_block#

get_knowledge_base#

get_notification_channel#

get_salesforce_run_as_profiles#

get_tag#

get_test#

get_test_data#

get_test_input_params#

get_test_report_run#

get_test_report_schedule#

get_test_run#

get_test_run_group#

get_test_suite#

get_test_suite_node_run#

get_test_suite_run#

get_test_suite_schedule#

get_user_integration#

list_adversary_agents#

list_adversary_pathways#

list_connected_environments#

list_device_pool#

list_environments#

list_extensions#

list_hypermind_code_blocks#

list_knowledge_bases#

list_notification_channels#

list_tags#