Octopus Deploy Official MCP Server

Octopus Deploy Official MCP Server is an MCP server that connects AI assistants like Claude Desktop, Claude Code, and Cursor directly to your Octopus Deploy instance. DevOps engineers, site reliability engineers, and software delivery teams use this integration to inspect, query, and troubleshoot continuous delivery workflows using natural language. It enables users to investigate failed deployments from simple URLs, search through multi-megabyte task logs without full downloads, and inspect Kubernetes live cluster states across environments. It also supports operational tasks like triggering releases, running automated runbooks across specific environments and tenants, and diagnosing missing tenant variable configurations. The server provides fine-grained control via configurable toolsets, supports a dedicated read-only safety mode for production environments, and handles authentication securely through either API keys or short-lived automated access tokens via standard environment variables.

Category: Cloud & Infrastructure

Tags: automation, ci-cd, deployment, octopus deploy, release management

Visit Octopus Deploy Official MCP Server

How to install and configure Octopus Deploy Official MCP Server

1. Ensure Node.js (version 20.0.0 or higher) or Docker is installed, and obtain your Octopus Deploy server URL and API key. 2. Add the Octopus Deploy MCP server to your client configuration file (such as Claude Desktop or Cursor): json { "mcpServers": { "octopusdeploy": { "type": "stdio", "command": "npx", "args": ["-y", "@octopusdeploy/mcp-server"], "env": { "OCTOPUS_SERVER_URL": "https://your-octopus.com", "OCTOPUS_API_KEY": "YOUR_API_KEY" } } } } 3. For production safety, pass the "--read-only" argument within the args array to prevent modifications. 4. Save the configuration and restart your MCP client to enable the tools.

What you can do with Octopus Deploy Official MCP Server

• Diagnose deployment failures: Paste an Octopus deployment URL to retrieve the task context and search logs for specific failure patterns. - Execute operational runbooks: Trigger maintenance or incident mitigation runbooks across specified environments and tenants with custom prompted variables. - Validate Kubernetes live status: Check the real-time health and rollout status of Kubernetes workloads for specific environments and projects. - Manage multi-tenant releases: Identify missing tenant variables across environments and create or deploy releases to targeted tenants safely. - Automate release delivery: Generate new release artifacts and trigger deployment pipelines across environments while enforcing MCP elicitation safeguards.

Key facts

• https://github.com/OctopusDeploy/mcp-server
• Cloud & Infrastructure, DevOps, CI/CD & Version Control
• automation, ci-cd, deployment, octopus deploy, release management

Part of MCP Servers

How do I install Octopus Deploy Official MCP Server?

You can run it directly via Node using npx with the package @octopusdeploy/mcp-server or deploy it using Docker with the image octopusdeploy/mcp-server. You must supply your Octopus server URL and an API key or access token using environment variables in your MCP client configuration.

What can Octopus Deploy Official MCP Server do?

The server allows AI assistants to query Octopus projects, inspect deployments, search task activity logs, execute runbooks across environments, check Kubernetes cluster resources, manage multi-tenant variables, and trigger or schedule software releases.

Which MCP clients work with Octopus Deploy Official MCP Server?

It functions with any MCP-compliant client that supports stdio transport, including Claude Desktop, Claude Code, and Cursor. You configure the server by adding standard command, argument, and environment parameters into your client's settings file.

How do I enable read-only mode for safety?

To run in read-only mode, append the --read-only argument to the server command in your configuration. This disables write-enabled tools such as create_release, deploy_release, run_runbook, and update_feature_toggle, while blocking HTTP write operations via the execution backstop.

Which Octopus Server versions are compatible?

Most tools provided by the server rely on stable APIs available since Octopus Server version 2021.1. Tools requiring newer features will specify their minimum supported version, or you can run the command-line flag --list-tools-by-version to inspect compatibility.