@fazorboy/testrail-mcp-server
Model Context Protocol server for TestRail test management
Versions
0.1.2latest0.1.10.1.0Tools 20
get_projects List all TestRail projects with IDs, names, and suite modes. Use this to discover available projects. Optionally filter by completion status. NOT for milestones, suites, runs, or test cases — use the dedicated tools for those.
get_case Get full details for a single test case by its case ID — steps, preconditions, custom fields, priority, type. NOT for listing cases (use get_cases) or run results (use get_results_for_case).
get_run Get detailed info for a specific test run by run ID — name, description, milestone, pass/fail/blocked/untested counts, plan, assignee, and URL. USE THIS for run summary/status. NOT for listing tests in a run (use get_tests) or test results (use get_results_for_run).
get_results_for_run Get test results (pass/fail/status entries) for a specific run by run ID. Filter by status_id. USE THIS when the user asks for results, pass/fail details, or test outcomes of a run. NOT for listing test cases in a run (use get_tests) or run metadata (use get_run).
get_results_for_case Get result history for a specific test case within a specific run. Requires both run_id and case_id. Shows all result entries (pass, fail, retest) over time for one case in one run.
get_tests List all test cases (test instances) associated with a test run by run ID. USE THIS when the user asks
get_plan Get detailed info for a specific test plan by plan ID — entries, associated runs, and configurations. NOT for listing plans (use get_plans) or standalone runs (use get_runs).
get_statuses Get all available test statuses (system + custom) with IDs and labels.
get_priorities Get all available test priorities.
get_case_types Get all available test case types.
get_case_fields Get all test case custom fields and their configurations.
get_result_fields Get all test result custom fields and their configurations.
get_templates Get test case templates for a project.
get_users List TestRail users. Optionally filter by project. Uses disk cache when available.
add_result_for_case Submit a test result for a specific case in a run. Status: 1=Passed, 2=Blocked, 4=Retest, 5=Failed.
add_results_for_cases Bulk submit test results for multiple cases in a run.
add_run Create a new test run in a TestRail project.
close_run Close/archive a test run. This action cannot be undone.
add_case Create a new test case in a section. Supports steps, preconditions, and custom fields.
update_case Update an existing test case. Only provide fields you want to change.
Permissions 2
network medium env_vars low