How do I install Testrail?

Testrail is a local plugin. Install it using npm package: @uarlouski/testrail-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Testrail safe to use?

Testrail scored 6.1/10 (moderate risk) in MCP Marketplace's automated security scan. It has 1 high or critical finding to review. It's listed, but review the security report on this page before installing.

What credentials does Testrail need?

Testrail requires the following credentials or environment variables: TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS, TESTRAIL_REQUEST_TIMEOUT_MS. You can find setup instructions on the server detail page.

What AI apps work with Testrail?

Testrail uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Testrail MCP Server

by Uarlouski

Developer ToolsModerate6.1MCP RegistryLocal

Free

Server data from the Official MCP Registry

Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments.

About

Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments.

Security Report

6.1

Moderate6.1Moderate Risk

The TestRail MCP server is a legitimate API client. It reads credentials from environment variables, sends them only to the user's configured TestRail instance, and gates destructive operations behind explicit flags. The main concern is that file-path arguments supplied through tool calls are not restricted, so an AI assistant could read arbitrary local files for attachment uploads or write files to arbitrary locations via attachment downloads and exports. Several source files were truncated, so this assessment is partial. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

8 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of your TestRail instance (e.g. https://example.testrail.io)Optional

Environment variable: TESTRAIL_INSTANCE_URL

Email address used to authenticate with TestRailOptional

Environment variable: TESTRAIL_USERNAME

API key for authenticating with the TestRail APIRequired

Environment variable: TESTRAIL_API_KEY

Enable shared steps managementOptional

Environment variable: TESTRAIL_ENABLE_SHARED_STEPS

Enable test case history managementOptional

Environment variable: TESTRAIL_ENABLE_CASE_HISTORY

Enable Knowledge Base and RAG export toolsOptional

Environment variable: TESTRAIL_ENABLE_RAG_TOOLS

Allow write operations on TestRail (defaults to true)Optional

Environment variable: TESTRAIL_ALLOW_WRITE_OPERATIONS

Allow read operations on TestRail (defaults to true)Optional

Environment variable: TESTRAIL_ALLOW_READ_OPERATIONS

Allow delete operations on TestRail (defaults to false)Optional

Environment variable: TESTRAIL_ALLOW_DELETE_OPERATIONS

Enable deprecated tools for backward compatibility (defaults to true)Optional

Environment variable: TESTRAIL_ENABLE_DEPRECATED_TOOLS

Comma-separated list of tool names to disableOptional

Environment variable: TESTRAIL_DISABLED_TOOLS

Timeout in milliseconds for TestRail HTTP requests (defaults to 30000ms)Optional

Environment variable: TESTRAIL_REQUEST_TIMEOUT_MS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-uarlouski-testrail-mcp-server": {
      "env": {
        "TESTRAIL_API_KEY": "your-testrail-api-key-here",
        "TESTRAIL_USERNAME": "your-testrail-username-here",
        "TESTRAIL_INSTANCE_URL": "your-testrail-instance-url-here",
        "TESTRAIL_DISABLED_TOOLS": "your-testrail-disabled-tools-here",
        "TESTRAIL_ENABLE_RAG_TOOLS": "your-testrail-enable-rag-tools-here",
        "TESTRAIL_REQUEST_TIMEOUT_MS": "your-testrail-request-timeout-ms-here",
        "TESTRAIL_ENABLE_CASE_HISTORY": "your-testrail-enable-case-history-here",
        "TESTRAIL_ENABLE_SHARED_STEPS": "your-testrail-enable-shared-steps-here",
        "TESTRAIL_ALLOW_READ_OPERATIONS": "your-testrail-allow-read-operations-here",
        "TESTRAIL_ALLOW_WRITE_OPERATIONS": "your-testrail-allow-write-operations-here",
        "TESTRAIL_ALLOW_DELETE_OPERATIONS": "your-testrail-allow-delete-operations-here",
        "TESTRAIL_ENABLE_DEPRECATED_TOOLS": "your-testrail-enable-deprecated-tools-here"
      },
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

Testrail MCP Server

About

Security Report

Findings (7)Action required

Permissions Required

What You'll Need

How to Install

Reviews

No reviews yet

More Developer Tools MCP Servers

Rea

Paperclip

Fetch

Git

Toleno

MCP Marketplace