Skip to content
Vinkius

TestRail Connector for AI agents.

10 live capabilities

Get manual test steps and QA run metrics directly in your IDE.

Live agent request TestRail / Connector

Waiting for input…

AI Agent

Why people use TestRail

TestRail for Faster QA Triage and Debugging

This Connector changes that by letting you stay in your flow. You can just ask your agent to pull the manual steps for a specific case or check the latest run results. It pulls the data directly into your chat or IDE, so you get the info you need instantly without ever leaving your workspace.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a direct bridge between your QA data and your active development workspace.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Debugging a reported bug

    A developer asks the agent for the manual steps of a failing case to see the exact reproduction steps and preconditions.

  2. Real-world use case 02

    Release status check

    A product manager asks the agent to summarize the status of the current test run to see if the build is ready for production.

  3. Real-world use case 03

    Automating manual tests

    An automation engineer uses the agent to pull all test cases from a suite to begin writing scripts for a new feature.

Complete set · 10capabilities

The complete TestRail capability set.

These are the exact actions your AI can choose when you ask it to work with TestRail.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through TestRail.

  1. 01 Capability

    List test projects

    Lists all available projects on your instance to help you find project IDs. This is the first step for navigating your data.

  2. 02 Capability

    List test runs

    Lists all test runs within a project so you can see historical and active data. Use this to find specific run IDs.

  3. 03 Capability

    List project sections

    Pulls the folder hierarchy and sections for a project to help with navigation. This helps you see how tests are organized.

  4. 04 Capability

    List test suites

    Lists all test suites within a specific project. Use this to identify different testing areas.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through TestRail.

  1. 05 Capability

    List run tests

    Lists all test case instances within a specific test run to see exactly what was executed. This is perfect for debugging failures.

  2. 06 Capability

    Get test case details

    Retrieves the full logic, preconditions, and steps for a specific manual test case. Use this to see exactly how a test should be performed.

  3. 07 Capability

    Get test project details

    Fetches the specific details and configuration for a TestRail project. This helps you understand the scope of a project quickly.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through TestRail.

  1. 08 Capability

    Get test run details

    Provides the summary and status for a specific test run. Use this to check the health of a specific execution.

  2. 09 Capability

    List test cases

    Lists all test cases within a project, with the option to filter by suite. This is great for finding specific test logic.

  3. 10 Capability

    List project milestones

    Pulls a list of all milestones for a specific project. Use this to track release dates and major QA goals.

Set up in minutes

One URL. Then ask TestRail to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TestRail from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it TestRail, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable TestRail for the conversation.

Where the request belongs

Work TestRail can move forward.

Built around the request

This is for the engineers and QA leads who are tired of context switching between Jira, the browser, and their IDE to find out what's broken.

01

Software Developer

Pulls manual reproduction steps into Cursor to fix bugs faster without leaving the code.

02

Test Lead

Gets a quick health summary of active milestones and test runs without digging into dashboard tables.

03

Automation Engineer

Analyzes manual test cases to rapidly convert them into code-based e2e automated tests.

Bring your own AI

Change the model, client or framework. Keep TestRail connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about TestRail.

The practical details behind the request, access and result.

Can the TestRail MCP help me see manual test steps?

Yes, it pulls the exact steps and preconditions for any manual test case so you don't have to hunt for them in the web app.

How does TestRail MCP help with bug fixing?

It lets your agent fetch the specific reproduction steps for a case, making it much faster to see what's going wrong without leaving your IDE.

Can I use TestRail MCP to check release status?

You can ask your agent to summarize the latest test runs and check upcoming milestones to see if you're ready to ship.

Does TestRail MCP work with Cursor or Claude?

Yes, it connects to any MCP-compatible client like Claude, Cursor, and Windsurf to bring your QA data into those capabilities.

Can TestRail MCP help with test automation?

It's great for this because you can pull manual test logic and then ask your agent to help you write the code for it.

How do I connect TestRail MCP to my instance?

You just need to provide your TestRail Base URL along with your API credentials in your AI client.

Can I use my regular TestRail password to authenticate?

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.

Why isn't the API agent responding despite my credentials being correct?

TestRail requires the instance administrator to explicitly configure system-level API enablement. Ask your workspace admin to go to Administration > Site Settings > API and tick 'Enable API' box.

Can the AI rewrite my test cases explicitly inside your TestRail app?

No. Consistent with security best practices, the TestRail MCP functions only as a powerful read-only query extraction engine. It retrieves metadata, sections, milestones, and reports, protecting your ground-truth data from accidental AI deletion.

One connection away

Give your agent a direct line to TestRail.

Connect TestRail once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available