Testrail Mcp Server

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.