{"_id":"@edgrmaulana/mcp-testrail","_rev":"6-900167c94796b83bd0f1b31a1fc88894","name":"@edgrmaulana/mcp-testrail","dist-tags":{"latest":"0.24.0"},"versions":{"0.21.0":{"name":"@edgrmaulana/mcp-testrail","version":"0.21.0","author":{"name":"edgrmaulana"},"license":"MIT","_id":"@edgrmaulana/mcp-testrail@0.21.0","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"homepage":"https://github.com/edgrmaulana/mcp-testrail","bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"bin":{"mcp-testrail":"dist/stdio.js"},"dist":{"shasum":"bc986a41b01a82e24e42def39829aeea643c22fb","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.21.0.tgz","fileCount":120,"integrity":"sha512-JAaros4BBSKkoEDgyxhdPzwwwS34JLnTLrqhhuGwwUHWW/g/lc5JR29S4JWXe2IStfcsxyq2Pe2tozJoQ72VIg==","signatures":[{"sig":"MEUCIQCiOXzhTEx/oRs8f1c/9InCr4JoLE89FoihGOyc4LkdqQIgWMO+9kLZ4Njq7qAZ7IsEL6o4xlikk9FbnQktxpaqpNU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":408031},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"c58baf20a4d184b3abeef6fa6d7691910257b007","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","playwright-cli":"playwright-cli","prepublishOnly":"npm run build"},"_npmUser":{"name":"edgrmaulana","email":"callmethoriq@gmail.com"},"repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"11.15.0","description":"This 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 conversati","directories":{},"_nodeVersion":"24.11.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@playwright/cli":"^0.1.1","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-testrail_0.21.0_1785946061963_0.8183492371876582","host":"s3://npm-registry-packages-npm-production"}},"0.22.0":{"name":"@edgrmaulana/mcp-testrail","version":"0.22.0","author":{"name":"edgrmaulana"},"license":"MIT","_id":"@edgrmaulana/mcp-testrail@0.22.0","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"homepage":"https://github.com/edgrmaulana/mcp-testrail","bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"bin":{"mcp-testrail":"dist/stdio.js"},"dist":{"shasum":"0a595a2c06d28e8d3e5bd1de7df3297744431168","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.22.0.tgz","fileCount":120,"integrity":"sha512-j4J2jfnXwEwhu40/UCYDzWaLTltWTSeVnpU7QWpByXIAsfEwoM+2OF09DCw88K4soSxoRyWl1/uFjLCcxg8ABA==","signatures":[{"sig":"MEUCIBgllV5rEKhhOBZnM+5z4jCds2n3RnbJiSeHQ06kBQD2AiEAqet9UpZ1OPYNg9M1iQcEIYcb3SwTninCcQezgPt/Rho=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@edgrmaulana%2fmcp-testrail@0.22.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":408031},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"e8117c94b603b6b67bcb5c8d23c8e83b0c7e2879","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","playwright-cli":"playwright-cli","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6a156a3d-2751-4101-89f8-9eb289146b14"}},"repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"12.0.2","description":"This 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 conversati","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@playwright/cli":"^0.1.1","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-testrail_0.22.0_1785946852194_0.04559516010463338","host":"s3://npm-registry-packages-npm-production"}},"0.22.1":{"name":"@edgrmaulana/mcp-testrail","version":"0.22.1","author":{"name":"edgrmaulana"},"license":"MIT","_id":"@edgrmaulana/mcp-testrail@0.22.1","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"homepage":"https://github.com/edgrmaulana/mcp-testrail","bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"bin":{"mcp-testrail":"dist/stdio.js"},"dist":{"shasum":"0d00b2114a583bf24f5150b663bdb6a9e79afc17","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.22.1.tgz","fileCount":120,"integrity":"sha512-2B5Dxo/VvgVtQnvEVJXAzFdgeo47aVcXR4hWdzP51TPGHbnKYOdc85hP3wk9lR/myAsrSBMDv4EedRGnZDdLOg==","signatures":[{"sig":"MEYCIQDHlpWm3CxQAkkuizUdjhf9aSZSS6CLD6Md2bvVp5v1igIhANvu44PIWfPerc6fqHt8sl9o/+OpUJAdUSIIqTeX7rn8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@edgrmaulana%2fmcp-testrail@0.22.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":404679},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"1e11c7e10ea0d60dc7f7896e9909f9ed686890bb","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6a156a3d-2751-4101-89f8-9eb289146b14"}},"repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"12.0.2","description":"This 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 conversati","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-testrail_0.22.1_1785949666965_0.4646840496152098","host":"s3://npm-registry-packages-npm-production"}},"0.23.0":{"name":"@edgrmaulana/mcp-testrail","version":"0.23.0","author":{"name":"edgrmaulana"},"license":"MIT","_id":"@edgrmaulana/mcp-testrail@0.23.0","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"homepage":"https://github.com/edgrmaulana/mcp-testrail","bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"bin":{"mcp-testrail":"dist/stdio.js"},"dist":{"shasum":"e4b17836a53698ed4b09e991d4d49d6cad5c0ea7","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.23.0.tgz","fileCount":120,"integrity":"sha512-qiHZVNm/4tciEzarb9L4IGuQPZu6AlmRu/uBecqIUr1mwpCG/O/bKQ7ZukiQBD4mjIBTe5lZ+hH6FlXms3nGlg==","signatures":[{"sig":"MEYCIQDr2UOt73b+7a2ZyOPNqhOXGaBIPbhvoH5Ghl3ECBGSHAIhANjAUpMFGLAVhl9cvUsCgQ3fNnBW9woH/Jm3tad7vdNy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCzBVXOAtZ9Emx19ctmyylY8rvvvV2Eb8JYv0cOJIniQwIhALgyu6lCgGp8+OfBta3xCOsutU+2j9zIU5zlQTc8iVb4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@edgrmaulana%2fmcp-testrail@0.23.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":395869},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"4115bf60f6c64266da7e7faa77acd89a47ba83e6","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"6a156a3d-2751-4101-89f8-9eb289146b14"}},"repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"12.2.0","description":"This 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 conversati","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-testrail_0.23.0_1790968902642_0.4805871296844806","host":"s3://npm-registry-packages-npm-production"}},"0.23.1":{"name":"@edgrmaulana/mcp-testrail","version":"0.23.1","author":{"name":"edgrmaulana"},"license":"MIT","_id":"@edgrmaulana/mcp-testrail@0.23.1","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"homepage":"https://github.com/edgrmaulana/mcp-testrail","bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"bin":{"mcp-testrail":"dist/stdio.js"},"dist":{"shasum":"b483a77d3f1c58725942aeb1d807cda1a25ce278","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.23.1.tgz","fileCount":120,"integrity":"sha512-rl02X64QNW2zffCeOYfn4ckdWOlo8Qc7z0xbnS0Pj9bGZfhNJdHNMQDxeJr7K/I3cKAUMdsT922tgMzDNsoh0g==","signatures":[{"sig":"MEUCIQCYJ84tJpVr8flH57pXwYuYvH//WIy8w/Iin/6nJgeHFgIgTXbvLe9IqxNONo6Nwzcf93Jhilxseu16Q+QiREw2hak=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCyFnzME9OHog1091Fy746MhQqJXavjhJ0f9e1j53PSNwIgZlGWWecSA0ymeFYZ0vEQxx7u7hIUzn5uFkX6XAwtkzg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@edgrmaulana%2fmcp-testrail@0.23.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":400120},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"8809bf94272693e62bebf881af3c6d7f4c29f7e8","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"6a156a3d-2751-4101-89f8-9eb289146b14"}},"repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"12.2.0","description":"This 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 conversati","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-testrail_0.23.1_1790971587399_0.0335919331688459","host":"s3://npm-registry-packages-npm-production"}},"0.24.0":{"_id":"@edgrmaulana/mcp-testrail@0.24.0","bin":{"mcp-testrail":"dist/stdio.js"},"bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"dist":{"shasum":"2ed38954c1aa8afb0be674263d37572db77da67b","tarball":"https://registry.npmjs.org/@edgrmaulana/mcp-testrail/-/mcp-testrail-0.24.0.tgz","fileCount":120,"integrity":"sha512-KLvG8nJLaZkrEIUI7tmPdpt4SeCSE8q4x1djBY4qVZj6S/3Lihi+7+mR0RVIpKIUO6lvfUMB21lGVA1uHQYigg==","signatures":[{"sig":"MEUCIQCkXJ8nzZ4BqXLRsYipKa9joXUHni7rwbGF5JHeEKmI7AIgB0Htv7GZdfk3b1LFsHwsE1On8XAIH1/Sw6pw+QAg8o8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCsCgk0F2JGMGQEA6Ry2Xf4JRA2eRESxkl+heV4iPgwZwIhAIT93kGEawgr5CSEbINq8ZdkZElISawR2fJq/R91SjgZ"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@edgrmaulana%2fmcp-testrail@0.24.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":402843},"main":"dist/index.js","name":"@edgrmaulana/mcp-testrail","type":"module","types":"dist/index.d.ts","author":{"name":"edgrmaulana"},"engines":{"node":">=20.18.1"},"gitHead":"803d3b7b5f4ba614ababe5d684a901b46c7c17ce","license":"MIT","private":false,"scripts":{"test":"vitest ./test --reporter=verbose --coverage","build":"tsc","format":"biome format --write ./src","test:ci":"vitest run ./test --silent --coverage --reporter=verbose","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"version":"0.24.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"6a156a3d-2751-4101-89f8-9eb289146b14"}},"homepage":"https://github.com/edgrmaulana/mcp-testrail","repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"_npmVersion":"12.2.0","description":"This 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 conversati","directories":{},"maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^3.24.2","axios":"^1.16.0","dotenv":"^16.4.5","form-data":"^4.0.0","@biomejs/biome":"^1.9.4","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8","typescript":"~5.7.2","@types/node":"^22.13.14","@vitest/coverage-v8":"^4.1.8"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-testrail_0.24.0_1791017588575_0.3477778909705025"}}},"time":{"created":"2026-08-05T16:07:41.796Z","modified":"2026-10-03T08:53:08.949Z","0.21.0":"2026-08-05T16:07:42.093Z","0.22.0":"2026-08-05T16:20:52.364Z","0.22.1":"2026-08-05T17:07:47.153Z","0.23.0":"2026-10-02T19:21:42.734Z","0.23.1":"2026-10-02T20:06:27.505Z","0.24.0":"2026-10-03T08:53:08.654Z"},"bugs":{"url":"https://github.com/edgrmaulana/mcp-testrail/issues"},"author":{"name":"edgrmaulana"},"license":"MIT","homepage":"https://github.com/edgrmaulana/mcp-testrail","repository":{"url":"git+https://github.com/edgrmaulana/mcp-testrail.git","type":"git"},"description":"This 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 conversati","maintainers":[{"name":"edgrmaulana","email":"callmethoriq@gmail.com"}],"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\": [\"@edgrmaulana/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        \"TESTRAIL_MAX_RETRIES\": \"3\" // Optional: 429 retries, defaults to 3, 0 disables\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n- **`spawn npx ENOENT` / `spawn node ENOENT` (commonly on macOS)**: your MCP host (Cursor, Claude Code, Claude Desktop, …) cannot find `npx` or `node` at process-spawn time. The chat UI usually surfaces this as a generic \"MCP server doesn't work\" with no useful detail; the per-server log is the diagnostic source of truth.\n\n  **Why it happens on macOS:** GUI apps launched from the Dock, Spotlight, or Finder inherit launchd's minimal `PATH` (`/usr/bin:/bin:/usr/sbin:/sbin`). If you installed Node via a version manager (`nvm`, `asdf`, `mise`, `fnm`, `Volta`) or Apple Silicon Homebrew (`/opt/homebrew/bin/`), `npx` lives outside that PATH — only your shell startup file (`~/.zshrc` / `~/.bashrc`) adds it. Your terminal works because the shell ran the startup file; the GUI-app process never did.\n\n  **Diagnose** by checking the per-server log for `spawn npx ENOENT`:\n\n  - **Cursor:** `~/Library/Application Support/Cursor/logs/<session>/window<N>/exthost/anysphere.cursor-mcp/MCP <server>.log`\n  - **Claude Code / Claude Desktop:** `~/Library/Logs/Claude/`\n\n  **Fix** by replacing `\"npx\"` in your MCP config with its absolute path. Run `which npx` in your normal terminal:\n\n  ```text\n  /Users/you/.nvm/versions/node/v24.15.0/bin/npx   # nvm\n  /opt/homebrew/bin/npx                            # Apple Silicon Homebrew\n  /usr/local/bin/npx                               # Intel Homebrew / system Node\n  ```\n\n  Then update your MCP config:\n\n  ```json\n  {\n    \"mcpServers\": {\n      \"testrail\": {\n        \"command\": \"/Users/you/.nvm/versions/node/v24.15.0/bin/npx\",\n        \"args\": [\"@edgrmaulana/mcp-testrail@latest\"],\n        \"env\": {\n          \"TESTRAIL_URL\": \"https://your-instance.testrail.io\",\n          \"TESTRAIL_USERNAME\": \"your-email@example.com\",\n          \"TESTRAIL_API_KEY\": \"YOUR_API_KEY\"\n        }\n      }\n    }\n  }\n  ```\n\n  Restart your MCP client after the change. The same fix applies to every `npx`-launched MCP server — if `mcp-testrail` is failing for this reason, your other `npx`-launched servers are likely failing too.\n\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\nThis project is a fork of [bun913/mcp-testrail](https://github.com/bun913/mcp-testrail), originally created and maintained by [bun913](https://github.com/bun913). Full credit for the original work goes to the upstream author and contributors. This fork continues the project under [@edgrmaulana/mcp-testrail](https://github.com/edgrmaulana/mcp-testrail).\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","readmeFilename":"README.md"}