Vinkius

TestRail MCP. Query full project health via natural conversation.

TestRail MCP connects your conversational AI directly to your entire test suite. Instead of clicking through dashboards, you query project status, review manual steps for specific cases, and analyze run metrics using plain language commands. It brings deep QA insights straight into your agent.

TestRail MCP is compatible with Claude Claude
TestRail MCP is compatible with ChatGPT ChatGPT
TestRail MCP is compatible with Cursor Cursor
TestRail MCP is compatible with Gemini Gemini
TestRail MCP is compatible with Windsurf Windsurf
TestRail MCP is compatible with VS Code VS Code
TestRail MCP is compatible with JetBrains JetBrains
TestRail MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

List all available projects

Retrieves a list of every test project on the instance, providing essential IDs for further queries.

Get project and section structure

Lists all sections (folders) or retrieves detailed information about specific TestRail projects.

Check milestones and deadlines

Interrogates upcoming QA release milestones for a given project, keeping you updated on timelines.

Review test case steps

Retrieves the full details, preconditions, and step-by-step logic for any specific manual test case ID.

Analyze active test runs

Generates an immediate summary of a specific test run, showing total tests executed, passed counts, failures, and blocked items.

List all contained tests in a run

Pulls down the list of individual tests that were included in a particular test run.

Waiting for input…

AI Agent
TestRail

What AI agents can do with TestRail with 10 Tools

Use these tools to query every aspect of your QA data, from listing projects to getting deep details on individual test cases.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using TestRail MCP

Get Test Case Details

Pulls all data, including preconditions and detailed steps, for a single test case ID.

Get Test Project Details

Retrieves comprehensive information about a specific TestRail project.

Get Test Run Details

Fetches the overall status and metrics for a specified test run ID.

List Test Cases

Generates a list of all available test cases within a project, optionally filtered...

List Project Milestones

Lists every major milestone associated with a given TestRail project.

List Test Projects

Outputs all test projects available on the instance, which is critical for targeting other resources.

List Test Runs

Lists all completed or active test runs within a selected project.

List Project Sections

Outputs the folder hierarchy, listing every section available inside a project.

List Test Suites

Lists all major test suites within a specific project boundary.

List Run Tests

Outputs the list of individual tests that were executed during a particular test run.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

TestRail MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The TestRail integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on each call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with TestRail, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,200+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Connections are secured and governed automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog weekly
TestRail MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TestRail. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS CLOUD

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on each call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

The pain of checking test coverage status

Today, figuring out project health means logging into TestRail, clicking on the Project Overview dashboard. You might then need to jump to the Milestone tab for dates, and finally open a specific Run ID just to see if tests failed or passed. It's three separate screens and at least five clicks every time you check status.

With this MCP, the process is simple: you ask your agent, 'What's the latest on Project X?' The connector compiles data from project milestones, test run details, and section lists into one single response in your chat. You get the answer instantly, without leaving your workflow.

Get TestRail Case Details with this MCP

Manually finding reproduction steps requires knowing the exact test case ID and navigating deep into a specific project section. You have to open that case, scroll past the description, and copy-paste the preconditions and step sequence.

Now, you simply ask your agent for 'the manual steps for Test Case 1285.' The connector uses get_test_case_details and delivers the entire structured playbook—preconditions, steps, expected results—in a clean format ready to use.

What TestRail MCP does for your AI

This connector lets you get full visibility into complex quality assurance projects without ever opening the TestRail web interface. You can ask your AI client to pull down a list of all active test projects or find specific sections within massive repositories, giving you an immediate architectural overview.

It tracks progress across multiple dimensions: you can check upcoming release milestones or see exactly which tests passed and failed in any given run. Need details on how a manual case works? You just ask for the steps, preconditions, and validation targets. This capability lets developers pull reproduction instructions directly into their IDE to start fixing bugs immediately.

All these deep QA metrics are accessible through natural conversation. Vinkius hosts this MCP, giving your agent access to TestRail’s full history so you can manage project status and analyze test runs—all without switching tabs.

Built · Hosted · Managed by Vinkius TestRail-MCP - Manage Test Cases & Project Status
Server ID 019d7612-2985-733c-8326-56b1ba657c18
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Frequently asked questions about TestRail MCP

How do I find all active projects using TestRail MCP? +

You list all available test projects by calling the list_test_projects tool. This gives you a full inventory of IDs, allowing you to target any other resource on the instance.

Can I check upcoming deadlines with TestRail MCP? +

Yes, use the list_project_milestones tool. It pulls all scheduled milestones for a project ID, helping you keep track of QA release timelines without opening the web app.

What is the difference between listing tests and test runs? +

list_test_runs lists all available execution records (the 'container'). list_run_tests uses one of those run IDs to pull the specific individual tests that were executed in that session.

Can TestRail MCP help with bug replication? +

Absolutely. Use get_test_case_details on a case ID. This retrieves the complete manual playbook, including preconditions and step-by-step instructions needed for developers to reproduce any issue.

Does TestRail MCP support folder navigation? +

Yes. You can use list_project_sections to pull down the full section list (folder hierarchy) from within a project, giving you a clear visual map of your test repository.