Skip to main content
Glama
syn7xx

TestOps MCP Server

by syn7xx

TestOps MCP Server

npm

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


Related MCP server: TestRail MCP Server

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

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
2wRelease cycle
5Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/syn7xx/testops-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server