Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TESTRAIL_URL | Yes | The URL of your TestRail instance (e.g., https://your-domain.testrail.io) | |
| TESTRAIL_API_KEY | Yes | Your TestRail API key (can be generated from My Settings > API Keys) | |
| TESTRAIL_USERNAME | Yes | Your TestRail email address |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_projects | Get all TestRail projects |
| get_project | Get a specific project by ID |
| get_suites | Get all test suites for a project |
| get_suite | Get a specific test suite by ID |
| add_suite | Create a new test suite |
| update_suite | Update an existing test suite |
| get_sections | Get all sections for a project/suite |
| get_section | Get a specific section by ID |
| add_section | Create a new section |
| update_section | Update an existing section |
| delete_section | Delete a section |
| move_section | Move a section to another parent or position |
| get_cases | Get test cases for a project/suite |
| get_case | Get a specific test case by ID |
| add_case | Create a new test case |
| update_case | Update an existing test case |
| delete_case | Delete a test case |
| get_case_types | Get all available test case types |
| get_case_fields | Get all available test case fields |
| get_history_for_case | Get the edit history for a test case |
| copy_cases_to_section | Copy test cases to another section |
| move_cases_to_section | Move test cases to another section |
| delete_cases | Delete multiple test cases |
| get_runs | Get test runs for a project |
| get_run | Get a specific test run by ID |
| add_run | Create a new test run |
| update_run | Update an existing test run |
| close_run | Close a test run |
| delete_run | Delete a test run |
| get_tests | Get tests for a test run |
| get_test | Get a specific test by ID |
| get_results | Get results for a test |
| get_results_for_case | Get results for a test case in a run |
| get_results_for_run | Get results for a test run |
| add_result | Add a test result |
| add_result_for_case | Add a test result for a specific case in a run |
| add_results_for_cases | Add multiple test results for cases in a run |
| add_results | Add multiple test results by test IDs |
| get_plans | Get test plans for a project |
| get_plan | Get a specific test plan by ID |
| add_plan | Create a new test plan |
| add_plan_entry | Add test runs to a test plan |
| add_run_to_plan_entry | Add a test run to an existing plan entry |
| update_plan | Update an existing test plan |
| update_plan_entry | Update a test plan entry |
| update_run_in_plan_entry | Update a test run inside a plan entry |
| close_plan | Close a test plan |
| delete_plan | Delete a test plan |
| delete_plan_entry | Delete a test plan entry |
| delete_run_from_plan_entry | Delete a test run from a plan entry |
| get_milestones | Get milestones for a project |
| get_milestone | Get a specific milestone by ID |
| add_milestone | Create a new milestone |
| update_milestone | Update an existing milestone |
| delete_milestone | Delete a milestone |
| get_user | Get a user by ID |
| get_current_user | Get the current authenticated user |
| get_user_by_email | Get a user by email address |
| get_users | Get all users (optionally filtered by project) |
| get_statuses | Get all available test result statuses |
| get_case_statuses | Get all available test case statuses (Enterprise) |
| get_priorities | Get all available test case priorities |
| get_templates | Get all templates for a project |
| get_configs | Get all configurations for a project |
| get_result_fields | Get all available result custom fields |
| add_attachment_to_case | Add an attachment to a test case |
| add_attachment_to_result | Add an attachment to a test result |
| add_attachment_to_run | Add an attachment to a test run |
| add_attachment_to_plan | Add an attachment to a test plan |
| add_attachment_to_plan_entry | Add an attachment to a test plan entry |
| get_attachment | Get/download an attachment by ID |
| get_attachments_for_case | Get all attachments for a test case |
| get_attachments_for_test | Get all attachments for a test |
| get_attachments_for_run | Get all attachments for a test run |
| get_attachments_for_plan | Get all attachments for a test plan |
| get_attachments_for_plan_entry | Get all attachments for a test plan entry |
| delete_attachment | Delete an attachment |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |