{"_id":"@aqua-cloud/mcp-server","_rev":"8-93902d58493b955d538c73b3de39551b","name":"@aqua-cloud/mcp-server","dist-tags":{"latest":"2.9.2"},"versions":{"2.6.0":{"name":"@aqua-cloud/mcp-server","version":"2.6.0","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.6.0","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"c966b6014b0c7e2dd0b8b111267f31e3aa7b3c88","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.6.0.tgz","fileCount":4,"integrity":"sha512-L2w2l9R7tcym0w9WkGqwzWCq6tTT0AXffqbeK3eNf0rEYBXkVCrRW7zKluxakRIGVQ3F21Oq7XEZFWYu6p3ucQ==","signatures":[{"sig":"MEYCIQDKoFdagmjRSw2c9KV388oJms6GhtsF2s1yeKjcmflNFQIhAPCkK7ov/BqI0LOkp0ReDvMi66AwLJ8Ya/tjDpKr0hMM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":187632},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"b2d42a481959ab5a3339281df798520dc34a03e6","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.6.0_1781192912817_0.45115527034405933","host":"s3://npm-registry-packages-npm-production"}},"2.6.1":{"name":"@aqua-cloud/mcp-server","version":"2.6.1","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.6.1","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"f567f0c488158e44fc973d1e9637ce1c8c30679b","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.6.1.tgz","fileCount":4,"integrity":"sha512-uRBK8xZYJbgTHA0azciN9IJMQqGaJNfUP79F4jk15eVr3LGAWjZ6LPIj9jdop+OF7J2+X6QUXxLIVC0QrrKnJg==","signatures":[{"sig":"MEQCICn3/E22Hy4jmDLAN6NCt/yj5qSWpFAPJmYGqUjjeFgFAiAaoOv/2fbhVnpKq9wif9PeInQ8GTxJVmloICStNI061A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":188037},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"f4cf3b42f7029d93681f47880f221e78de643160","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.6.1_1781194045367_0.5435081376059268","host":"s3://npm-registry-packages-npm-production"}},"2.7.0":{"name":"@aqua-cloud/mcp-server","version":"2.7.0","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.7.0","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"2f79e750de9d11b492bf84bac8d4488f5496cce9","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.7.0.tgz","fileCount":4,"integrity":"sha512-WbmnW9BxsvezWrWhEGwFs5XsM5tN1ctskin6zkQ50mtgrgrT/B4NZkX2vJ+BWO2YwR/juX6+CB0rWM16eAHcoQ==","signatures":[{"sig":"MEUCIFI6U7ocVYM28OP4NOgA+FmAvWoIvfa44SkndWs6oU/8AiEA1UQAVP1PWCCzAwe0kMWK8/b67qYLIQr0XYaq+jcK+hc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":188037},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"3653cbb48c9a9bd937d6ac914bcb483a175820f0","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.7.0_1781197545297_0.7271510856222425","host":"s3://npm-registry-packages-npm-production"}},"2.8.0":{"name":"@aqua-cloud/mcp-server","version":"2.8.0","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.8.0","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"c6abf4064d82a723f827f3fceed068e0e64d6b30","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.8.0.tgz","fileCount":4,"integrity":"sha512-J51xBjMVotiPpdnL5IJ5FVP7UbPFxDzdeeU2EZ/DRk4ZvGHnLCMMKRDnZJ5HV7Z95D88xI4/Oe/gjrhwxbEmzg==","signatures":[{"sig":"MEUCIE5eypNbDKWLZEsiz0wWnmXnYebWwT2PLw+wjlxuZ6WpAiEAsZ5SQUxLKkKSNl5lM4guTdDMBsvTyaEmlHvKrG1PN4A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205225},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"1458e7eec32b4341b09bd04176b3d1c489e63198","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.8.0_1781717627620_0.3482422181903946","host":"s3://npm-registry-packages-npm-production"}},"2.9.0":{"name":"@aqua-cloud/mcp-server","version":"2.9.0","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.9.0","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"99a519c4057c1c20bb43d605759cec863287976f","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.9.0.tgz","fileCount":4,"integrity":"sha512-JiMErZP2z81F619WdnuTVw2x28ZT0GLnouomCGyI4tLueYJonTq5df+SXvPxqUpzL/OCvw7lEUQeZ9xDmx9D7A==","signatures":[{"sig":"MEYCIQDFadLGjYg7oWIzSKyFZf6p67LpSHysxtMnrYXHrHOdZQIhALB8YpA2w308cQtVwZKk8ZoQtduZ03ZhkVTaQcESSTlo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":252043},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"c91572fe3243e1abf625f0c2d3b0208c8126d64a","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.9.0_1783609031291_0.5186094246858781","host":"s3://npm-registry-packages-npm-production"}},"2.9.1":{"name":"@aqua-cloud/mcp-server","version":"2.9.1","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","_id":"@aqua-cloud/mcp-server@2.9.1","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"homepage":"https://aqua-cloud.io","bugs":{"email":"support@aqua-cloud.io"},"os":["darwin","linux","win32"],"bin":{"aqua-mcp-server":"server.js"},"dist":{"shasum":"9e0a1194c05802e3feb3325b4d21fde1c7edf24e","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.9.1.tgz","fileCount":4,"integrity":"sha512-n/WiBCrqU0/rn+nPodWbWNcW10tZOEEFEHeFi8Nr3ew5TC3/nEEjmt2dK0c5gk6cKxUuChnVlJO0Jco3Dc5plA==","signatures":[{"sig":"MEUCIHRJRqIxQNFNHNKj07lyg4iPV7dZ7cKcH1094D35MY2JAiEAnquC5/39v+5IE4EsGpJ9KbsmmN26NS947sYn3A2DbRc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCb7e7veuSkAkbDZGfBdeHwrDjGUmOgDBRtIe0kq04WmAIgQWTIQQTICZs8iWWiIK6QgaPC0fV7d6+2ej7A6RooJmg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":252043},"main":"./server.js","type":"module","engines":{"node":">=20.6.0"},"gitHead":"e942289b367e73f1442aae544837de7cf0f630ea","scripts":{"start":"node server.js"},"_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"deprecated":"Published without the base-URL fix — use 2.9.2","_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.9.1_1790077815721_0.27895979447619323","host":"s3://npm-registry-packages-npm-production"}},"2.9.2":{"os":["darwin","linux","win32"],"_id":"@aqua-cloud/mcp-server@2.9.2","bin":{"aqua-mcp-server":"server.js"},"bugs":{"email":"support@aqua-cloud.io"},"dist":{"shasum":"2624cb4bad0e125117566370c492b9c83cf9a5e1","tarball":"https://registry.npmjs.org/@aqua-cloud/mcp-server/-/mcp-server-2.9.2.tgz","fileCount":4,"integrity":"sha512-zFvlVhbPfDsELmkoTMd8s/RHvnDAwifyUArNSRwm94b1FUnsliEL+kKP7ue2pmzYNtIeLaHhVHzjjK8Dh3aYfQ==","signatures":[{"sig":"MEYCIQCIyDsV9kr25Y/oRFN0Mkf2i29M2X24n4MtBqPlaIoz+QIhALEMoG9BsJ/HkbpkiGVFqLPimnMEE7/XgPlRf2U/75Kq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC3tQAHqESQ5q3UjI+TxWAseB/msz7Jt3IyJGPMcpemKAIhANtgPSkVfQFBji6bwglSyPxyjEIGyRaraFMidV+yXRBe"}],"unpackedSize":259910},"main":"./server.js","name":"@aqua-cloud/mcp-server","type":"module","author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"engines":{"node":">=20.6.0"},"gitHead":"cdd262ecce89e99b226e4e8c6f7f2c6483725678","license":"SEE LICENSE IN LICENSE","scripts":{"start":"node server.js"},"version":"2.9.2","_npmUser":{"name":"martinkoch","email":"martin@aqua-cloud.io"},"homepage":"https://aqua-cloud.io","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"_npmVersion":"11.12.0","description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","directories":{},"maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"_nodeVersion":"24.14.0","dependencies":{"axios":"1.17.0","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_2.9.2_1790078580816_0.08134590337077752"}}},"time":{"created":"2026-06-11T15:48:32.679Z","modified":"2026-09-22T12:03:01.140Z","2.6.0":"2026-06-11T15:48:32.967Z","2.6.1":"2026-06-11T16:07:25.499Z","2.7.0":"2026-06-11T17:05:45.435Z","2.8.0":"2026-06-17T17:33:47.780Z","2.9.0":"2026-07-09T14:57:11.426Z","2.9.1":"2026-09-22T11:50:15.873Z","2.9.2":"2026-09-22T12:03:00.888Z"},"bugs":{"email":"support@aqua-cloud.io"},"author":{"url":"https://aqua-cloud.io","name":"aqua cloud GmbH","email":"support@aqua-cloud.io"},"license":"SEE LICENSE IN LICENSE","homepage":"https://aqua-cloud.io","keywords":["mcp","model-context-protocol","aqua","claude","ai"],"description":"MCP server for Aqua Cloud - bridges Claude with Aqua's REST API","maintainers":[{"name":"martinkoch","email":"martin@aqua-cloud.io"}],"readme":"# Aqua MCP Server\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server for [Aqua Cloud](https://www.aqua-cloud.io/) — connect Claude and other MCP-capable AI assistants to your Aqua test management platform.\n\nManage requirements, defects, test cases, and test scenarios in natural language: create items, update statuses, add test steps, link relationships, search projects, and more — 26 tools in total.\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add aqua \\\n  --env AQUA_URL=https://your-instance.aqua-cloud.io/aquaWebNG \\\n  --env AQUA_USER=your-username \\\n  --env AQUA_PASS=your-password \\\n  --env AQUA_PROJECT_ID=123 \\\n  -- npx -y @aqua-cloud/mcp-server\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"aqua\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aqua-cloud/mcp-server\"],\n      \"env\": {\n        \"AQUA_URL\": \"https://your-instance.aqua-cloud.io/aquaWebNG\",\n        \"AQUA_USER\": \"your-username\",\n        \"AQUA_PASS\": \"your-password\",\n        \"AQUA_PROJECT_ID\": \"123\"\n      }\n    }\n  }\n}\n```\n\n> Claude Desktop users can alternatively install the one-click extension: [download `aqua.mcpb`](https://github.com/aqua-cloud-gmbh/aqua-mcp-desktop-extension/releases/latest/download/aqua.mcpb), then double-click it (or drag it into Claude Desktop → Settings → Extensions).\n\n### Configuration\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `AQUA_URL` | yes | Your Aqua instance **base** URL — the address before `/api`, e.g. `https://app.aqua-cloud.io/aquaWebNG`. Not a page URL: nothing after `/aquaWebNG` (no `/Login`, `?returnUrl=…`, `#/…`) |\n| `AQUA_USER` | yes | Aqua username |\n| `AQUA_PASS` | yes | Aqua password |\n| `AQUA_PROJECT_ID` | no | Default project for project-scoped tools |\n\n> **Every tool fails, or returns an HTML page?** `AQUA_URL` is almost always a page URL copied from the browser. The server reports this as a configuration error (with the corrected URL when it can be derived) — fix the value and restart.\n\n## What can it do?\n\n- **Items** — create, read, update requirements, defects, test cases, and test scenarios; statuses, fields, assignments, comments\n- **Test management** — read and add test steps, link items (e.g. test case ⇄ requirement), inspect item history\n- **Search** — filtered project listings and global search across all projects\n- **Attachments** — list, upload, download, delete\n- **Embedded images** — images in rich-text descriptions are surfaced per item and can be downloaded locally for the assistant to view (`downloadImages` parameter)\n- **Projects** — list projects and users, switch the active project\n- **Built-in guide** — an `aqua-guide` MCP prompt that teaches the assistant how to use the tools effectively\n\nAsk your assistant things like:\n\n> \"Create a defect in project 123: login button unresponsive on Safari, high priority.\"\n\n> \"List all open requirements assigned to me and add a test case for each.\"\n\n## Requirements\n\n- Node.js ≥ 20.6.0\n- An Aqua Cloud account with API access\n\n## Prefer a CLI?\n\nThe same functionality is available as a command-line tool — [`@aqua-cloud/cli`](https://www.npmjs.com/package/@aqua-cloud/cli) — for AI agents that work better with shell commands than MCP.\n\n## License\n\nProprietary software © [aqua cloud GmbH](https://aqua-cloud.io). See the LICENSE file for terms. Use requires a valid Aqua Cloud subscription.\n\n## Support\n\n- Email: [support@aqua-cloud.io](mailto:support@aqua-cloud.io)\n- Documentation: [docs.aqua-cloud.io](https://docs.aqua-cloud.io)\n","readmeFilename":"README.md"}