@siddharth.sharma/testrail-mcp

TestRail MCP server for test case and folder management. This package runs as a stdio MCP server.

Cursor mcp.json setup

{
  "mcpServers": {
    "testrail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@siddharth.sharma/testrail-mcp",
        "stdio"
      ],
      "env": {
        "TEST_RAIL_SECRET_JSON_FILE": "/Users/<you>/.mcp-secrets/testrail-secret.json"
      }
    }
  }
}

Secrets and environment

Preferred option:

• TEST_RAIL_SECRET_JSON_FILE (recommended)
• TEST_RAIL_SECRET_JSON (inline JSON)

Secret JSON shape:

{
  "url": "https://company.testrail.io",
  "username": "[email protected]",
  "password": "replace-me",
  "projectId": 1
}

Supported aliases:

• username can also be user or email
• password can also be apiKey or token

Optional defaults:

• TEST_RAIL_PROJECT_ID
• TEST_RAIL_PROJECT_NAME (used when project id is not set)
• TEST_RAIL_TIMEOUT_MS (default 15000)

Available tools

Utility:

• help: quick usage and safety guide.
• echo: connectivity check.

TestRail operations (one tool per action):

• Projects: testrail_list_projects, testrail_get_project
• Suites: testrail_list_suites, testrail_get_suite
• Sections/Folders: testrail_list_sections, testrail_list_folders, testrail_get_section, testrail_create_section, testrail_update_section
• Cases: testrail_get_case, testrail_list_cases, testrail_create_case, testrail_update_case, testrail_bulk_update_cases, testrail_move_cases_to_section, testrail_delete_case, testrail_get_case_fields

Default project behavior

If TEST_RAIL_PROJECT_ID or TEST_RAIL_PROJECT_NAME is configured, these tools can omit project_id:

• testrail_list_cases, testrail_list_sections, testrail_list_folders
• testrail_create_section, testrail_get_project, testrail_list_suites

If no default project is configured, provide project_id in those tools.