Testrail MCP Server
Rank #1,935io.github.uarlouski/testrail-mcp-server
Model Context Protocol (MCP) server for TestRail platform, enabling LLMs to manage test artifacts.
Testrail MCP Server is a Model Context Protocol (MCP) server published by uarlouski. It ranks #1,935 of 115,591 servers tracked on MCP Toplist, and its repository has 31 GitHub stars. Testrail MCP Server is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 10 tracked versions. It was first listed on Jan 20, 2026 and most recently updated on Aug 30, 2026.
Ranks ahead of 113,656 of 115,591 servers on MCP Toplist.
Use Testrail MCP Server
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add testrail-mcp-server -e "TESTRAIL_INSTANCE_URL=<your TESTRAIL_INSTANCE_URL>" -e "TESTRAIL_USERNAME=<your TESTRAIL_USERNAME>" -e "TESTRAIL_API_KEY=<your TESTRAIL_API_KEY>" -e "TESTRAIL_ENABLE_SHARED_STEPS=<your TESTRAIL_ENABLE_SHARED_STEPS>" -e "TESTRAIL_ENABLE_CASE_HISTORY=<your TESTRAIL_ENABLE_CASE_HISTORY>" -e "TESTRAIL_ENABLE_RAG_TOOLS=<your TESTRAIL_ENABLE_RAG_TOOLS>" -e "TESTRAIL_ALLOW_WRITE_OPERATIONS=<your TESTRAIL_ALLOW_WRITE_OPERATIONS>" -e "TESTRAIL_ALLOW_READ_OPERATIONS=<your TESTRAIL_ALLOW_READ_OPERATIONS>" -e "TESTRAIL_ALLOW_DELETE_OPERATIONS=<your TESTRAIL_ALLOW_DELETE_OPERATIONS>" -e "TESTRAIL_ENABLE_DEPRECATED_TOOLS=<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>" -e "TESTRAIL_DISABLED_TOOLS=<your TESTRAIL_DISABLED_TOOLS>" -- npx -y @uarlouski/testrail-mcp-serverReplace each placeholder with your own value before saving.
[mcp_servers.testrail-mcp-server]
command = "npx"
args = ["-y", "@uarlouski/testrail-mcp-server"]
[mcp_servers.testrail-mcp-server.env]
TESTRAIL_INSTANCE_URL = "<your TESTRAIL_INSTANCE_URL>"
TESTRAIL_USERNAME = "<your TESTRAIL_USERNAME>"
TESTRAIL_API_KEY = "<your TESTRAIL_API_KEY>"
TESTRAIL_ENABLE_SHARED_STEPS = "<your TESTRAIL_ENABLE_SHARED_STEPS>"
TESTRAIL_ENABLE_CASE_HISTORY = "<your TESTRAIL_ENABLE_CASE_HISTORY>"
TESTRAIL_ENABLE_RAG_TOOLS = "<your TESTRAIL_ENABLE_RAG_TOOLS>"
TESTRAIL_ALLOW_WRITE_OPERATIONS = "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>"
TESTRAIL_ALLOW_READ_OPERATIONS = "<your TESTRAIL_ALLOW_READ_OPERATIONS>"
TESTRAIL_ALLOW_DELETE_OPERATIONS = "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>"
TESTRAIL_ENABLE_DEPRECATED_TOOLS = "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>"
TESTRAIL_DISABLED_TOOLS = "<your TESTRAIL_DISABLED_TOOLS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"testrail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<your TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<your TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<your TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<your TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<your TESTRAIL_ENABLE_CASE_HISTORY>",
"TESTRAIL_ENABLE_RAG_TOOLS": "<your TESTRAIL_ENABLE_RAG_TOOLS>",
"TESTRAIL_ALLOW_WRITE_OPERATIONS": "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>",
"TESTRAIL_ALLOW_READ_OPERATIONS": "<your TESTRAIL_ALLOW_READ_OPERATIONS>",
"TESTRAIL_ALLOW_DELETE_OPERATIONS": "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>",
"TESTRAIL_ENABLE_DEPRECATED_TOOLS": "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>",
"TESTRAIL_DISABLED_TOOLS": "<your TESTRAIL_DISABLED_TOOLS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"testrail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<your TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<your TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<your TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<your TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<your TESTRAIL_ENABLE_CASE_HISTORY>",
"TESTRAIL_ENABLE_RAG_TOOLS": "<your TESTRAIL_ENABLE_RAG_TOOLS>",
"TESTRAIL_ALLOW_WRITE_OPERATIONS": "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>",
"TESTRAIL_ALLOW_READ_OPERATIONS": "<your TESTRAIL_ALLOW_READ_OPERATIONS>",
"TESTRAIL_ALLOW_DELETE_OPERATIONS": "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>",
"TESTRAIL_ENABLE_DEPRECATED_TOOLS": "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>",
"TESTRAIL_DISABLED_TOOLS": "<your TESTRAIL_DISABLED_TOOLS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"testrail-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<your TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<your TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<your TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<your TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<your TESTRAIL_ENABLE_CASE_HISTORY>",
"TESTRAIL_ENABLE_RAG_TOOLS": "<your TESTRAIL_ENABLE_RAG_TOOLS>",
"TESTRAIL_ALLOW_WRITE_OPERATIONS": "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>",
"TESTRAIL_ALLOW_READ_OPERATIONS": "<your TESTRAIL_ALLOW_READ_OPERATIONS>",
"TESTRAIL_ALLOW_DELETE_OPERATIONS": "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>",
"TESTRAIL_ENABLE_DEPRECATED_TOOLS": "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>",
"TESTRAIL_DISABLED_TOOLS": "<your TESTRAIL_DISABLED_TOOLS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"testrail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<your TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<your TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<your TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<your TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<your TESTRAIL_ENABLE_CASE_HISTORY>",
"TESTRAIL_ENABLE_RAG_TOOLS": "<your TESTRAIL_ENABLE_RAG_TOOLS>",
"TESTRAIL_ALLOW_WRITE_OPERATIONS": "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>",
"TESTRAIL_ALLOW_READ_OPERATIONS": "<your TESTRAIL_ALLOW_READ_OPERATIONS>",
"TESTRAIL_ALLOW_DELETE_OPERATIONS": "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>",
"TESTRAIL_ENABLE_DEPRECATED_TOOLS": "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>",
"TESTRAIL_DISABLED_TOOLS": "<your TESTRAIL_DISABLED_TOOLS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"testrail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<your TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<your TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<your TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<your TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<your TESTRAIL_ENABLE_CASE_HISTORY>",
"TESTRAIL_ENABLE_RAG_TOOLS": "<your TESTRAIL_ENABLE_RAG_TOOLS>",
"TESTRAIL_ALLOW_WRITE_OPERATIONS": "<your TESTRAIL_ALLOW_WRITE_OPERATIONS>",
"TESTRAIL_ALLOW_READ_OPERATIONS": "<your TESTRAIL_ALLOW_READ_OPERATIONS>",
"TESTRAIL_ALLOW_DELETE_OPERATIONS": "<your TESTRAIL_ALLOW_DELETE_OPERATIONS>",
"TESTRAIL_ENABLE_DEPRECATED_TOOLS": "<your TESTRAIL_ENABLE_DEPRECATED_TOOLS>",
"TESTRAIL_DISABLED_TOOLS": "<your TESTRAIL_DISABLED_TOOLS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.uarlouski%2Ftestrail-mcp-server)<a href="https://mcptoplist.com/server/io.github.uarlouski%2Ftestrail-mcp-server"><img src="https://mcptoplist.com/badge/io.github.uarlouski%2Ftestrail-mcp-server.svg" alt="MCP Toplist: Top 5% of 115,591" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries (2 delisted)
uarlouski
Other servers by uarlouski
View all uarlouski servers →Available versions (10)
| Version | Published |
|---|---|
| 2.6.0 | Aug 30, 2026 |
| 2.5.0 | Aug 27, 2026 |
| 2.4.0 | Aug 20, 2026 |
| 2.3.0 | Aug 13, 2026 |
| 2.2.0 | Jul 26, 2026 |
| 1.10.0 | May 20, 2026 |
| 1.8.0 | May 8, 2026 |
| 1.7.0 | Mar 22, 2026 |
| 1.6.1 | Mar 8, 2026 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains Testrail MCP Server?
- Testrail MCP Server is maintained by uarlouski, which publishes 2 MCP servers (15 total versions) tracked on MCP Toplist.
- Is Testrail MCP Server listed on the Official MCP Registry?
- Yes — Testrail MCP Server is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
- How many versions does Testrail MCP Server have?
- MCP Toplist tracks 10 versions of Testrail MCP Server, most recently published on Aug 30, 2026.
- Where can I find the source code for Testrail MCP Server?
- The source code for Testrail MCP Server is hosted at github.com/uarlouski/testrail-mcp-server.