Metadata-Version: 2.4
Name: testops-mcp
Version: 0.4.0
Summary: Allure TestOps MCP server
License-Expression: MIT
Requires-Dist: allure-python-client>=0.1.3
Requires-Dist: fastmcp==4.2.0
Requires-Dist: python-dateutil>=2.9.0.post0
Requires-Dist: python-dotenv==1.2.4
Requires-Dist: uvicorn==0.54.0
Requires-Dist: wrapt==2.5.2
Requires-Python: ==3.13.5
Description-Content-Type: text/markdown

# testops-mcp

MCP server for TestOps over stdio.

## Claude Code

`.mcp.json`:

```json
{
  "mcpServers": {
    "testops": {
      "command": "uvx",
      "args": ["testops-mcp"],
      "env": {
        "TESTOPS_ENDPOINT": "https://allure.example.com",
        "TESTOPS_TOKEN": "...",
        "TESTOPS_CONTENT_RESPONSE_FORMAT": "yaml"
      }
    }
  }
}
```

## Codex

`~/.codex/config.toml`:

```toml
[mcp_servers.testops]
command = "uvx"
args = ["testops-mcp"]

[mcp_servers.testops.env]
TESTOPS_ENDPOINT = "https://allure.example.com"
TESTOPS_TOKEN = "..."
TESTOPS_CONTENT_RESPONSE_FORMAT = "yaml"
```

`TESTOPS_CONTENT_RESPONSE_FORMAT` is optional. The default value is `yaml`.

## Tools

### Accounts And Roles

- `testops_accounts_read` - search users by name, email, or login.
- `testops_roles_read` - list available roles.

### Project Metadata

- `testops_project_category_list` - list project categories.
- `testops_project_custom_fields_get` - list project custom fields.
- `testops_project_custom_field_values_get` - list values for a custom field.
- `testops_status_list` - list statuses for a workflow.

### Tags

- `testops_tag_create` - create a test tag.
- `testops_tag_delete` - delete a test tag.
- `testops_tag_get` - get a test tag by id.
- `testops_tag_list` - list and filter test tags.
- `testops_tag_patch` - rename a test tag.

### Test Cases

- `testops_testcase_create` - create a test case.
- `testops_testcase_delete` - delete a test case.
- `testops_testcase_detach_automation` - detach automation from a test case.
- `testops_testcase_get` - get test case details.
- `testops_testcase_history` - get test case result history.
- `testops_testcase_patch` - partially update a test case.
- `testops_testcase_search` - search test cases with RQL/AQL.
- `testops_testcase_workflow` - get workflow and statuses for a test case.
- `testops_testcase_issues_set` - set external issues linked to a test case.

### Test Case Links, Members, And Tags

- `testops_testcase_link_create` - add an external URL link to a test case.
- `testops_testcase_link_delete` - delete one external URL link from a test case.
- `testops_testcase_links_delete_all` - delete all external URL links from a test case.
- `testops_testcase_member_create` - add a user with a role to a test case.
- `testops_testcase_member_delete` - remove one test case member.
- `testops_testcase_members_delete_all` - remove all test case members.
- `testops_testcase_members_read` - list test case members and roles.
- `testops_testcase_tags_add` - add tags to a test case.
- `testops_testcase_tags_remove` - remove tags from a test case.

### Test Case Scenario Steps

- `testops_scenario_steps_read` - read test case scenario steps.
- `testops_scenario_step_create` - create a scenario step.
- `testops_scenario_step_create_with_attachment` - create a scenario step with an attachment.
- `testops_scenario_step_create_with_expected_result` - create a scenario step with expected result.
- `testops_scenario_step_delete` - delete a scenario step.
- `testops_scenario_step_move` - move a scenario step.
- `testops_scenario_step_patch` - update scenario step text.

### Test Case Attachments

- `testops_testcase_attachment_create` - create a text attachment for a test case.
- `testops_testcase_attachment_delete` - delete a test case attachment.
- `testops_testcase_attachment_list` - list test case attachments.
- `testops_testcase_attachment_read` - read test case attachment content.
- `testops_testcase_attachment_save` - save a test case attachment to a local file.
- `testops_testcase_attachment_update` - update a test case attachment.

### Comments

- `testops_comment_create` - create a test case comment.
- `testops_comment_delete` - delete a test case comment.
- `testops_comment_get` - get test case comment details.
- `testops_comment_list` - list test case comments.
- `testops_comment_update` - update test case comment text.

### Defects

- `testops_defect_create` - create a defect.
- `testops_defect_delete` - delete a defect.
- `testops_defect_get` - get defect details.
- `testops_defect_list` - list and filter defects.
- `testops_defect_patch` - update defect status, name, or description.
- `testops_defect_get_testresults` - list test results linked to a defect.
- `testops_defect_link_issue` - link a defect to an external issue.
- `testops_defect_unlink_issue` - unlink a defect from an external issue.

### Defect Matchers

- `testops_defect_create_matcher` - create an auto-link matcher for a defect.
- `testops_defect_delete_matcher` - delete a defect matcher.
- `testops_defect_get_matchers` - list defect matchers.
- `testops_defect_patch_matcher` - update a defect matcher.

### Integrations

- `testops_integration_list` - list project integrations.
- `testops_integration_search_issue` - search external issues in configured integrations.
- `testops_integration_create_issue` - create an external issue and link it to a defect.

### Launches

- `testops_launch_search` - search launches.
- `testops_launch_close` - close a launch.
- `testops_launch_reopen` - reopen a launch.
- `testops_launch_apply_defects` - apply defect auto-linking to unresolved launch results.
- `testops_launch_get_defects` - list defects linked to a launch.
- `testops_launch_get_statistic` - get launch result statistics.
- `testops_launch_get_testresult_list` - list all test results in a launch.
- `testops_launch_read_muted` - list muted results in a launch.
- `testops_launch_read_unresolved` - list unresolved results in a launch.

### Test Results

- `testops_testresult_get_details` - get test result details.
- `testops_testresult_get_defects` - list defects linked to a test result.
- `testops_testresult_get_execution_step` - get execution steps for a test result.
- `testops_testresult_get_history` - get test result history.
- `testops_testresult_link_defect` - link a test result to a defect.
- `testops_testresult_unlink_defect` - unlink a test result from a defect.
- `testops_testresult_mute` - mute a test result.
- `testops_testresult_unmute` - unmute a test result.

### Test Result Attachments

- `testops_testresult_attachment_list` - list test result attachments.
- `testops_testresult_attachment_read` - read test result attachment content.
- `testops_testresult_attachment_save` - save a test result attachment to a local file.
