Testrail MCP Server
UnclaimedAI-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
More in Automation
Browse the full directoryUnclaimed 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 serverSecurity 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
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.