product: maestro audience: test-developer, operator, ai-assistant authority: normative

MCP Tools — Packages

Tools for managing test packages — the versioned bundles that contain YAML test files and runner assemblies.

All tool responses include a top-level station field containing the StationLabel configured for this server instance.

See also: tools-reference.md for the full tool index.

`list_packages`

Lists all packages in the registry with their status and lifecycle.

Parameter	Type	Required	Description
(none)

Returns: packages[] — each has name, version, status, lifecycleStatus, installedVersion

Status values: NotInstalled, Downloading, Installed, UpdateAvailable, Error

Calls: GET /api/packages

`trigger_package_refresh`

Triggers a background re-scan of the package registry to discover updates. Returns immediately; results arrive via SignalR (visible in the Packages UI page).

Parameter	Type	Required	Description
(none)

Returns: message confirming the refresh was triggered

Calls: POST /api/packages/refresh

`download_package`

Starts a background download of a named package from the registry. Returns immediately (202 Accepted). Monitor the Packages UI page for progress, or poll list_packages until status == "Installed".

Parameter	Type	Required	Description
`name`	string	Yes	Package name as shown in `list_packages`

Returns: message confirming the download was accepted

Calls: POST /api/packages/{name}/download

`activate_package`

Marks a downloaded package as active, making its test files available for execution.

Parameter	Type	Required	Description
`name`	string	Yes	Package name

Returns: message confirming activation

Calls: POST /api/packages/{name}/activate

`install_package`

Convenience tool: downloads and activates a package in a single step. Polls list_packages internally until status == "Installed" (up to 120 seconds) before calling activate.

Parameter	Type	Required	Description
`name`	string	Yes	Package name

Returns: download and activate message strings

`uninstall_package`

Deactivates and removes a package from the local cache.

Parameter	Type	Required	Description
`name`	string	Yes	Package name

Returns: message confirming removal

Calls: DELETE /api/packages/{name}

`set_package_lifecycle`

Sets the lifecycle status of a package (controls whether it is eligible for use in staging or production environments).

Parameter	Type	Required	Description
`name`	string	Yes	Package name
`lifecycleStatus`	string	Yes	One of: `NotReleased`, `Development`, `Staging`, `Production`

Returns: message confirming the change

Calls: PUT /api/packages/{name}/lifecycle

`get_available_test_files`

Lists all YAML test files available from activated packages. Identical to list_available_tests but grouped here for discoverability.

Parameter	Type	Required	Description
(none)

Returns: testFiles[] — packageName, testName, filePath, requiredTags

Calls: GET /api/packages/test-files