Testrail Mcp Server
@uarlouski
About Testrail Mcp Server
A high-performance Model Context Protocol (MCP) server connecting AI assistants (Claude, Cursor, Windsurf) directly to TestRail.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"testrail": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server@latest"
],
"env": {
"TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
"TESTRAIL_USERNAME": "[email protected]",
"TESTRAIL_API_KEY": "your-api-key"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is TestRail MCP Server?
TestRail MCP Server is a high-performance Model Context Protocol (MCP) server that connects AI assistants (such as Claude, Cursor, and Windsurf) directly to TestRail. It enables users to search, create, update, and execute test cases using natural language, eliminating manual copy-pasting and context switching.
How to use TestRail MCP Server?
Obtain a TestRail API key from My Settings → API Keys. Then add the server to your MCP client configuration (e.g., Claude Desktop, Cursor, Windsurf) by providing the npx command and the three required environment variables: TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, and TESTRAIL_API_KEY. Once configured, you can instruct your AI assistant to perform TestRail operations in natural language.
Key features of TestRail MCP Server
- Intelligent discovery of projects, suites, and sections.
- Full test case management with custom field support.
- Actionable test execution and result tracking.
- Context-aware AI that exposes templates, fields, and statuses.
- Bulk edit and attachment capabilities for runs.
Use cases of TestRail MCP Server
- List all active projects to find the latest one.
- Show test cases from a specific section of a project.
- Create a comprehensive test case with detailed steps.
- Start a new test run containing selected cases.
- Mark a test case as passed with a comment.
FAQ from TestRail MCP Server
What is TestRail MCP Server and how does it differ from manual TestRail usage?
It is an MCP server that lets AI assistants interact with TestRail via natural language, automating test management tasks that otherwise require manual navigation and copy-pasting.
How do I install and configure TestRail MCP Server?
Installation is done by adding the server to your MCP client configuration using the npx command with the @uarlouski/testrail-mcp-server@latest package. You must set three environment variables: your TestRail instance URL, your user email, and your API key.
Which AI assistants or MCP clients are supported?
The server works with any MCP-compliant client, including Claude Desktop, Cursor, and Windsurf.
What TestRail operations can I perform through this server?
You can list projects and sections, create/update/bulk-edit test cases, add test runs, submit results by test ID or case ID, attach files to runs, and retrieve metadata like statuses, priorities, case fields, and templates.
Is TestRail MCP Server open source and can I contribute?
Yes, it is licensed under Apache License 2.0 and contributions via issues and pull requests are actively welcomed.
More Other MCP servers
Servers
modelcontextprotocolModel Context Protocol Servers
Nginx UI
0xJackyYet another WebUI for Nginx
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Awesome Mlops
visengerA curated list of references for MLOps
Comments