Octopus Deploy MCP Server
Octopus Deploy infrastructure inspection and diagnostic tools for AI assistants.
Data last scanned today · Reviewed today
Overview
This MCP server bridges your AI tools with Octopus Deploy, enabling your assistant to inspect, query, and diagnose release and deployment operations. It leverages stable APIs to provide real-time visibility into your delivery pipeline, turning your AI agent into an active participant in your software operations.
Our verdict
This project carries a high risk level with a security score of 48/100. It is currently marked as deprecated by the maintainers in favor of the Remote MCP Server integrated into Octopus Server 2026.3 and later. Because the authentication method has not yet been reviewed and the server is community-maintained rather than the official vendor solution, users should migrate to the native platform features rather than relying on this bridge.
- Six direct dependencies minimize the software supply chain surface.
- Actively maintained repository with a commit as recent as last week.
- Compatible with stable APIs dating back to version 2021.1.
- Officially deprecated in favor of native Octopus 2026.3 features.
- Community-maintained project rather than an official vendor release.
- Security checks for authentication and read-only modes remain unreviewed.
Setup
{
"mcpServers": {
"octopusdeploy-mcp-server": {
"args": [
"-y",
"@octopusdeploy/mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| get_deployment_from_url | Get deployment details from deployment URL (returns taskId for follow-up) | low |
| get_task_from_url | Get task details and logs from task URL | low |
| grep_task_log | Search a task's activity log without fetching the full body. | low |
| list_spaces | List all spaces in the Octopus Deploy instance | low |
| list_environments | List all environments in a given space | low |
| grep_llms_txt | Search the Octopus API catalog (octopus://api/llms.txt) with grep-style semantics | low |
| execute | Structured REST backstop. Reaches any Octopus REST endpoint under /api. | high |
| list_projects | List all projects in a given space | low |
| deploy_release | Deploy a release to environments (supports both tenanted and untenanted deployments) | medium |
| list_deployments | List deployments in a space with optional filtering | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›Is this MCP server currently maintained?
No, this server is deprecated. Users should use the Remote MCP Server available in Octopus Server 2026.3 and later.
›What are the minimum software requirements for a Node-based installation?
You need Node.js version 20.0.0 or higher, an Octopus Deploy instance accessible via HTTPS, and a valid API key or access token.
›How can I check which Octopus Server version a specific tool requires?
You can use the command line argument --list-tools-by-version to see the relationship between tools and their required Octopus Server versions.
›Why should I use the read-only mode?
Read-only mode is recommended for production environments to restrict the AI assistant to inspect and query operations only.
›Can I provide my credentials as command-line arguments?
No, you must provide your API key or access token via environment variables to prevent exposing them in the host process list.
›Are there specific configuration requirements for Apple Mac users using Docker?
You may need to add --platform and linux/amd64 arguments to your configuration to force Docker to use the Linux platform.
Alternatives
Changelog
Badge
Maintain this server? Add the live badge to your README.