Available Tools - skindyk/testrail-mcp-server GitHub Wiki

The TestRail MCP Server provides 119 tools covering all TestRail API endpoints with complete feature coverage.

Core Features

Projects

  • get_projects - Retrieve all projects with filtering
  • get_project - Get detailed project information
  • add_project - Create new projects
  • update_project - Modify project settings
  • delete_project - Remove projects

Test Suites

  • get_suites - List all test suites in a project
  • get_suite - Get detailed suite information
  • add_suite - Create new test suites
  • update_suite - Modify suite properties
  • delete_suite - Remove test suites

Test Cases

  • get_cases - Retrieve test cases with advanced filtering
  • get_case - Get detailed test case information
  • add_case - Create new test cases
  • update_case - Modify test case properties
  • delete_case - Remove test cases
  • get_history_for_case - View test case edit history
  • copy_cases_to_section - Copy test cases between sections
  • update_cases - Bulk update multiple test cases
  • move_cases_to_section - Move test cases to different sections
  • delete_cases - Bulk delete multiple test cases

Test Runs

  • get_runs - List test runs with filtering
  • get_run - Get detailed test run information
  • add_run - Create new test runs
  • update_run - Modify test run properties
  • close_run - Close and archive test runs
  • delete_run - Remove test runs

Test Results

  • get_results - Get results for a specific test
  • get_results_for_case - Get results for a test case in a run
  • get_results_for_run - Get all results for a test run
  • add_result - Add single test result
  • add_result_for_case - Add result for specific test case
  • add_results - Add multiple test results
  • add_results_for_cases - Add results for multiple test cases

Test Plans

  • get_plans - List test plans with filtering
  • get_plan - Get detailed test plan information
  • add_plan - Create new test plans
  • update_plan - Modify test plan properties
  • close_plan - Close and archive test plans
  • delete_plan - Remove test plans
  • add_plan_entry - Add test runs to plans
  • update_plan_entry - Modify plan entries
  • delete_plan_entry - Remove plan entries
  • add_run_to_plan_entry - Add runs to plan entries
  • update_run_in_plan_entry - Update runs in plan entries
  • delete_run_from_plan_entry - Remove runs from plan entries

Sections

  • get_sections - List all sections in a project/suite
  • get_section - Get detailed section information
  • add_section - Create new sections
  • update_section - Modify section properties
  • move_section - Move sections in hierarchy
  • delete_section - Remove sections

Milestones

  • get_milestones - List project milestones
  • get_milestone - Get detailed milestone information
  • add_milestone - Create new milestones
  • update_milestone - Modify milestone properties
  • delete_milestone - Remove milestones

User Management & Configuration

Users

  • get_users - List users with project access
  • get_user - Get detailed user information
  • get_user_by_email - Find user by email address

Case Fields

  • get_case_fields - List all custom case fields
  • add_case_field - Create new custom case fields

System Configuration

  • get_case_types - List available case types
  • get_priorities - List priority levels
  • get_statuses - List result statuses
  • get_templates - List case templates
  • get_result_fields - List custom result fields
  • get_roles - List user roles (TestRail 7.3+)

Advanced Features

Reporting

  • get_reports - List available report templates
  • run_report - Execute report templates
  • get_cross_project_reports - List cross-project reports
  • run_cross_project_report - Execute cross-project reports

Attachments

  • get_attachments_for_case - List case attachments
  • get_attachments_for_plan - List plan attachments
  • get_attachments_for_plan_entry - List plan entry attachments
  • get_attachments_for_result - List result attachments
  • get_attachments_for_run - List run attachments
  • get_attachments_for_test - List test attachments
  • add_attachment_to_case - Upload files to test cases
  • add_attachment_to_plan - Upload files to test plans
  • add_attachment_to_plan_entry - Upload files to plan entries
  • add_attachment_to_result - Upload files to test results
  • add_attachment_to_run - Upload files to test runs
  • get_attachment - Download attachment files
  • delete_attachment - Remove attachments

BDD Integration

  • get_bdd - Export test cases as BDD scenarios
  • add_bdd - Import BDD scenarios from Gherkin

Configurations

  • get_configs - List test configurations
  • add_config_group - Create configuration groups
  • add_config - Create individual configurations
  • update_config_group - Modify configuration groups
  • update_config - Modify configurations
  • delete_config_group - Remove configuration groups
  • delete_config - Remove configurations

Tests

  • get_tests - List tests in a test run
  • get_test - Get detailed test information
  • update_test - Modify test properties
  • update_tests - Bulk update multiple tests

Labels

  • get_labels - List project labels
  • get_label - Get detailed label information
  • update_label - Modify label properties

Shared Steps

  • get_shared_steps - List shared step sets
  • get_shared_step - Get detailed shared step information
  • get_shared_step_history - View shared step edit history
  • add_shared_step - Create new shared step sets
  • update_shared_step - Modify shared step sequences
  • delete_shared_step - Remove shared step sets

Datasets & Variables (Enterprise)

  • get_datasets - List project datasets
  • get_dataset - Get detailed dataset information
  • add_dataset - Create new datasets
  • update_dataset - Modify dataset properties
  • delete_dataset - Remove datasets
  • get_variables - List project variables
  • add_variable - Create new variables
  • update_variable - Modify variable properties
  • delete_variable - Remove variables

Enterprise Features

Groups

  • get_groups - List user groups
  • get_group - Get detailed group information
  • add_group - Create new user groups
  • update_group - Modify group membership
  • delete_group - Remove user groups

Enhanced Capabilities

Advanced Filtering

  • Support for complex filters on cases, runs, results, and other entities
  • Date range filtering with UNIX timestamps
  • Multi-value filtering for priorities, statuses, users, etc.
  • Text search capabilities across titles and content

Bulk Operations

  • Multiple result additions with single API calls
  • Case copying between sections and suites
  • Batch operations for efficiency
  • Bulk updates with consistent values

Field Filtering

  • Dynamic field selection to reduce response size
  • Custom field detection per project
  • Performance optimization for large datasets
  • Invalid field validation with helpful error messages

Soft Deletion

  • Proper handling of soft-deleted entities where supported
  • Preview mode for deletion operations
  • Impact analysis before permanent removal

Version Requirements

  • Clear indication of TestRail version requirements for specific features
  • Compatibility notes for enterprise vs standard editions
  • Feature availability based on TestRail configuration

Tool Categories Summary

Category Tool Count Description
Core CRUD Operations 35 Basic create, read, update, delete operations
Advanced Filtering 15 Complex filtering and search capabilities
Bulk Operations 12 Batch processing and bulk updates
File Management 11 Attachment upload, download, and management
Enterprise Features 18 Advanced features for enterprise users
Configuration 13 System configuration and customization
Reporting 8 Report generation and execution
Integration 7 BDD, API integration, and external tools

Total: 119 Tools providing complete TestRail API coverage