testrail-mcp MCP Server

A Model Context Protocol (MCP) server for TestRail that allows interaction with TestRail's core entities through a standardized protocol.

Local serverstdio

What is the testrail-mcp Server?

testrail-mcp source profile. From the maintainer documentation: “A Model Context Protocol (MCP) server for TestRail that allows interaction with TestRail's core entities through a standardized protocol.”

Installation

The documented pypi package is testrail-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TESTRAIL_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the testrail-mcp Server

{
  "mcpServers": {
    "testrail": {
      "command": "uvx",
      "args": [
        "testrail-mcp"
      ],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your-email@example.com",
        "TESTRAIL_API_KEY": "YOUR_TESTRAIL_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TESTRAIL_URLDeclared in the maintainer’s client configuration.Check documentation
TESTRAIL_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
TESTRAIL_API_KEYDeclared in the maintainer’s client configuration.Check documentation