mcp-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…

Local serverstdioMIT

What is the mcp-testrail MCP Server?

mcp-testrail is an MCP project maintained in the bun913/mcp-testrail repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /Users/you/.nvm/versions/node/v24.15.0/bin/npx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
CategoryTools
ProjectsgetProjects, getProject
SuitesgetSuites, getSuite, addSuite, updateSuite
CasesgetCase, getCases, addCase, updateCase, deleteCase, getCaseTypes, getCaseFields, copyToSection, moveToSection, getCaseHistory, updateCases, addBdd, getBdd
SectionsgetSection, getSections, addSection, moveSection, updateSection, deleteSection
RunsgetRuns, getRun, addRun, updateRun
TestsgetTests, getTest
ResultsgetResults, getResultsForCase, getResultsForRun, addResultForCase, addResultsForCases
PlansgetPlans
MilestonesgetMilestones

How to install the mcp-testrail MCP Server

{
  "mcpServers": {
    "testrail": {
      "command": "/Users/you/.nvm/versions/node/v24.15.0/bin/npx",
      "args": [
        "@bun913/mcp-testrail@latest"
      ],
      "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