mcp-testrail MCP Server

Use This MCP server To

Retrieve and manage TestRail projects and suites Create, update, and delete test cases within TestRail Organize test cases by adding or moving sections Manage test runs and retrieve test results Copy or move test cases between sections Update multiple test cases in bulk Access test case history and metadata Add test results directly from AI conversations

README

TestRail MCP Server

This Model Context Protocol (MCP) server provides tools for interacting with TestRail directly from Claude AI and other MCP-supported clients like Cursor. It allows you to manage test cases, projects, suites, runs, and more without leaving your conversation with the AI.

Available Tools

The TestRail MCP server provides the following tools:

Category	Tools
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

You can connect this MCP server by setting like the below. This method uses npx to automatically download and run the latest version of the package, eliminating the need for 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
      }
    }
  }
}

Troubleshooting

spawn node ENOENT errors: Ensure that Node.js is properly installed and in your PATH.
Connection issues: Verify that the server is running and the URL is correctly configured in your MCP client.
Authentication issues: Check your TestRail API credentials in the .env file.
SSE connection errors: If you see SSE error: TypeError: fetch failed: connect ECONNREFUSED, make sure the server is running on the specified port.
Your conversation is too long: Pleae use limit and offset parameter for test cases

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

mcp-testrail FAQ

How do I connect the mcp-testrail server to my TestRail instance?

You configure the server with your TestRail API credentials and endpoint URL to enable secure communication.

Can I create new test cases using the mcp-testrail server?

Yes, the server supports adding new test cases and updating existing ones through MCP clients.

Is it possible to manage test runs and results with this server?

Absolutely, you can create, update, and retrieve test runs and their associated test results.

Does the mcp-testrail server support bulk updates of test cases?

Yes, it provides tools to update multiple test cases simultaneously for efficient management.

Can I organize test cases into sections using this server?

Yes, you can add, move, update, and delete sections to organize your test cases effectively.

What MCP clients are compatible with the mcp-testrail server?

It works with any MCP-supported clients such as Claude AI and Cursor.

How does the server handle authentication and security?

The server uses secure API credentials and follows best practices to protect your TestRail data.

Can I retrieve the history of changes made to a test case?

Yes, the server provides access to test case history for audit and review purposes.