mcp-server

Overview

The Octopus Deploy MCP Server provides AI assistants with powerful tools to inspect, query, and diagnose problems within Octopus Deploy instances, transforming them into DevOps wingmates. It supports both read and write operations, with security controls like read-only mode and authentication via API keys or access tokens. The server is well-maintained with active development and comprehensive documentation covering multiple installation methods and configuration options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_deployment_from_url

  Get deployment details from deployment URL

  Try:Get details for this deployment: https://your-octopus.com/app#/Spaces-1/projects/my-app/deployments/Deployments-123Try:Investigate this deployment URL
• get_task_from_url

  Get task details and logs from task URL

  Try:Get details for this task: https://your-octopus.com/app#/Spaces-1/tasks/ServerTasks-456Try:Investigate this task URL
• list_spaces

  List all spaces in the Octopus Deploy instance

  Try:Show me all spaces in the Octopus instanceTry:List all available spaces
• list_environments

  List all environments in a given space

  Try:Show me all environments in the 'Production' spaceTry:List environments for my project
• grep_llms_txt

  Search the Octopus API catalog with grep-style semantics

  Try:Search for 'docker' in the API catalogTry:Find all endpoints related to deployments in the catalog
• create_release

  Create new releases

  Try:Create a new release for my applicationTry:Release version 1.2.3 to production
• deploy_release

  Deploy releases to environments and tenants

  Try:Deploy the latest release to the production environmentTry:Deploy release 1.2.3 to QA tenant
• run_runbook

  Run a runbook against one or more environments

  Try:Run the 'Database Backup' runbook for productionTry:Execute the server restart runbook for all environments
• update_feature_toggle

  Adjust per-environment state and rollout percentages on feature toggles

  Try:Enable the 'New UI' feature toggle for productionTry:Set rollout percentage for 'Beta Feature' to 50%
• execute

  Execute arbitrary Octopus REST API requests

  Try:GET /api/projectsTry:POST /api/releases with version 1.2.3
• grep_task_log

  Search raw log content for specific patterns

  Try:Search task logs for 'error' or 'fail'Try:Find all occurrences of 'timeout' in this deployment log
• read_resource

  Read structured resources from Octopus API

  Try:Read the details for task ID 'ServerTasks-456'Try:Get the resource at octopus://spaces/MySpace/projects/MyProject

Comparable tools

Installation

docker run -i --rm -e OCTOPUS_API_KEY=your-key -e OCTOPUS_SERVER_URL=https://your-octopus.com octopusdeploy/mcp-server

OCTOPUS_API_KEY=API-KEY \
OCTOPUS_SERVER_URL=https://your-octopus.com \
npx -y @octopusdeploy/mcp-server

{
  "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"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The MCP server supports API keys (recommended for interactive use) and access tokens/bearer tokens (for automated scenarios only).

How can I limit permissions in production?

Use the --read-only flag to disable all write operations and block POST/PUT/PATCH/DELETE requests through the execute tool.

Compare mcp-server with