• MAPPING
  • DISCOVERY
  • LOCATION
  • HUMAN

How to navigate test suites with your AI

Connect TestRail to your AI client to turn messy project hierarchies into searchable data. Once connected, you can find specific tests by asking about your structure.

Ask AI about this page

Short answer

How can I find specific tests in TestRail using AI?

Your AI uses the TestRail MCP to pull your project list, suites, and section hierarchies. You just ask for the location of a test, and it maps the path for you. This breakdown shows how it handles the discovery process.

Where your data lives.

Mapping your test hierarchy.

The AI maps your TestRail organization into actionable context.

MAPPING

Project visibility

The AI uses list_test_projects to see every active project in your account. You get a clear view of the top-level organization.

DISCOVERY

Suite identification

It pulls specific test suites using list_test_suites. This helps you narrow down exactly which group of tests you're looking for.

LOCATION

Section mapping

The agent uses list_project_sections to find the exact folder or section where tests live. You'll know the precise path to your target repository.

HUMAN

Manual verification

The AI identifies the location, but you still decide which tests to run or modify. It handles the searching so you can focus on the execution.

The workflow

What your AI does when the request arrives.

The AI moves from high-level project lists down to specific test sections.

  1. Identify projects

    The AI starts by scanning your TestRail account to see which projects are available for querying.

    list_test_projects

  2. Locate suites

    Once a project is identified, the agent looks through the individual test suites within that project.

    list_test_suites

  3. Map sections

    The AI drills into the specific sections and folders to find the exact repository you asked about.

    list_project_sections

  4. Report findings

    The agent presents the project, suite, and section path to you in plain text.

    list_test_projects

Try it

Copy these to start.

Use these prompts to begin exploring your TestRail structure.

Starting points

These are opening lines. Swap out the project or suite names with your actual TestRail data.

TestRail Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — TestRail capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "testrail-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
    }
  }
}
Copy into chat04

  • List all my TestRail projects so I can see what's available.

  • Find the 'Mobile App' test suite in my 'iOS Regression' project.

  • Show me all the sections inside the 'API Testing' suite.

  • Where is the 'Login Flow' test repository located in my current project?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect TestRail once, then ask.

Just click the link to connect. Your credentials stay encrypted, and you can immediately start asking your AI about your test data.

Connect TestRail to your AI

FAQ

How the navigation works.

  • 01

    Can the AI create new test cases in TestRail?

    No. This specific task only allows the AI to read and navigate your existing project structure.

  • 02

    Can the AI delete my test suites?

    No. The AI only has permission to list projects, suites, and sections. It cannot modify or delete your data.

  • 03

    Does the AI see my test results?

    No. The current tools are limited to navigating the hierarchy of projects, suites, and sections.

  • 04

    How does the AI know which project to look in?

    You tell the AI the project name in your prompt, and it uses the project listing tool to find the right match.

  • 05

    Can I use this with Claude or Cursor?

    Yes. Any MCP-compatible client like Claude, Cursor, or Windsurf can use this once you connect it via Vinkius.

  • More questions about TestRail? See everything the TestRail Connector can do

Connect TestRail to Claude, Cursor, ChatGPT & more