BugBug

Delete a group by its ID # User confirmation Rules: - Always ask for user confirmation before performing any destrucive actions, such as deleting a step or a test case, or making significant changes to existing steps or test cases. - When asking for user confirmation, provide clear and concise information about the action being performed, including the type of change (e.g., creating a new step, updating an existing step, deleting a step) and the specific details of the change (e.g., step type, selector presets, values), so that the user can make an informed decision about whether to proceed with the action or not.

bugbug_delete_group

Delete a test by its ID # User confirmation Rules: - Always ask for user confirmation before performing any destrucive actions, such as deleting a step or a test case, or making significant changes to existing steps or test cases. - When asking for user confirmation, provide clear and concise information about the action being performed, including the type of change (e.g., creating a new step, updating an existing step, deleting a step) and the specific details of the change (e.g., step type, selector presets, values), so that the user can make an informed decision about whether to proceed with the action or not.

bugbug_delete_test

Delete a suite by ID. This does not delete the tests themselves, but it removes the suite organization. # User confirmation Rules: - Always ask for user confirmation before performing any destrucive actions, such as deleting a step or a test case, or making significant changes to existing steps or test cases. - When asking for user confirmation, provide clear and concise information about the action being performed, including the type of change (e.g., creating a new step, updating an existing step, deleting a step) and the specific details of the change (e.g., step type, selector presets, values), so that the user can make an informed decision about whether to proceed with the action or not.

bugbug_delete_suite

Delete a tag project-wide, removing its assignments from tests, suites, and historical runs. Requires explicit user intent. To unassign from one target, use the matching set-tags tool instead.

bugbug_delete_tag

Delete emails from a test run inbox. With `messageId` deletes only that message; without it clears the whole inbox. # User confirmation Rules: - Always ask for user confirmation before performing any destrucive actions, such as deleting a step or a test case, or making significant changes to existing steps or test cases. - When asking for user confirmation, provide clear and concise information about the action being performed, including the type of change (e.g., creating a new step, updating an existing step, deleting a step) and the specific details of the change (e.g., step type, selector presets, values), so that the user can make an informed decision about whether to proceed with the action or not.

bugbug_delete_test_run_inbox_messages

Deletes a visual regression reference screenshot by ID. # User confirmation Rules: - Always ask for user confirmation before performing any destrucive actions, such as deleting a step or a test case, or making significant changes to existing steps or test cases. - When asking for user confirmation, provide clear and concise information about the action being performed, including the type of change (e.g., creating a new step, updating an existing step, deleting a step) and the specific details of the change (e.g., step type, selector presets, values), so that the user can make an informed decision about whether to proceed with the action or not.

bugbug_delete_visual_regression_reference_screenshot

Read the current project settings grouped by area (profiles, browser, selectors, waiting conditions, logs, timeouts). Use before authoring or repairing tests to understand how selectors are generated and how the project waits and times out.

bugbug_get_project_settings

Get a project tag by UUID, including its name and color. Use bugbug_list_tags for discovery and usage counts.

bugbug_get_tag

Returns how many tests reference a component plus their IDs. Use before deleting or unlinking a component to understand the blast radius.

bugbug_get_component_usage

Get detailed results of a BugBug suite run

bugbug_get_suite_run

Get detailed results of a test run

bugbug_get_test_run

Get detailed information about a specific group or component by ID, including usage information

bugbug_get_group

Get details of a specific BugBug run profile

bugbug_get_profile

Get detailed information about a specific step by ID, with capability to choose which fields to return

bugbug_get_step

Get details of a specific BugBug test

bugbug_get_test

Get details of a specific BugBug test suite

bugbug_get_suite

Get failure-focused details for a step run, including step name/type, selectorsPresets, error data, screenshots (window, covering-element, and visual-regression expected/observed/diff), and expected/observed assertion or visual regression values.

bugbug_get_failed_step_run_details

Get list of BugBug groups and components with optional search and pagination

bugbug_list_groups

Get list of BugBug run profiles

bugbug_list_profiles

Get compact suite-run summaries, optionally filtered by suite and status. Use bugbug_get_suite_run with a returned ID for test-run details.

bugbug_list_suite_runs

Get list of BugBug test suites

bugbug_list_suites

Search and page through tests in the authenticated BugBug project to resolve a test name to an ID before reading, updating, running, exporting, or deleting a test.

bugbug_list_tests

Get list of BugBug variables

bugbug_get_variables_list

Get compact historical test-run summaries. Use bugbug_get_test_run with a returned ID for step-level details.

bugbug_list_test_runs

Read emails received by a test run inbox (the {{testRunId}} inbox variable). Without `messageId` it lists messages (filterable); with `messageId` it returns one message including its HTML body.

bugbug_get_test_run_inbox

Import a test from YAML (raw text) or ZIP (base64-encoded). Returns the created test.

bugbug_import_test

Link a reusable component to a test at an optional position.

bugbug_insert_component_into_test

Link a group to a test at an optional position. For reusable components, use bugbug_insert_component_into_test.

bugbug_insert_group_in_test

Get list of reusable BugBug components with optional search and pagination

bugbug_list_components

Return the full folder tree for tests or components, flattened with slash-separated paths and IDs. Use it to resolve a folder path to an ID before creating, moving, or filtering tests and components.

bugbug_list_folders

List tags in a BugBug project, including colors and usage counts. Check this list before creating tags so you can reuse an existing tag.

bugbug_list_tags

Lists available BugBug projects.

bugbug_list_projects

Returns a paginated list of visual regression reference screenshots for a step.

bugbug_list_visual_regression_reference_screenshots

Move an existing group or component to a new zero-based position within a test, shifting the other groups. Read the current test structure first.

bugbug_update_group_position

Move an existing step to a new zero-based position within a test, optionally into another test group or an if-condition block. Read the current test structure first.

bugbug_update_step_position

Move up to 25 tests or components into one folder, or to the root with folderId: null. Pass either testIds (for a test folder) or componentIds (for a component folder), not both. Returns moved items and indexed failures.

bugbug_move_to_folder

Partially update a test. Only provided fields will be updated.

bugbug_patch_test

Load a dom_snapshot debug artifact with jsdom and query one element by CSS selector or XPath. Returns the matching HTML subtree when found.

bugbug_query_dom_snapshot_element

Rename a folder and/or move it under another parent folder of the same kind. Pass parentId: null to move it to the root. A folder cannot be moved into its own subtree.

bugbug_update_folder

Resolves failed visual regression checks. Set solutionType to "acceptBaseline" to accept the observed screenshot as the new reference, or to "increaseMaxDifference" to raise the step's allowed difference to just above the observed value. The value is computed server-side. Provide exactly one of stepRunId or testRunId.

bugbug_resolve_visual_regression_review