Testrail Mcp Server
Connects your AI assistant directly to TestRail's API so you can manage test cases, runs, and results through natural language. Ships with read/write/delete operation toggles and exposes the full lifecycle: browse projects and suites, create and update test cases with custom fields, kick off test runs, record pass/fail statuses, and attach files. Handles large datasets by writing JSON exports to disk instead of flooding the context window. Particularly useful if you're tired of context-switching between your IDE and TestRail's web UI during test planning or execution. Built in TypeScript, runs via npx, and works with Claude Desktop, Cursor, Windsurf, or any MCP client. Ships with optional shared steps support and intelligent user lookup fallback for non-admin accounts.
- GitHub stars
- 44
- tools
- 35
- auth
- Secret needed
- transport
- STDIO
- env vars
- 12
- last updated
- Oct 26, 2026
Tools
35 toolsPublic tool metadata for what this MCP can expose to an agent.
query_projectBrowse projects, test suites, and sections to automatically map your QA organization.
Browse projects, test suites, and sections to automatically map your QA organization.
No parameter schema in public metadata yet.
query_suite
No parameter schema in public metadata yet.
mutate_suite
No parameter schema in public metadata yet.
query_section
No parameter schema in public metadata yet.
mutate_section
No parameter schema in public metadata yet.
get_users
No parameter schema in public metadata yet.
get_case
No parameter schema in public metadata yet.
get_cases
No parameter schema in public metadata yet.
add_case
No parameter schema in public metadata yet.
update_case
No parameter schema in public metadata yet.
update_cases
No parameter schema in public metadata yet.
get_case_fields
No parameter schema in public metadata yet.
resolve_case_field
No parameter schema in public metadata yet.
get_case_history
No parameter schema in public metadata yet.
export_cases_for_rag
No parameter schema in public metadata yet.
query_run
No parameter schema in public metadata yet.
mutate_run
No parameter schema in public metadata yet.
query_test
No parameter schema in public metadata yet.
get_tests
No parameter schema in public metadata yet.
get_results
No parameter schema in public metadata yet.
add_results
No parameter schema in public metadata yet.
add_results_for_cases
No parameter schema in public metadata yet.
add_attachment
No parameter schema in public metadata yet.
query_attachment
No parameter schema in public metadata yet.
get_shared_step
No parameter schema in public metadata yet.
get_shared_steps
No parameter schema in public metadata yet.
get_shared_step_history
No parameter schema in public metadata yet.
add_shared_step
No parameter schema in public metadata yet.
update_shared_step
No parameter schema in public metadata yet.
get_statuses
No parameter schema in public metadata yet.
get_priorities
No parameter schema in public metadata yet.
get_templates
No parameter schema in public metadata yet.
get_labels
No parameter schema in public metadata yet.
get_configurations
No parameter schema in public metadata yet.
delete_entity
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
TESTRAIL_INSTANCE_URL*Base URL of your TestRail instance (e.g. https://example.testrail.io)
TESTRAIL_USERNAME*Email address used to authenticate with TestRail
TESTRAIL_API_KEY*secretAPI key for authenticating with the TestRail API
TESTRAIL_ENABLE_SHARED_STEPSEnable shared steps management
TESTRAIL_ENABLE_CASE_HISTORYEnable test case history management
TESTRAIL_ENABLE_RAG_TOOLSEnable Knowledge Base and RAG export tools
TESTRAIL_ALLOW_WRITE_OPERATIONSAllow write operations on TestRail (defaults to true)
TESTRAIL_ALLOW_READ_OPERATIONSAllow read operations on TestRail (defaults to true)
TESTRAIL_ALLOW_DELETE_OPERATIONSAllow delete operations on TestRail (defaults to false)
TESTRAIL_ENABLE_DEPRECATED_TOOLSEnable deprecated tools for backward compatibility (defaults to true)
TESTRAIL_DISABLED_TOOLSComma-separated list of tool names to disable
TESTRAIL_REQUEST_TIMEOUT_MSTimeout in milliseconds for TestRail HTTP requests (defaults to 30000ms)
Readme
🚀 TestRail MCP Server
Connect Claude, Cursor, Windsurf, and VS Code to TestRail — an open-source Model Context Protocol (MCP) server for AI-assisted test management.
Manage TestRail projects, search and create test cases, kick off test runs, record results, and attach files through natural-language conversation with your AI assistant — or from CI/CD with the bundled testrail-cli. Built for QA engineers and AI-assisted test automation.
Details
- Repository
- github.com/uarlouski/testrail-mcp-server
- Package
@uarlouski/testrail-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active