mcp-testrail

Dinesh-S04/mcp-testrail

3.1

If you are the rightful owner of mcp-testrail and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The TestRail MCP Server allows seamless integration of TestRail with any Model Context Protocol (MCP) orchestrator, providing tools to manage test cases, projects, suites, runs, and results directly from AI workflows or test automation pipelines.

Tools
37
Resources
0
Prompts
0

TestRail MCP Server

Seamlessly integrate TestRail with any Model Context Protocol (MCP) orchestrator. This server exposes powerful tools that let you manage test cases, projects, suites, runs, and results — all directly from your AI workflows or test automation pipelines.

Whether you’re syncing Playwright test results, automating test case creation from Swagger logs, or driving conversations with intelligent test reasoning, this server keeps your TestRail data connected and context-aware.

Available Tools

The TestRail MCP server provides the following tools:

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

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": ["@dineshselvaraj/mcp-testrail"],
      "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