Happy slice of mcp pizzaMCP.pizza

testrail-mcp-server

MCP.Pizza Chef: uarlouski

Manage your TestRail test projects, cases, runs, and results through simple conversation with your AI assistant. Compatible with Claude Desktop, Cursor, Windsurf, VS Code, and other MCP clients, this server connects your AI directly to TestRail. You just paste a small config snippet with your TestRail URL, username, and API key to get started—no complex setup needed.

Other

Use This MCP server To

Find and list all projects in my TestRail account Create detailed test cases by describing them in natural language Start a new test run with selected test cases Update test results and mark cases as passed or failed Attach files to test cases or test runs Search for test cases in specific projects or sections Track test case history and revisions

README

🚀 TestRail MCP Server

An open-source Model Context Protocol (MCP) server that connects Claude, Cursor, Windsurf, and other AI assistants directly to TestRail.

Manage TestRail projects, search and create test cases, kick off test runs, record results, and attach files — all through natural-language conversation with your AI assistant. Built for QA engineers and AI-assisted test automation.

npm version npm downloads CI Status License TypeScript GitHub stars Score Badge

Compatible with: Claude Desktop Cursor Windsurf VS Code

testrail-mcp-server FAQ

Can I use this to create and update test cases in TestRail?
Yes — you can ask your AI assistant to create, fetch, update, and bulk-edit test cases directly in TestRail using natural language.
Can I start and manage test runs through my AI assistant?
Yes — the server lets your assistant start new test runs, update results, and attach files in TestRail.
Which AI apps work with this TestRail MCP server?
It works with Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible client.
Do I need a TestRail account or API key to use this?
Yes — you must have a TestRail account and generate an API key to connect your AI assistant.
How hard is it to set up?
Setup is copy-paste-config — you add a small config snippet with your TestRail details to your AI app.
Can I use this with older versions of TestRail?
Yes — it supports TestRail 10.6.2 and older versions with backward compatibility.