Testrail-mcp-server MCP Server

The TestRail MCP Server is a free, open-source Model Context Protocol server that gives AI assistants direct, structured access to a TestRail instance through the TestRail API v2. Once configured…

Local serverstdioApache-2.0

What is the Testrail-mcp-server MCP Server?

testrail-mcp-server is an MCP project maintained in the uarlouski/testrail-mcp-server repository. The maintainer describes its purpose as “The TestRail MCP Server is a free, open-source Model Context Protocol server that gives AI assistants direct, structured access to a TestRail instance through the…”. Read the project documentation for the complete scope.

Installation

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

Configuration values

The example declares TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS. 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 MCP Server

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server@latest"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "YOUR_TESTRAIL_API_KEY",
        "TESTRAIL_ENABLE_SHARED_STEPS": "true"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
TESTRAIL_INSTANCE_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
TESTRAIL_ENABLE_SHARED_STEPSDeclared in the maintainer’s client configuration.Check documentation