MCP Testrail

The TestRail MCP Server provides tools for interacting with TestRail, supporting direct management of test cases, projects, suites, and runs through MCP clients such as Claude AI.

Developer tools Artificial intelligence chatbots #Test management #API integration #Automation tools .TypeScript

rating : 2 points

downloads : 10

update time : 2025-04-28

What is TestRail MCP Server?

TestRail MCP Server is a middleware that connects to the TestRail test management system. It allows users to interact directly with TestRail through an AI assistant (such as Claude) or a client that supports the MCP protocol (such as Cursor), enabling test management tasks to be completed without switching applications.

How to use TestRail MCP Server?

Simply configure the MCP client connection information, and you can start managing test projects, cases, and run results in TestRail using natural language commands. The system will automatically handle API calls and response conversions.

Applicable scenarios

Suitable for test teams to improve work efficiency when writing test cases, planning test runs, and recording test results. Particularly suitable for agile development environments that require frequent interaction with the test management system.

Main features

Project managementView and obtain project information in TestRail

Test suite managementAdd, update, and query test suites

Test case managementComprehensive test case operations, including adding, updating, deleting, moving, and copying

Test run managementCreate and update test runs, and obtain run details

Test result recordingAdd results for test cases, supporting batch operations

Advantages and limitations

Advantages

Perform TestRail operations without leaving the AI conversation interface

Support natural language interaction, reducing the usage threshold

Automatically handle API call details, simplifying the integration process

Automatically update via npx, eliminating the need for manual maintenance

Limitations

Requires a Node.js runtime environment

Long conversations may cause performance issues; pagination parameters need to be used

Some advanced functions still need to be completed through the native TestRail interface

How to use

Install Node.js

Ensure that the Node.js runtime environment is installed on the system

Configure the MCP client

Add TestRail server connection information to the MCP client configuration file

Start using

Interact with TestRail using natural language commands in a supported client

Usage examples

Query test casesGet all test cases under a specific project

Record test resultsAdd pass/fail results for cases in a test run

Create a regression test suiteCreate a new test suite based on existing cases

Frequently asked questions

What should I do if I get the 'spawn node ENOENT' error?

How to solve the 'ECONNREFUSED' (connection refused) error?

Why is the response slow when getting test cases?

How to update to the latest version?

Related resources

TestRail official API documentation

Complete reference documentation for the TestRail API

Model Context Protocol SDK

TypeScript implementation of the MCP protocol

TestRail MCP Server source code

npm package page for this project

🚀 TestRail MCP Server

The Model Context Protocol (MCP) server provides tools for direct interaction with TestRail, which can be used in Claude AI and other MCP - supported clients like Cursor. It enables you to manage test cases, projects, suites, runs, etc., without leaving your conversation with the AI.

🚀 Quick Start

The Model Context Protocol (MCP) server provides a means to directly interact with TestRail. It can be utilized within Claude AI and other MCP - enabled clients such as Cursor. This allows users to manage various aspects of testing, including test cases, projects, suites, and runs, all without having to exit their AI - based conversations.

✨ Features

The TestRail MCP server offers the following tools:

Category	Tool Name
Projects	`getProjects`, `getProject`
Suites	`getSuites`, `getSuite`, `addSuite`, `updateSuite`
Cases	`getCase`, `getCases`, `addCase`, `updateCase`, `deleteCase`, `getCaseTypes`, `getCaseFields`, `copyToSection`, `moveToSection`, `getCaseHistory`, `updateCases`
Sections	`getSection`, `getSections`, `addSection`, `moveSection`, `updateSection`, `deleteSection`
Runs	`getRuns`, `getRun`, `addRun`, `updateRun`
Tests	`getTests`, `getTest`
Results	`getResults`, `getResultsForCase`, `getResultsForRun`, `addResultForCase`, `addResultsForCases`
Plans	`getPlans`
Milestones	`getMilestones`
Shared Steps	`getSharedSteps`

💻 Usage Examples

Basic Usage

You can connect to this MCP server in the following way. This method uses npx to automatically download and run the latest version of the package without local installation.

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

📚 Documentation

Troubleshooting

spawn node ENOENT error: Make sure Node.js is correctly installed and in the PATH.
Connection issues: Verify that the server is running and the URL is correctly configured in the MCP client.
Authentication issues: Check your TestRail API credentials in the .env file.
SSE connection error: If you encounter SSE error: TypeError: fetch failed: connect ECONNREFUSED, ensure the server is running on the specified port.
Long conversations: Use the limit and offset parameters for test cases.