Testrail Mcp Server

Name: Testrail Mcp Server
Author: uarlouski

by uarlouskicommunityv1.7.0

The TestRail MCP Server is a high-performance Model Context Protocol server that connects AI assistants directly to TestRail, allowing users to manage test cases through natural language interactions.

From the registry: Model Context Protocol (MCP) server for TestRail platform, enabling LLMs to manage test artifacts.

GitHub Repository

Install & configure

Prerequisites

required
TestRail API Key
Navigate to My Settings > API Keys in your TestRail instance

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `testrail-mcp-server` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **TestRail API Key** — Navigate to My Settings > API Keys in your TestRail instance

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@uarlouski/testrail-mcp-server@latest"]
- required environment variables:
  - `TESTRAIL_INSTANCE_URL`: Your TestRail instance URL (example: `https://your-instance.testrail.io`)
  - `TESTRAIL_USERNAME`: Your TestRail account email (example: `<your@email.com>`)
  - `TESTRAIL_API_KEY`: Your TestRail API key (example: `<your-api-key>`)

Note: Full TestRail test case management MCP. Browse projects, create/update test cases, run tests, record results via natural language.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Full TestRail test case management MCP. Browse projects, create/update test cases, run tests, record results via natural language.

Tools (16)

get_projects

List all available active and completed projects in your instance.

get_sections

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

get_cases

Query test cases with advanced filtering and pagination.

get_case

Fetch complete, structured details of a specific test case.

create_case

Seamlessly create a new test case with custom field validation.

update_case

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

update_cases

Execute bulk-updates on multiple test cases simultaneously.

add_run

Generate a new, focused test run directly in TestRail.

get_tests

Retrieve individual tests for a specific test run.

add_results

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

add_results_for_cases

Submits results to a run mapping directly to case_ids.

add_attachment_to_run

Attach logs, files, or zipped artifacts directly to an ongoing test run.

get_statuses

Systematically list all configured test statuses.

Environment variables

TESTRAIL_INSTANCE_URLrequiredYour TestRail instance URL (e.g., https://example.testrail.io)

TESTRAIL_USERNAMErequiredYour TestRail user email address

TESTRAIL_API_KEYrequiredYour TestRail API key

Packages

@uarlouski/testrail-mcp-server

npmv1.7.0transport: stdio

Details

Language: TypeScript
License: Apache-2.0
Released: Mar 22, 2026
Last commit: Mar 22, 2026
Registry name: io.github.uarlouski/testrail-mcp-server

Related Servers

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

31.4k

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

14.4k