TestOps MCP Server

MCP server for TestOps 5.25. Lets AI assistants (Cursor, VS Code, Claude, OpenCode, Windsurf, Zed, Kilo Code) work directly with projects, launches, test plans, and test cases in TestOps.

What you can do

Once connected, an AI assistant can:

• Find projects, launches, and test plans
• Create and stop test launches
• Read, create, and edit test cases
• Work with scenarios and custom fields
• Search test cases using AQL

Quick start

Install

npm install @syn7xx/testops-mcp-server

Or run without installing — via npx:

npx @syn7xx/testops-mcp-server --url https://your-testops.com --token your-token

Short flags: -u (url), -t (token), -h (help).

You can also use environment variables:

export TESTOPS_URL=https://your-testops.com
export TESTOPS_TOKEN=your-token
npx @syn7xx/testops-mcp-server

CLI flags take priority over environment variables.

Connecting to an AI tool

Cursor, Windsurf, Kilo Code, Zed

mcp.json in your project or home folder:

{
  "mcpServers": {
    "testops": {
      "command": "npx",
      "args": ["-y", "@syn7xx/testops-mcp-server", "--url", "https://your-testops.com", "--token", "your-token"]
    }
  }
}

Visual Studio Code

.vscode/mcp.json in your project (key is servers, not mcpServers):

{
  "servers": {
    "testops": {
      "command": "npx",
      "args": ["-y", "@syn7xx/testops-mcp-server", "--url", "https://your-testops.com", "--token", "your-token"]
    }
  }
}

OpenCode

opencode.jsonc:

{
  "mcp": {
    "testops": {
      "type": "local",
      "command": ["npx", "-y", "@syn7xx/testops-mcp-server", "--url", "https://your-testops.com", "--token", "your-token"],
      "enabled": true
    }
  }
}

Or with environment variables:

{
  "mcp": {
    "testops": {
      "type": "local",
      "command": ["npx", "-y", "@syn7xx/testops-mcp-server"],
      "environment": {
        "TESTOPS_URL": "https://your-testops.com",
        "TESTOPS_TOKEN": "your-token"
      },
      "enabled": true
    }
  }
}

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "testops": {
      "command": "npx",
      "args": ["@syn7xx/testops-mcp-server", "--url", "https://your-testops.com", "--token", "your-token"]
    }
  }
}

Never commit real tokens. Use environment variables or local-only configs.

Available tools

Projects

| Tool | Description | |---|---| | project_list | List projects with pagination | | project_find_by_name | Find project by exact or partial name match | | project_get_by_id | Get project by ID | | project_get_test_case_trees | Get test case trees for a project |

Launches

| Tool | Description | |---|---| | launch_list | List launches for a project with pagination | | launch_get | Get a launch by ID | | launch_create | Create a test launch (with envVarValueSets support) | | launch_stop | Stop a running launch | | launch_get_statistic | Launch summary: counts by status + progress | | launch_list_test_results | Flat paginated test results for a launch |

Test Plans

| Tool | Description | |---|---| | testplan_list | List test plans for a project with pagination | | testplan_get | Get test plan by ID | | testplan_get_stat | Test plan statistics: automated/manual counts and durations | | testplan_get_test_cases | Get test cases from a test plan | | testplan_run | Create a launch from a test plan | | testplan_sync | Sync test plan with its source |

Test Cases

| Tool | Description | |---|---| | testcase_get | Get test case by ID | | testcase_get_detail | Summary: flattened step strings, custom fields, tags | | testcase_get_scenario | Full scenario JSON (steps + expected results) | | testcase_get_step | Same as testcase_get_scenario (alias) | | testcase_get_custom_fields | Get custom field values for a test case | | testcase_update | Update test case metadata (name, description, status, tags, etc.) | | testcase_update_step | Update a single scenario step | | testcase_set_scenario | Replace all steps in a scenario | | testcase_update_custom_fields | Set custom field values | | testcase_search_by_aql | Search test cases using AQL query | | testcase_list_in_tree | List test cases in a project tree | | testcase_create | Create a test case (with steps, tags, custom fields) |

Project Custom Fields

| Tool | Description | |---|---| | project_get_custom_fields | Custom field definitions for a project | | project_get_custom_field_values | Available values for a custom field |

Self-signed certificates

If TestOps uses a self-signed certificate and Node.js fails TLS validation:

export NODE_TLS_REJECT_UNAUTHORIZED=0

This disables certificate checks for all HTTPS requests in that process. Use only when necessary and in a trusted environment.

Build and run from source

# Clone
git clone https://github.com/syn7xx/testops-mcp-server.git
cd testops-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run
npm start -- --url https://your-testops.com --token your-token

For working on the codebase, see CONTRIBUTING.md.

License

MIT