{"id":35890393,"url":"https://github.com/OctopusDeploy/mcp-server","last_synced_at":"2026-01-15T14:00:41.921Z","repository":{"id":315540367,"uuid":"1052444987","full_name":"OctopusDeploy/mcp-server","owner":"OctopusDeploy","description":"Octopus Deploy Official MCP Server","archived":false,"fork":false,"pushed_at":"2025-12-11T05:50:37.000Z","size":321,"stargazers_count":91,"open_issues_count":4,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-12T00:39:54.081Z","etag":null,"topics":["devops","mcp","mcp-server"],"latest_commit_sha":null,"homepage":"https://octopus.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OctopusDeploy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-08T04:15:17.000Z","updated_at":"2025-11-25T23:26:49.000Z","dependencies_parsed_at":"2025-09-19T08:25:03.895Z","dependency_job_id":"9347f5d0-e981-4380-addc-569d8adf5ada","html_url":"https://github.com/OctopusDeploy/mcp-server","commit_stats":null,"previous_names":["octopusdeploy/mcp-server"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/OctopusDeploy/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OctopusDeploy","download_url":"https://codeload.github.com/OctopusDeploy/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fmcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28452881,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T13:44:33.145Z","status":"ssl_error","status_checked_at":"2026-01-15T13:44:32.843Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devops","mcp","mcp-server"],"created_at":"2026-01-09T06:00:22.608Z","updated_at":"2026-01-15T14:00:41.886Z","avatar_url":"https://github.com/OctopusDeploy.png","language":"TypeScript","readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/octopusdeploy/mcp-server/blob/main/images/OctopusDeploy_Logo_DarkMode.png?raw=true\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/octopusdeploy/mcp-server/blob/main/images/OctopusDeploy_Logo_LightMode.png?raw=true\"\u003e\n  \u003cimg alt=\"Octopus Deploy Logo\" src=\"https://github.com/octopusdeploy/mcp-server/blob/main/images/OctopusDeploy_Logo_LightMode.png?raw=true\" /\u003e\n\u003c/picture\u003e\n\n# Octopus Deploy Official MCP Server\n\n[Octopus](https://octopus.com) makes it easy to deliver software to Kubernetes, multi-cloud, on-prem infrastructure, and anywhere else. Automate the release, deployment, and operations of your software and AI workloads with a tool that can handle CD at scale in ways no other tool can.\n\n[Model Context Protocol](https://modelcontextprotocol.io/) (MCP) allows the AI assistants you use in your day to day work, like Claude Code, or ChatGPT, to connect to the systems and services you own in a standardized fashion, allowing them to pull information from those systems and services to answer questions and perform tasks.\n\nThe Octopus MCP Server provides your AI assistant with powerful tools that allow it to inspect, query, and diagnose problems within your Octopus instance, transforming it into your ultimate DevOps wingmate. For a list of supported use-cases and sample prompts, see our [documentation](https://octopus.com/docs/octopus-ai/mcp/use-cases).\n\n### Octopus Server Compatibility\n\nMost tools exposed by the MCP Server use stable APIs that have been available from at least version `2021.1` of Octopus Server. Tools that are newer will specify the minimum supported version in the documentation. Alternatively, you can use the command line argument `--list-tools-by-version` to check how specific tools relate to versions of Octopus.\n\n## 🚀 Installation\n\n### Install via Docker\n\nRun with environment variables\n```bash\ndocker run -i --rm -e OCTOPUS_API_KEY=your-key -e OCTOPUS_SERVER_URL=https://your-octopus.com octopusdeploy/mcp-server\n```\n\nRun with CLI arguments\n```bash\ndocker run -i --rm octopusdeploy/mcp-server --server-url https://your-octopus.com --api-key YOUR_API_KEY\n```\n\nFull example configuration (for Claude Desktop, Claude Code, and Cursor):\n```json\n{\n  \"mcpServers\": {\n    \"octopus-deploy\": {\n      \"type\": \"stdio\",\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"octopusdeploy/mcp-server\",\n        \"--server-url\",\n        \"https://your-octopus.com\",\n        \"--api-key\",\n        \"YOUR_API_KEY\"\n      ]\n    },\n  }\n}\n```\n\nFor Apple Mac users, you might need to add the following arguments in the configuration to force Docker to use the Linux platform:\n```json\n\"--platform\",\n\"linux/amd64\",\n```\n\nWe are planning to release a native ARM build shortly so that those arguments will not be required anymore.\n\n### Install via Node\n\n#### Requirements\n- Node.js \u003e= v20.0.0\n- Octopus Deploy instance that can be accessed by the MCP server via HTTPS\n- Octopus Deploy API Key\n\n#### Configuration\n\nFull example configuration (for Claude Desktop, Claude Code, and Cursor):\n```json\n{\n  \"mcpServers\": {\n    \"octopusdeploy\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@octopusdeploy/mcp-server\", \"--api-key\", \"YOUR_API_KEY\", \"--server-url\", \"https://your-octopus.com\"]\n    }\n  }\n}\n```\n\nThe Octopus MCP Server is typically configured within your AI Client of choice. \n\nIt is packaged as an npm package and executed via Node's `npx` command. Your configuration will include the command invocation `npx`, and a set of arguments that supply the Octopus MCP Server package and provide the Octopus Server URL and API key required, if they are not available as environment variables.\n\nThe command line invocation you will be configuring will be one of the two following variants:\n\n```bash\nnpx -y @octopusdeploy/mcp-server\n```\n\nWith configuration provided via environment variables:\n```bash\nOCTOPUS_API_KEY=API-KEY\nOCTOPUS_SERVER_URL=https://your-octopus.com\n```\n\nOr with configuration supplied via the command line:\n```bash\nnpx -y @octopusdeploy/mcp-server --server-url https://your-octopus.com --api-key YOUR_API_KEY\n```\n\n### Configuration Options\n\nThe Octopus MCP Server supports several command-line options to customize which tools are available. \n\nIf you are not sure which tools you require, we recommend running without any additional command-line options and using the provided defaults.\n\n#### Toolsets\nUse the `--toolsets` parameter to enable specific groups of tools:\n\n```bash\n# Enable all toolsets (default)\nnpx -y @octopusdeploy/mcp-server\n\n# Enable only specific toolsets\nnpx -y @octopusdeploy/mcp-server --toolsets projects,deployments\n\n# Enable all toolsets explicitly\nnpx -y @octopusdeploy/mcp-server --toolsets all\n```\n\nAvailable toolsets:\n- **core** - Basic operations (always enabled)\n- **projects** - Project operations\n- **deployments** - Deployment operations\n- **releases** - Release management\n- **tasks** - Task operations\n- **tenants** - Multi-tenancy operations\n- **kubernetes** - Kubernetes operations\n- **machines** - Deployment target operations\n- **certificates** - Certificate operations\n- **accounts** - Account operations\n\n#### Read-Only Mode\nThe server runs in read-only mode by default for security. All current tools are read-only operations.\n\n```bash\n# Run in read-only mode (default)\nnpx -y @octopusdeploy/mcp-server --read-only\n\n# Disable read-only mode (currently no effect as all tools are read-only)\nnpx -y @octopusdeploy/mcp-server --read-only=false\n```\n\n#### Complete Examples\n\n```bash\n# Development setup with only core and project tools\nnpx -y @octopusdeploy/mcp-server --toolsets core,projects --server-url https://your-octopus.com --api-key YOUR_API_KEY\n\n# Full production setup with all tools\nnpx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https://your-octopus.com --api-key YOUR_API_KEY\n```\n\n#### Other command line arguments\n\n* `--log-level \u003clevel\u003e` - Minimum log level (info, error)\n* `--log-file \u003cpath\u003e` - Log file path or filename. If not specified, logs are written to console only\n* `-q, --quiet` - Disable file logging, only log errors to console\n* `--list-tools-by-version` - List all registered tools by their supported Octopus Server version and exit\n\n## 🔨 Tools\n\n### Core Tools\n- `list_spaces`: List all spaces in the Octopus Deploy instance\n- `list_environments`: List all environments in a given space\n\n### Projects\n- `list_projects`: List all projects in a given space\n\n### Deployments\n- `list_deployments`: List deployments in a space with optional filtering\n\n### Releases\n- `get_release_by_id`: Get details for a specific release by its ID\n- `list_releases`: List all releases in a given space\n- `list_releases_for_project`: List all releases for a specific project\n\n### Tasks\n- `get_task_by_id`: Get details for a specific server task by its ID\n- `get_task_details`: Get detailed information for a specific server task\n- `get_task_raw`: Get raw details for a specific server task\n\n### Tenants\n- `list_tenants`: List all tenants in a given space\n- `get_tenant_by_id`: Get details for a specific tenant by its ID\n- `get_tenant_variables`: Get tenant variables by type (all, common, or project)\n- `get_missing_tenant_variables`: Get tenant variables that are missing values\n\n### Kubernetes\n- `get_kubernetes_live_status`: Get live status of Kubernetes resources for a project and environment (minimum supported version: `2025.3`)\n\n### Machines (Deployment Targets)\n- `list_deployment_targets`: List all deployment targets in a space with optional filtering\n- `get_deployment_target`: Get detailed information about a specific deployment target\n\n### Certificates\n- `list_certificates`: List all certificates in a space with optional filtering\n- `get_certificate`: Get detailed information about a specific certificate by its ID\n\n### Accounts\n- `list_accounts`: List all accounts in a space with optional filtering\n- `get_accounts`: Get detailed information about a specific account by its ID\n\n### Additional Tools\n- `get_deployment_process`: Get deployment process by ID for projects or releases\n- `get_branches`: Get Git branches for a version-controlled project (minimum supported version: `2021.2`)\n- `get_current_user`: Get information about the current authenticated user\n\n## 🔒 Security Considerations\n\nWhile the Octopus MCP Server at this stage is a read-only tool, it **can read full deployment logs, which could include production secrets.** Exercise caution when connecting Octopus MCP to tools and models you do not fully trust.\n\nRunning agents in a fully automated fashion could make you vulnerable to exposure via prompt-injection attacks that exfiltrate tokens.\n\nExercise caution and mitigate the risks by using least-privileged accounts when connecting to Octopus Server.\n\n## ⚠️ Limitations\n\n### Data Analysis\n\nThe nature of current AI chat tools and the MCP protocol itself makes it impractical to analyze large amounts of data. Most MCP clients currently do not support chaining tool calls (using the output of one tool as input to the next one) and instead fall back to copying the results token by token, which frequently leads to hallucinations. If you are looking to process historical data from your Octopus instance for analysis purposes, we recommend using the API directly or writing your own MCP client that is capable of processing the tool call results programmatically.\n\n### Performance\n\nThe MCP Server is technically just a thin layer on top of the existing Octopus Server API. As such it is capable of retrieving large amounts of data (for example, requesting thousands of deployments). Such queries can have a significant effect on your instance's performance. Instruct your models to only retrieve the minimum set of data that it needs (most models are really good at this out of the box).\n\n## 🤝 Contributions\n\nContributions are welcome! :heart: Please read our [Contributing Guide](CONTRIBUTING.md) for information about how to get involved in this project.\n\nWe are eager to hear how you plan to use Octopus MCP Server and what features you would like to see included in future version. \n\nPlease use [Issues](https://github.com/OctopusDeploy/mcp-server/issues) to provide feedback, or request features.\n\nIf you are a current Octopus customer, please report any issues you experience using our MCP server to our [support team](mailto:support@octopus.com). This will ensure you get a timely response within our standard support guarantees.\n\n## 🙋 FAQ\n\n### Do you have plans to release a remote MCP server?\n\nWe are working on integrating an MCP server directly into Octopus Server. This will open up the door for us to build more complex MCP tools, as well as:\n\n* Giving Octopus Administrators more granular control over MCP clients\n* Natively support OAuth for client authentication\n* Integrating security scanning tools into the MCP output\n\nIf this is of interest to you, please register your interest on [our roadmap item](https://roadmap.octopus.com/c/228-remote-mcp-server-ai-).\n\n## License\n\nThis project is licensed under the terms of Mozilla Public License 2.0 open source license.\n","funding_links":[],"categories":["Developer Tools"],"sub_categories":["CI/CD \u0026 DevOps"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOctopusDeploy%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOctopusDeploy%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOctopusDeploy%2Fmcp-server/lists"}