Lucius MCP

Permanently delete all archived/deleted test cases in the current project. Args: confirm: Must be set to True to proceed. project_id: Optional Allure TestOps project ID override. output_format: Output format: 'json' (default) or 'plain'.

Delete a custom field value. ⚠️ CAUTION: Destructive. Args: cfv_id: Custom field value ID to delete. custom_field_id: Project-scoped custom field ID (optional, resolves by name if missing). custom_field_name: Custom field name to resolve when custom_field_id is not provided. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with deletion. This is a safety measure to prevent accidental deletions. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation message.

Delete a defect. Args: defect_id: The defect to delete. Raises: AllureNotFoundError: If the defect does not exist.

Delete a defect matcher. Args: matcher_id: The matcher to delete. Raises: AllureNotFoundError: If the matcher does not exist.

Delete a launch by ID with idempotent behavior.

Delete (archive) a shared step with idempotent behavior. Args: step_id: The shared step ID to delete. Returns: The archive outcome, including whether an archived entity was confirmed to exist for safe URL rendering. Raises: AllureAPIError: If the API request fails (other than 404). Note: This operation is idempotent following Story 1.5 pattern. A 404 is reported as ``not_found`` so callers do not link to a deleted entity.

Archive an obsolete test case. ⚠️ CAUTION: Destructive. This performs a SOFT DELETE (archive). The test case can typically be recovered from the Allure UI if needed. ⚠️ CAUTION: This action removes the test case from active views. Historical data and launch associations may be affected. Args: test_case_id: The Allure test case ID to archive. Found in the URL: /testcase/12345 -> test_case_id=12345 confirm: Must be set to True to proceed with deletion. This is a safety measure to prevent accidental deletions. project_id: Optional Allure TestOps project ID override.…

Delete a test layer from Allure TestOps. ⚠️ CAUTION: Destructive. Args: layer_id: ID of the test layer to delete. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with deletion. This is a safety measure to prevent accidental deletions. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation message.

Delete a test layer schema from the project. ⚠️ CAUTION: Destructive. Args: schema_id: ID of the schema to delete. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with deletion. This is a safety measure to prevent accidental deletions. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation message.

Delete a Test Plan. ⚠️ CAUTION: Destructive. Permanently removes the Test Plan from Allure TestOps. The operation is idempotent: if the plan does not exist, it returns success. Args: plan_id: The numeric ID of the Test Plan to delete. confirm: Must be set to True to proceed with deletion. output_format: Output format: 'json' (default) or 'plain'. Returns: A formatted success message or a warning if confirmation is missing.

Delete a test suite node from hierarchy. ⚠️ CAUTION: Destructive. This operation removes a hierarchy suite/group node. Allure TestOps handles nested entities according to its API behavior for tree groups. Args: suite_id: Existing suite (tree node) ID to delete. tree_id: Optional hierarchy tree containing the suite. confirm: Must be set to True to proceed. This safety flag prevents accidental destructive actions. project_id: Optional Allure TestOps project override. output_format: Output format: 'json' (default) or 'plain'. Returns: A confirmation or safety wa…

Delete custom fields that are unused by any test case in the current project. Args: confirm: Must be set to True to proceed. project_id: Optional Allure TestOps project ID override. output_format: Output format: 'json' (default) or 'plain'.

Get available custom fields and their allowed values for the project. Use this tool to discover what custom fields are available (e.g., 'Layer', 'Priority') and what values are valid for them (e.g., 'UI', 'High'). This is essential before creating or updating test cases to ensure you use valid field names and values. Args: name: Optional name filter to find a specific field (case-insensitive). project_id: Optional project ID override. output_format: Output format: 'json' (default) or 'plain'. Returns: A list of custom fields with their required status and allowed values.

Get defect details by ID. Args: defect_id: ID of the defect. Returns: DefectOverviewDto details. Raises: AllureNotFoundError: If defect not found.

Retrieve a specific launch by its ID. Args: launch_id: The unique ID of the launch. Returns: The launch data.

Retrieve one project by name or list accessible projects. Name matching is case-insensitive. An exact match is preferred; an unambiguous partial match is accepted. Omit ``name`` to discover the available project IDs and names before making project-scoped calls. Args: name: Exact or unique partial project name. Omit to list projects. output_format: Output format: 'json' (default) or 'plain'. Returns: A project record with its ID and details, or a concise list of project IDs and names when no name is supplied.

Retrieve custom field values for a specific test case. Args: test_case_id: The ID of the test case. project_id: Optional project ID override. output_format: Output format: 'json' (default) or 'plain'. Returns: A dictionary where keys are custom field names and values are either a single string value or a list of string values.

Get complete details of a specific test case. Retrieves all information about a test case including its steps, tags, custom fields, and attachments. For each attachment, call prepare_attachment_download with its attachment_id, attachment_kind, and test_case_id, then HTTP GET the returned Lucius URL. Use this before updating a test case to understand its current state. Args: test_case_id: The unique ID of the test case to retrieve. project_id: Optional override for the default Project ID. output_format: Output format: 'json' (default) or 'plain'. Returns: Formatted test case …

Retrieve one complete TestOps result without recursively reading related results. Attachment references identify their verified owner. Call prepare_attachment_download with an attachment's attachment_id, attachment_kind, and owner context, then HTTP GET the returned Lucius URL before it expires. Args: test_result_id: Exact TestOps result ID matching ``/api/testresult/{id}``. Ignore a ``treeId`` URL query parameter. project_id: Optional project override. output_format: Structured JSON (default) or plain agent-readable detail. Returns: Curated result detail, typed atta…

Get test cases directly assigned to one test suite. This is a targeted hierarchy read. It does not enumerate unrelated suites or recursively traverse the project tree. Args: suite_id: Existing suite/group node ID to inspect. project_id: Optional Allure TestOps project override. tree_id: Optional hierarchy tree containing the suite. expected_suite_name: Optional exact name of the target suite. Supply it when available to avoid reading a missing node after an asynchronous deletion. output_format: Output format: 'json' (default) or 'plain'. Returns: The suite ID…

Link defect and test case through a shared issue mapping. Args: defect_id: Defect ID. test_case_id: Test case ID. issue_key: Issue key to map (for example, PROJ-123). If omitted, an existing issue mapping from the defect is reused. integration_id: Optional explicit integration ID. integration_name: Optional explicit integration name. Returns: DefectTestCaseLinkResult with mapping details and idempotency state. Raises: AllureValidationError: For invalid input or missing issue mapping. AllureNotFoundError: If defect/test case is not found.

Link a shared step to a test case. ⚠️ CAUTION: Destructive. Adds a reference to the shared step in the test case's step list. The shared step's actions will expand at execution time. Args: test_case_id: The ID of test case to modify. Found in URL: /testcase/12345 shared_step_id: The ID of shared step to link. Found via list_shared_steps or in Allure UI. position: Where to insert the shared step (0-indexed, optional). - 0 = Insert at beginning - None = Append to end (default) - N = Insert after step N (so it becomes the (N+1)th step) pro…

List available values for a custom field. Args: custom_field_id: Project-scoped custom field ID to list values for. custom_field_name: Custom field name to resolve when custom_field_id is not provided. query: Optional search query to filter values. var_global: Optional filter for global values. test_case_search: Optional test case search filter to match values in test cases. page: Zero-based page index. size: Number of items per page. sort: Optional sort criteria, e.g. ["name,asc", "id,desc"]. project_id: Optional override for the default Project ID. ou…

List all matchers for a given defect. Args: defect_id: The parent defect ID. Returns: List of DefectMatcherDto objects.

List test cases linked to a defect. Args: defect_id: Defect ID. page: Zero-based page index. size: Page size (1..100). Returns: DefectTestCaseListResult with pagination metadata.

List all defects in the configured project. Returns: List of DefectCountRowDto objects.

List available integrations (issue trackers) in Allure TestOps. Use this tool to discover which integrations (Jira, GitHub, etc.) are configured and available for linking issues to test cases. Args: project_id: Optional override for the default Project ID. When provided (or from environment default), integrations are filtered to those available for that project. output_format: Output format: 'json' (default) or 'plain'. Returns: A formatted list of available integrations with their IDs and names. If no integrations are configured, returns an informative messa…

List launch test results with optional manual/status filtering.

List launches for the configured project. Args: page: Zero-based page index. size: Page size. search: Optional name search. filter_id: Optional filter ID. sort: Optional sort criteria. Returns: LaunchListResult with items and pagination metadata.

List shared steps for a project. Args: page: Page number (0-based). size: Page size. search: Optional search query. archived: Optional archived status filter. Returns: List of SharedStepDto.

List all test cases in a project. Returns a paginated list of test cases with their IDs, names, and tags. Use this to review existing test documentation in a project. Args: page: Page number for pagination (0-indexed). Default: 0. size: Number of results per page (max 100). Default: 20. name_filter: Optional filter to search by name or description. tags: Optional list of tag names to filter by (exact match). status: Optional test case status name to filter by (exact match). project_id: Optional override for the default Project ID. output_format: Output format: 'js…

List test layer schemas for a project. Test layer schemas map custom field keys to test layers within a project. They determine which test layer is assigned when a specific custom field value is used. Args: project_id: Optional project ID override page: Page number (0-based) size: Page size (max 100) output_format: Output format: 'json' (default) or 'plain'. Returns: List of test layer schemas with their IDs, keys, and linked test layers

List test layers to discover available test layer taxonomy. Test layers define the taxonomy for categorizing test cases (e.g., Unit, Integration, E2E). Use this to find layer IDs and names before creating or updating test cases. Args: page: Page number (0-based) size: Page size (max 100) output_format: Output format: 'json' (default) or 'plain'. Returns: List of test layers with their IDs and names

List Test Plans for the current project. Retrieves a paginated list of Test Plans, showing their IDs, names, and the number of test cases they contain. Args: page: The page number to retrieve (0-based index). Defaults to 0. size: The number of items per page. Defaults to 100. output_format: Output format: 'json' (default) or 'plain'. Returns: A formatted string listing the Test Plans found, or a message indicating no plans were found.

List hierarchy suites for a project tree. Args: project_id: Optional project override. If omitted, use default project from environment. tree_id: Optional hierarchy tree ID. If omitted, the default project tree is used. include_empty: Whether to include suites without nested child suites. output_format: Output format: 'json' (default) or 'plain'. Returns: Hierarchical text output with tree info and suite nodes.

Modify the content (Test Cases) of an existing Test Plan. Allows adding or removing specific Test Cases by ID, or updating the underlying AQL filter query. Args: plan_id: The numeric ID of the Test Plan to modify. add_test_case_ids: List of Test Case IDs to add to the plan. remove_test_case_ids: List of Test Case IDs to remove from the plan. update_aql_filter: New AQL query string to replace the existing one. Use this to change the dynamic criteria for test case selection. output_format: Output format: 'json' (default) or 'plain'. Returns: A success message c…

Prepare one verified attachment download, then HTTP GET its returned Lucius URL. Call this after get_test_result or get_test_case_details provides an attachment ID, kind, and owner context. The returned download URL is one-time and short-lived: HTTP GET it before expires_at without an Allure bearer token. Prepare again if the URL expires or was already retrieved. Args: attachment_id: Attachment ID discovered from a readable result or test case. attachment_kind: Verified attachment kind: test_result, fixture_result, or test_case. test_result_id: Required owner ID for test_result o…

Reopen a launch and return updated launch details.

Schedule manual reruns for selected launch test results.

Start a launch from an existing Test Plan. Runs the selected test plan by its ID and returns the created launch as a compact mutation summary enriched with the source plan context. Starting a launch is reversible: use delete_launch to remove it when unwanted. Args: plan_id: The numeric ID of the Test Plan to run. launch_name: Name for the launch created from the plan (1-255 characters). issues: Optional list of issue dictionaries. links: Optional list of external link dictionaries. tags: Optional list of launch tags. output_format: Output format: 'json' (default) or '…

Search for test cases by name, tag, or AQL query. Find test cases matching your search criteria. Supports simple name/tag search or advanced AQL (Allure Query Language) for complex filtering. Simple Query Syntax (use 'query' parameter): - Plain text: Searches in test case names (case-insensitive) - tag:value: Filters by exact tag match - Combined: "login tag:smoke" finds test cases with "login" in name AND "smoke" tag Important: see https://docs.qameta.io/allure-testops/advanced/aql/ for the full AQL syntax reference. AQL Syntax (use 'aql' parameter): - Operators: and, or, not - Precedence:…

Start a manual test session for a launch.

Submit manual execution payloads to existing or explicit launch contexts. When ``results[*].result_id`` is provided, the existing launch result is resolved in place via the test-result run controller. When explicit ``launch_id`` and ``test_case_id`` are provided without ``result_id``, the legacy create-new-result flow is used as a fallback.

Unlink an issue from a test case. Args: test_case_id: ID of the target test case. issue_id: Issue key or Allure internal issue-link ID. Returns: True if the issue was already absent; otherwise False. Raises: AllureValidationError: If the supplied IDs are invalid. TestCaseNotFoundError: If the test case does not exist.

Remove a shared step reference from a test case. ⚠️ CAUTION: Destructive. Removes the link to the shared step. The test case will no longer include those steps at execution time. Args: test_case_id: The test case to modify. shared_step_id: The shared step to unlink. project_id: Optional override for the default Project ID. confirm: Must be set to True to proceed with unlinking. This is a safety measure to prevent accidental unlinking. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation with updated step list. Note: This only remo…

Update an existing custom field value. ⚠️ CAUTION: Destructive. Args: cfv_id: Custom field value ID to update. name: New name for the custom field value. custom_field_id: Project-scoped custom field ID (optional, resolves by name if missing). custom_field_name: Custom field name to resolve when custom_field_id is not provided. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with update. This is a safety measure to prevent accidental updates. output_format: Output format: 'json' (default) or 'plain'. Returns:…

Update a defect. Args: defect_id: Defect to update. name: New name (optional). description: New description (optional). closed: New status (True for closed, False for open). Returns: Updated DefectOverviewDto. Raises: AllureNotFoundError: If the defect does not exist. AllureValidationError: If no fields are provided.

Update a defect matcher. Args: matcher_id: The matcher to update. name: New name (optional). message_regex: New message regex (optional). trace_regex: New trace regex (optional). Returns: Updated DefectMatcherDto. Raises: AllureNotFoundError: If the matcher does not exist. AllureValidationError: If no fields are provided.

Update an existing shared step with idempotency support. Only provided fields are updated. Repeated calls with same data are idempotent. Args: step_id: The shared step ID to update. name: New name for the shared step (optional). description: New description (optional). Returns: Tuple of (updated_shared_step, changed) where changed is True if update was applied. Raises: AllureNotFoundError: If shared step doesn't exist. AllureValidationError: If validation fails. AllureAPIError: If the server returns an error.

Update an existing test case in Allure TestOps. ⚠️ CAUTION: Destructive. Performs a partial update: only supplied fields are sent to the API. When provided, ``steps`` replace all existing steps, and ``attachments`` replace all existing global attachments. Omit a field to preserve its current value. Args: test_case_id: The ID of the test case to update. name: New name for the test case. description: New description for the test case. precondition: New precondition text. steps: New list of steps. Each step is a dict with ``action``, ``expected``, and optional ``atta…

Update an existing test layer's name. ⚠️ CAUTION: Destructive. Args: layer_id: ID of the test layer to update. name: New name for the test layer. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with update. This is a safety measure to prevent accidental updates. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation message indicating whether changes were made.

Update an existing test layer schema. ⚠️ CAUTION: Destructive. Args: schema_id: ID of the schema to update. test_layer_id: Optional new test layer ID to link to. key: Optional new schema key. project_id: Optional Allure TestOps project ID override. confirm: Must be set to True to proceed with update. This is a safety measure to prevent accidental updates. output_format: Output format: 'json' (default) or 'plain'. Returns: Confirmation message indicating whether changes were made.

Update the metadata of an existing Test Plan. Currently, supports updating the name of the plan. Args: plan_id: The numeric ID of the Test Plan to update. name: The new name for the Test Plan. output_format: Output format: 'json' (default) or 'plain'. Returns: A success message confirming the update with the Plan ID and new Name.

Upload external test results to an existing launch. Args: launch_id: Launch ID that receives all submitted results. results: Objects with required `test_case_id` and `status`; timestamps, duration, and a message are optional. project_id: Optional override for the default Project ID. output_format: Output format: 'json' (default) or 'plain'. Returns: A concise upload summary, including any rejected result indexes.