Testrail MCP Server logo

Testrail MCP Server

Unclaimed

by uarlouski

AI-native MCP server connecting Claude, Cursor, Windsurf, and other AI assistants to TestRail — manage test cases, runs, and results through natural-language conversation, with typed schemas built for LLMs.

Set up this server

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions
aiclaudecursorllmmcpmodel-context-protocolqatest-automationtestingtesting-toolstestrail

More in Automation

Browse the full directory

Unclaimed listing

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

30 of 30 tools

Documented tools (30)

From project documentation. A server handshake does not verify each tool’s description or behavior.

add_attachment

Add an attachment (screenshot, log, file, or auto-zipped directory) to a test case or test run (entitytype: "case" \

add_case

Seamlessly create a new test case equipped with robust custom field validation.

add_results

Submit test results to a test run using the specific testid.

add_results_for_cases

Submits results to a run mapping directly to caseids, streamlining automation workflows.

add_shared_step

Create a new reusable set of shared test steps.

delete_entity

Deletes a specified TestRail entity (supports "case", "sharedstep", or "attachment") by its ID. Requires TESTRAILALLOWDELETEOPERATIONS to be set to true in your environment.

get_case

Fetch complete, structured details of a specific test case, including custom steps and fields.

get_case_fields

Discover custom field definitions, formats, and UI dropdown options. Supports filtering by projectid.

get_cases

Query test cases with advanced filtering (priority, template, type, etc.) and pagination.

get_configurations

Retrieve all configuration groups and configurations for a project.

get_priorities

Retrieve priority levels configured within your instance structure.

get_results

Retrieve paginated results for a specific test ID.

get_sections

Navigate the precise folder/section hierarchy of any test suite.

get_shared_step

Retrieve precise details of a specific shared test step set.

get_shared_step_history

View the complete audit trail and version history of a shared step set.

get_shared_steps

List shared test steps for a project with optional reference filtering.

get_statuses

Systematically list all configured test statuses (Passed, Failed, Blocked, Retest, etc.).

get_templates

Identify available case templates to mandate correct AI structuring.

get_tests

Retrieve individual tests for a specific test run, with optional status filtering.

get_users

Retrieve active users. Handles per-project filtering and automatic fallback polling for non-admin accounts.

mutate_run

Create a new test run or update an existing one in TestRail.

mutate_section

Create a new section or update an existing section in TestRail.

mutate_suite

Create a new test suite or update an existing one in TestRail.

query_attachment

Download an attachment to a local file (action: "one") or retrieve attachment metadata for a test case or test run (action: "many", supporting outputfile export).

query_project

Retrieve a single project (action: "one") or all active projects (action: "many").

query_run

Retrieve a single test run (action: "one") or all test runs for a project (action: "many", supporting filters).

query_suite

Retrieve a single test suite (action: "one") or all test suites for a project (action: "many").

update_case

Modify an existing test case's steps, metadata, or titles.

update_cases

Execute bulk-updates on multiple test cases simultaneously to save time.

update_shared_step

Modify an existing shared step set (changes propagate to all linked test cases).

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Testrail MCP Server

How do I connect Testrail MCP Server to Claude?
The project does not publish a launch command that MCPVault could verify. Open the repository linked on this page for its install steps; the listing names Claude Desktop, Cursor, Windsurf as compatible clients.
Is Testrail MCP Server free?
The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Testrail MCP Server do?
Testrail MCP Server documents 30 tools to the agent, including add_attachment, add_case, add_results. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.