MCP Server
UnclaimedOctopus Deploy Official MCP Server
Install
docker run -i --rm -e OCTOPUS_API_KEY=your-key -e OCTOPUS_SERVER_URL=https://your-octopus.com octopusdeploy/mcp-serverSet up this server
More in Developer Tools
Browse the full directoryUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverSecurity profile
Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works
28 of 28 tools
Documented tools (28)
From project documentation. A server handshake does not verify each tool’s description or behavior.
create_release
Create a new release for a project
deploy_release
Deploy a release to environments (supports both tenanted and untenanted deployments)
execute
Structured REST backstop. Reaches any Octopus REST endpoint under /api. The HTTP method is the authoritative read/write/delete classifier — never an isWrite flag the LLM can set. Method gating is hard-coded server-side:
find_accounts
Find accounts in a space (can get a specific account by ID or list/search accounts with filters)
find_certificates
Find certificates in a space (can get a specific certificate by ID or list/search certificates with filters)
find_deployment_targets
Find deployment targets in a space (can get a specific target by ID or list/search targets with filters)
find_feature_toggles
List customer feature toggles in a project. Each summary includes per-environment state (isEnabled, rolloutPercentage, clientRolloutPercentage) plus a resourceUri so "where is X turned on" is answerable from the list response.
find_interruptions
Find pending or historical interruptions (manual interventions, approvals, guided-failure prompts) in a space, optionally filtered by task, project, environment, regarding document, responsibility, or pending state. Returns slim summaries; dereference the octopus://spaces/{spaceName}/interruptions/{
find_releases
Find releases in a space (can get a specific release by ID, or list/filter releases by project)
find_runbooks
Find runbooks in a project (can get a specific runbook by ID, or list/filter runbooks by partial name). Each summary includes the published snapshot ID, multi-tenancy mode, and environment scope so callers can pick valid targets before running.
find_tenants
Find tenants in a space (can get a specific tenant by ID or list/search tenants with filters)
get_branches
Get Git branches for a version-controlled project (minimum supported version: 2021.2)
get_current_user
Get information about the current authenticated user
get_deployment_from_url
Get deployment details from deployment URL (returns taskId for follow-up)
get_deployment_process
Get deployment process by ID for projects or releases
get_kubernetes_live_status
Get live status of Kubernetes resources for a project and environment (minimum supported version: 2025.3)
get_missing_tenant_variables
Get tenant variables that are missing values
get_task_from_url
Get task details and logs from task URL
get_tenant_variables
Get tenant variables by type (all, common, or project)
get_variables
Get all project variables and library variable set variables for a project (supports config-as-code projects via gitRef)
grep_llms_txt
Search the Octopus API catalog (octopus://api/llms.txt) with grep-style semantics (minimum supported Octopus version: 2026.2.3916). The catalog body is large (typically 300+ KB) — call this rather than reading the resource body directly. Parameters mirror GNU grep (pattern, caseInsensitive, invertMa
grep_task_log
Search a task's activity log without fetching the full body. Parameters mirror GNU grep (pattern, caseInsensitive, invertMatch, fixedString, beforeContext, afterContext, maxCount). Returns matching lines with 1-indexed lineNumber, optional before/after context arrays, and a totalMatches count across
list_deployments
List deployments in a space with optional filtering
list_environments
List all environments in a given space
list_projects
List all projects in a given space
list_spaces
List all spaces in the Octopus Deploy instance
run_runbook
Run a runbook against one or more environments. Supports tenanted runs (by tenant name or tenant tag), prompted variables, guided failure mode, scheduled run windows, and step or machine inclusion/exclusion. Defaults to the runbook's published snapshot if runbookSnapshotId is omitted.
update_feature_toggle
Adjust an existing toggle. Narrow surface — flip an environment on/off, change rollout percentages, or update the toggle-level description / default state. Internally fetches the current toggle, applies your patches in memory, and PUTs the merged body, so unmentioned environments and unmentioned fie
Tool change history
FAQ
Questions about MCP Server
- How do I connect MCP Server to Claude?
- The listing records `docker run -i --rm -e OCTOPUS_API_KEY=your-key -e OCTOPUS_SERVER_URL=https://your-octopus.com octopusdeploy/mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, Cursor as compatible clients.
- Is MCP Server free?
- The listed licence is MPL-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
- What can MCP Server do?
- MCP Server documents 28 tools to the agent, including create_release, deploy_release, execute. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.