{"id":28165179,"url":"https://github.com/bun913/mcp-testrail","last_synced_at":"2026-04-18T02:11:51.187Z","repository":{"id":285053859,"uuid":"956929414","full_name":"bun913/mcp-testrail","owner":"bun913","description":"Testrail MCP Server","archived":false,"fork":false,"pushed_at":"2026-04-11T11:13:42.000Z","size":1329,"stargazers_count":32,"open_issues_count":1,"forks_count":19,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-11T13:04:47.165Z","etag":null,"topics":["mcp","testrail"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@bun913/mcp-testrail?activeTab=readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bun913.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["bun913"]}},"created_at":"2025-03-29T06:25:34.000Z","updated_at":"2026-04-11T11:12:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"d0c94999-c1ca-441d-977b-422c99169b57","html_url":"https://github.com/bun913/mcp-testrail","commit_stats":null,"previous_names":["bun913/mcp-testrail"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/bun913/mcp-testrail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bun913%2Fmcp-testrail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bun913%2Fmcp-testrail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bun913%2Fmcp-testrail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bun913%2Fmcp-testrail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bun913","download_url":"https://codeload.github.com/bun913/mcp-testrail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bun913%2Fmcp-testrail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31953517,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","testrail"],"created_at":"2025-05-15T12:11:03.985Z","updated_at":"2026-04-18T02:11:51.170Z","avatar_url":"https://github.com/bun913.png","language":"TypeScript","funding_links":["https://github.com/sponsors/bun913"],"categories":[],"sub_categories":[],"readme":"# TestRail MCP Server\n\nThis Model Context Protocol (MCP) server provides tools for interacting with TestRail directly from Claude AI and other MCP-supported clients like Cursor. It allows you to manage test cases, projects, suites, runs, and more without leaving your conversation with the AI.\n\n## Available Tools\n\nThe TestRail MCP server provides the following tools:\n\n| Category | Tools |\n|----------|-------|\n| **Projects** | `getProjects`, `getProject` |\n| **Suites** | `getSuites`, `getSuite`, `addSuite`, `updateSuite` |\n| **Cases** | `getCase`, `getCases`, `addCase`, `updateCase`, `deleteCase`, `getCaseTypes`, `getCaseFields`, `copyToSection`, `moveToSection`, `getCaseHistory`, `updateCases`, `addBdd`, `getBdd` |\n| **Sections** | `getSection`, `getSections`, `addSection`, `moveSection`, `updateSection`, `deleteSection` |\n| **Runs** | `getRuns`, `getRun`, `addRun`, `updateRun` |\n| **Tests** | `getTests`, `getTest` |\n| **Results** | `getResults`, `getResultsForCase`, `getResultsForRun`, `addResultForCase`, `addResultsForCases` |\n| **Plans** | `getPlans` |\n| **Milestones** | `getMilestones` |\n| **Shared Steps** | `getSharedSteps` |\n\n## Usage\n\nYou can connect this MCP server by setting like the below. This method uses `npx` to automatically download and run the latest version of the package, eliminating the need for local installation.\n\n```json\n// Example configuration using npx\n{\n  \"mcpServers\": {\n    \"testrail\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bun913/mcp-testrail@latest\"],\n      \"env\": {\n        \"TESTRAIL_URL\": \"https://your-instance.testrail.io\", // Replace with your TestRail URL\n        \"TESTRAIL_USERNAME\": \"your-email@example.com\", // Replace with your TestRail username\n        \"TESTRAIL_API_KEY\": \"YOUR_API_KEY\" // Replace with your TestRail API key\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n- **`spawn node ENOENT` errors**: Ensure that Node.js is properly installed and in your PATH.\n- **Authentication issues**: Check your TestRail API credentials.\n- **Your conversation is too long**: Use `limit` and `offset` parameters for test cases and sections to paginate results.\n- **HTTP 400 errors when creating/updating test cases**: TestRail projects have different templates, custom fields, and required fields. This MCP server passes your parameters directly to the TestRail API — it does not validate or transform them. If you encounter 400 errors, define your project's rules in `CLAUDE.md` or `AGENTS.md` so the LLM sends the correct parameters. For example:\n\n  ```markdown\n  # TestRail Rules for This Project\n  - Project ID: 1\n  - Always use template 2 (Separated Steps) when creating test cases\n    - Use `customStepsSeparated` (array of step objects)\n    - Do NOT send `customSteps` or `customExpected` with template 2\n  - Required custom fields: custom_automation_type (default: 0)\n  - Call `getCaseFields` at the start of a session to check available fields\n  ```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Acknowledgements\n\n- [TestRail API](https://docs.testrail.techmatrix.jp/testrail/docs/702/api/)\n- [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbun913%2Fmcp-testrail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbun913%2Fmcp-testrail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbun913%2Fmcp-testrail/lists"}