MCP Testrail

🚀 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:

💻 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.

🤝 Contribution

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

🙏 Acknowledgments

Thanks to the following resources:

• TestRail API
• Model Context Protocol SDK