TestRail

TestRail MCP Connector for Claude

A+

Browse TestRail suites, parse manual test specs, and monitor active runs seamlessly native within your conversational AI workflow.

10 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Bring your overarching TestRail quality assurance orchestration directly to your developer's edge. Query comprehensive test coverage, inspect failing builds, and extract explicit test steps using natural conversation.

What you can do

  • Project Triage — Extract active test projects, their numeric IDs, and overall suite architecture logic
  • Suite & Case Isolation — Retrieve precise step-by-step logic, preconditions, and validation targets for any manual test case stored by QA
  • Run Execution Metrics — Instantly generate summaries around active 'Test Runs', seeing precisely which specific tests passed or failed
  • Milestone Navigation — Interrogate upcoming QA deadlines and release milestones without ever touching the heavy web browser application
  • Deep Hierarchical Search — Pull Section lists (folder hierarchies) from within projects to navigate robust test repositories visually in markdown

How it works

  1. Subscribe to this server
  2. Provide your TestRail Base URL alongside your authenticated Email & API Key
  3. Start fetching and aggregating QA metrics from Claude, Cursor, or any MCP-oriented platform

Who is this for?

  • Test Leads — generate immediate health summaries of active Milestones and Test Runs without digging into dashboard tables
  • Software Devs — pull down manual reproduction steps natively inside Cursor IDE to fix bugs without switching screens
  • Automation Engineers — analyze the properties of 'Test Cases' to rapidly convert them into code-based e2e automated tests
qa-testingtest-suitestest-casesrelease-managementtest-automationquality-assurance

10 tools expose this connector's capabilities to your AI agent.

get_test_case_details

Retrieves full details for a specific test case

get_test_project_details

Retrieves details for a specific TestRail project

get_test_run_details

Retrieves details for a specific test run

list_test_cases

Lists all test cases in a project, optionally filtered by suite

list_project_milestones

Lists all milestones within a project

list_test_projects

Project IDs are essential for navigating most other resources. Lists all test projects available on the TestRail instance

list_test_runs

Lists all test runs within a specific project

list_project_sections

Lists all sections (folders) within a project

list_test_suites

Lists all test suites within a specific project

list_run_tests

Lists all tests (case instances) within a specific test run

See how to talk to your AI agent using TestRail.

What active TestRail projects are available in this instance?

Found 2 active TestRail projects: - **`ID: 15`** | "Native Mobile Apps (Q2)" | Uses standard multi-suite mode. - **`ID: 29`** | "Core Payment Backend" | Single suite repository. Should I list milestones or test suites under Project ID 15?

Get the manual preconditions and test steps for Test Case 1285.

Case ID `1285`: **OAuth Registration Gateway Failure** > **Priority:** CRITICAL_HIGH | **Estimate:** 5m > **Preconditions:** Server must be isolated via VPN routing rules. **Steps:** 1. Call initialization endpoint bypassing token assignment. (Expected Result: API triggers `ERR401` gracefully without cascading stack traces). 2. Force brute-force retries mimicking scripts. (Expected Result: IP locks completely after exactly 5th try). Can I translate these rules over towards a framework structure?

Return exact status summary for Test Run ID 403.

Metrics recovered for Test Run **`#403: Sanity Validation Build.v45`**: - **Total Executed Tests:** 80 - **Passed:** 71 ✅ - **Failed (Action Required):** 6 ❌ - **Blocked (Dependency issues):** 3 ⏸️ This run has notable defect traces. Would you like me to extract the exact test lists behind the 6 failed triggers?

Technically yes, as TestRail uses HTTP Basic Auth. However, it is highly discouraged for security purposes. The gold standard is to generate a dedicated API Key via your profile interface strictly tied to this connection.

Related Connectors