testrail-mcp-server

Overview

TestRail MCP Server is a purpose-built integration that enables AI assistants like Claude, Cursor, and Windsurf to directly interact with TestRail test management platforms. It provides comprehensive tools for browsing projects, managing test cases, creating test runs, and recording results—all through conversational AI interactions. The server features heavily typed schemas specifically designed for LLM use cases, ensuring structured data generation and validation.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_projects

  List all available active and completed projects in your TestRail instance

  Try:List all projects in TestRail to find the latest active projectTry:Show me all projects in our TestRail instance
• get_sections

  Navigate the precise folder/section hierarchy of any test suite

  Try:Show me the section hierarchy for project 3Try:List all sections in test suite 5
• get_cases

  Query test cases with advanced filtering and pagination

  Try:Show me all test cases in section 5 of project 3Try:Find test cases with high priority that haven't been run
• get_case

  Fetch complete details of a specific test case

  Try:Get details for test case ID 1042Try:Show me the complete test case with case ID 56
• add_case

  Create a new test case with custom field validation

  Try:Create a comprehensive test case for 'Login Validation' with detailed stepsTry:Add a new test case for the checkout process
• update_case

  Modify an existing test case's steps or metadata

  Try:Update test case 1042 to add a new preconditionTry:Change the title of test case 56 to 'Login with valid credentials'
• update_cases

  Bulk-update multiple test cases simultaneously

  Try:Mark test cases 10, 11, and 12 as obsoleteTry:Set the priority to high for all test cases in section 5
• add_run

  Generate a new focused test run in TestRail

  Try:Start a new test run containing cases from section 5Try:Create a regression test run for version 2.3
• get_tests

  Retrieve individual tests for a specific run with status filtering

  Try:Show me all tests in run 23Try:List only the failed tests from the last regression run
• add_results

  Submit test results to a test run using the specific test ID

  Try:Mark test ID 45 as passed with the comment 'Tested successfully'Try:Record that test ID 78 failed with attachment log.txt
• add_results_for_cases

  Submit results to a run mapping directly to case IDs

  Try:Mark test case 1042 as passed for the current runTry:Record failed results for cases 10, 11, and 12
• add_attachment_to_run

  Attach logs, files, or artifacts directly to a test run

  Try:Add screenshot.png to the current test runTry:Attach the test log file to run 23

Comparable tools

Installation

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["-y", "@uarlouski/testrail-mcp-server@latest"],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "your-api-key",
        "TESTRAIL_ENABLE_SHARED_STEPS": "true"
      }
    }
  }
}

FAQ

Which AI assistants are compatible with this MCP server?

The TestRail MCP Server works with Claude Desktop, Cursor, Windsurf, and any other MCP-compliant AI assistants.

What authentication method is required for TestRail?

You need to provide your TestRail instance URL, username, and API key through environment variables in your MCP configuration.

Compare testrail-mcp-server with