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": "[email protected]",
"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=[email protected] \
-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 |
|---|---|
|
|
|
|
add_connected_environment_metadata_file#
Add a metadata file to a connected environment.
Parameter |
Type |
|---|---|
|
|
|
|
add_environment_file#
Add a environment file.
Parameter |
Type |
|---|---|
|
|
|
|
add_hypermind_code_block_file#
Add a code file to a hypermind code block.
Parameter |
Type |
|---|---|
|
|
|
|
add_test_data_file#
Add a test data file.
Parameter |
Type |
|---|---|
|
|
|
|
cancel_adversary_run#
Cancel a running adversarial simulation group.
Parameter |
Type |
|---|---|
|
|
cancel_test_run_group#
Cancel all running test runs in a test run group.
Parameter |
Type |
|---|---|
|
|
cancel_test_suite_run#
Cancel a running test suite run.
Parameter |
Type |
|---|---|
|
|
create_connected_environment#
Create a new connected environment.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`list[str] |
|
`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 |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`list[str] |
|
`str |
|
`str |
|
`str |
|
`list[str] |
|
`list[str] |
|
`list[str] |
|
`dict[str, Any] |
create_extension#
Create a new extension.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
|
|
`dict[str, Any] |
create_hypermind_code_block#
Create a new hypermind code block.
Parameter |
Type |
|---|---|
|
|
|
|
|
`list[str] |
create_knowledge_base#
Create a new knowledge base.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
|
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 |
|---|---|
|
|
|
|
|
`list[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 |
|---|---|
|
|
|
|
|
|
|
|
|
`list[str] |
|
`list[str] |
|
`str |
|
`dict[str, Any] |
|
`dict[str, Any] |
|
|
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 |
|---|---|
|
|
|
`dict[str, Any] |
|
`list[str] |
|
`str |
|
`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 |
|---|---|
|
|
|
|
|
`str |
|
`dict[str, str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
create_test_run_group#
Create and execute a new test runs in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
`list[str] |
|
`str |
|
`list[str] |
|
`list[str] |
create_test_suite#
Create a new test suite.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`list[dict[str, Any]] |
|
|
|
|
|
`str |
|
`list[str] |
|
`list[str] |
create_test_suite_run#
Create a new test suite run in lenient mode.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
|
`list[str] |
create_test_suite_schedule#
Create a new test suite schedule (cron-based).
Parameter |
Type |
|---|---|
|
|
|
|
|
|
|
`str |
|
|
|
`list[str] |
|
`str |
|
`dict[str, Any] |
delete_connected_environment#
Delete a connected environment.
Parameter |
Type |
|---|---|
|
|
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 |
|---|---|
|
|
delete_extension#
Delete an extension.
Parameter |
Type |
|---|---|
|
|
delete_hypermind_code_block#
Delete a hypermind code block.
Parameter |
Type |
|---|---|
|
|
delete_knowledge_base#
Delete a knowledge base.
Parameter |
Type |
|---|---|
|
|
delete_notification_channel#
Delete a notification channel.
Parameter |
Type |
|---|---|
|
|
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 |
|---|---|
|
|
delete_test#
Delete a test (sets status to deleted).
Parameter |
Type |
|---|---|
|
|
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 |
|---|---|
|
|
delete_test_report_run#
Delete a test report run.
Parameter |
Type |
|---|---|
|
|
delete_test_report_schedule#
Delete a test report schedule (sets status to deleted).
Parameter |
Type |
|---|---|
|
|
delete_test_run#
Delete a test run.
Parameter |
Type |
|---|---|
|
|
delete_test_run_group#
Delete a test run group (sets status to deleted).
Parameter |
Type |
|---|---|
|
|
delete_test_suite#
Delete a test suite.
Parameter |
Type |
|---|---|
|
|
delete_test_suite_schedule#
Delete a test suite schedule.
Parameter |
Type |
|---|---|
|
|
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 |
|---|---|
|
|
|
|
|
|
download_test_run_group_attachments#
Download all attachments for all test runs in a test run group.
Parameter |
Type |
|---|---|
|
|
|
|
download_test_run_group_report#
Download the report for a test run group.
Parameter |
Type |
|---|---|
|
|
|
|
|
|
generate_adversary_pathways#
Start an AI pathway-generation job for a Salesforce agent profile.
Parameter |
Type |
|---|---|
|
|
|
|
|
`str |
|
`str |
|
`int |
|
|
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 |
|---|---|
|
|
|
`str |
|
`str |
|
`list[str] |
|
`int |
|
|
|
|
get_adversary_agent#
Get details for a single Agent Harness agent by ID.
Parameter |
Type |
|---|---|
|
|
get_adversary_run_status#
Get status and results for an adversarial simulation run group.
Parameter |
Type |
|---|---|
|
|
get_connected_environment#
Get a specific connected environment by ID or name.
Parameter |
Type |
|---|---|
|
|
get_dependent_test_suites#
Get test suites that reference a test.
Parameter |
Type |
|---|---|
|
|
get_device_pool_entry#
Get a specific device from the pool by ID.
Parameter |
Type |
|---|---|
|
|
get_environment#
Get a specific environment by ID or name.
Parameter |
Type |
|---|---|
|
|
get_extension#
Get a specific extension by ID or name.
Parameter |
Type |
|---|---|
|
|
get_hypermind_code_block#
Get a specific hypermind code block by ID or name.
Parameter |
Type |
|---|---|
|
|
get_knowledge_base#
Get a specific knowledge base by ID or name.
Parameter |
Type |
|---|---|
|
|
get_notification_channel#
Get a specific notification channel by ID or name.
Parameter |
Type |
|---|---|
|
|
get_salesforce_run_as_profiles#
Get Salesforce user profiles for the Run-As-User (RBAC) picker.
Parameter |
Type |
|---|---|
|
|
get_tag#
Get a specific tag by its 15-character ID or exact name.
Parameter |
Type |
|---|---|
|
|
get_test#
Get a specific test by ID or name.
Parameter |
Type |
|---|---|
|
|
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 |
|---|---|
|
|
get_test_input_params#
Get merged input params and defaults for a test.
Parameter |
Type |
|---|---|
|
|
get_test_report_run#
Get a specific test report run by ID or name.
Parameter |
Type |
|---|---|
|
|
get_test_report_schedule#
Get a specific test report schedule by ID or name.
Parameter |
Type |
|---|---|
|
|
get_test_run#
Get a specific test run by ID.
Parameter |
Type |
|---|---|
|
|
get_test_run_group#
Get a specific test run group by ID or name.
Parameter |
Type |
|---|---|
|
|
get_test_suite#
Get a specific test suite by ID or name.
Parameter |
Type |
|---|---|
|
|
get_test_suite_node_run#
Get a specific test suite node run by ID.
Parameter |
Type |
|---|---|
|
|
get_test_suite_run#
Get a specific test suite run by ID.
Parameter |
Type |
|---|---|
|
|
get_test_suite_schedule#
Get a specific test suite schedule by ID or name.
Parameter |
Type |
|---|---|
|
|
get_user_integration#
Get a specific user integration by ID or name.
Parameter |
Type |
|---|---|
|
|
list_adversary_agents#
List agents available for adversarial (Agent Harness) testing.
Parameter |
Type |
|---|---|
|
|
|
|
|
`str |
|
`str |
list_adversary_pathways#
List adversarial test pathways, optionally scoped to a single agent.
Parameter |
Type |
|---|---|
|
`str |
|
|
|
|
list_connected_environments#
List all connected environments in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`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 |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`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 |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_extensions#
List all extensions in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_hypermind_code_blocks#
List all hypermind code blocks in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_knowledge_bases#
List all knowledge bases in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_notification_channels#
List all notification channels in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`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 |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_report_runs#
List all test report runs in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_report_schedules#
List all test report schedules in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_run_groups#
List all test run groups in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_runs#
List all test runs in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_suite_node_runs#
List all test suite node runs in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_suite_runs#
List all test suite runs in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_suite_schedules#
List all test suite schedules in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_test_suites#
List all test suites in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_tests#
List all tests in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
list_user_integrations#
List all user integrations in TestZeus.
Parameter |
Type |
|---|---|
|
|
|
|
|
`dict[str, Any] |
|
`str |
pause_test_suite_run#
Pause a running test suite run.
Parameter |
Type |
|---|---|
|
|
|
|
|
`str |
remove_all_connected_environment_code_files#
Remove all code files from a connected environment.
Parameter |
Type |
|---|---|
|
|
remove_all_connected_environment_metadata_files#
Remove all metadata files from a connected environment.
Parameter |
Type |
|---|---|
|
|
remove_all_environment_files#
Remove all environment files.
Parameter |
Type |
|---|---|
|
|
remove_all_hypermind_code_block_files#
Remove all code files from a hypermind code block.
Parameter |
Type |
|---|---|
|
|
remove_all_test_data_files#
Remove all test data files.
Parameter |
Type |
|---|---|
|
|
remove_connected_environment_code_file#
Remove a code file from a connected environment.
Parameter |
Type |
|---|---|
|
|
|
|
remove_connected_environment_metadata_file#
Remove a metadata file from a connected environment.
Parameter |
Type |
|---|---|
|
|
|
|
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 |
|---|---|
|
|
|
|
remove_hypermind_code_block_file#
Remove a code file from a hypermind code block.
Parameter |
Type |
|---|---|
|
|
|
|
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 |
|---|---|
|
|
|
|
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 |
|---|---|
|
|
|
|
resume_test_suite_run#
Resume a paused test suite run.
Parameter |
Type |
|---|---|
|
|
run_adversary_simulation#
Start an adversarial simulation run (creates a pathways group).
Parameter |
Type |
|---|---|
|
|
|
|
|
`str |
|
`str |
|
`str |
run_test#
Execute tests and start a test run group.
Parameter |
Type |
|---|---|
|
|
|
|
|
`str |
|
`list[str] |
|
`list[str] |
update_connected_environment#
Update a connected environment.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
`list[str] |
|
`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 |
|---|---|
|
|
|
`str |
|
`Literal[‘browser’, ‘mobile-android’, ‘mobile-ios’] |
|
`dict[str, Any] |
|
`list[str] |
|
`str |
|
`str |
|
`str |
|
`list[str] |
|
`list[str] |
|
`list[str] |
|
`dict[str, Any] |
update_extension#
Update an extension.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
`bool |
|
`dict[str, Any] |
update_hypermind_code_block#
Update a hypermind code block.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`Literal[‘draft’, ‘ready’, ‘deleted’] |
|
`list[str] |
update_knowledge_base#
Update a knowledge base.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
`str |
|
`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 |
|---|---|
|
|
|
`str |
|
`list[str] |
|
`list[str] |
|
`bool |
|
`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 |
|---|---|
|
|
|
`str |
|
`str |
update_test#
Update an existing test in TestZeus.
When testing_type is set to ‘mobile’, an environment reference is required.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
`Literal[‘web’, ‘mobile’] |
|
`str |
|
`list[str] |
|
`list[str] |
|
`str |
|
`dict[str, Any] |
|
`dict[str, Any] |
|
`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 |
|---|---|
|
|
|
`str |
|
`dict[str, Any] |
|
`list[str] |
|
`str |
|
`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 |
|---|---|
|
|
|
`str |
|
`bool |
|
`str |
|
`dict[str, str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
|
`str |
|
`list[str] |
update_test_suite#
Update an existing test suite.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`dict[str, Any] |
|
`dict[str, Any] |
|
`list[dict[str, Any]] |
|
`str |
|
`Literal[‘lenient’, ‘strict’] |
|
`str |
|
`list[str] |
|
`list[str] |
update_test_suite_schedule#
Update a test suite schedule.
Parameter |
Type |
|---|---|
|
|
|
`str |
|
`str |
|
`str |
|
`str |
|
`bool |
|
`list[str] |
|
`str |
|
`dict[str, Any] |