spinnaker-mcp
Provides tools to interact with a Spinnaker instance via its Gate API, enabling management of applications, pipelines, executions, deployments, and infrastructure.
What you get
Category | Tool | Description |
Applications |
| List all Spinnaker applications |
| Get detailed application info (accounts, clusters, attributes) | |
Pipelines |
| List pipeline configurations for an application |
| Get a specific pipeline's full configuration | |
| Trigger a pipeline with optional parameters | |
| Save/create a pipeline definition | |
| Update an existing pipeline definition | |
| Delete a pipeline definition | |
| Get revision history for a pipeline config | |
Executions |
| List recent executions, filterable by status |
| Get full execution details (stages, outputs, timing) | |
| Rich search by trigger type, time range, status | |
| Cancel a running execution with optional reason | |
| Pause a running execution at the current stage | |
| Resume a paused execution | |
| Restart a failed stage within an execution | |
| Evaluate a SpEL expression against an execution | |
Strategies |
| List deployment strategy configurations |
| Create or update a deployment strategy | |
| Delete a deployment strategy | |
Infrastructure |
| List server groups (deployment targets) with instance counts |
| List load balancers across all accounts and regions | |
| List cluster names grouped by account | |
| Get cluster details including server groups | |
| Get scaling activities for a cluster | |
| Target-based server group lookup (newest, oldest, etc.) | |
| List all firewalls/security groups across accounts | |
| Get firewall details by account, region, and name | |
| Get instance details (health, metadata, launch time) | |
| Get instance console output for debugging | |
| Search for machine images by tags, region, account | |
| List image tags for a repository | |
| List VPCs/networks by cloud provider | |
| List subnets by cloud provider | |
| List all configured cloud accounts/credentials | |
| Get account details and permissions | |
Tasks |
| Get orchestration task status (deploy, resize, rollback) |
Everything is exposed over JSON-RPC. LLMs and agents can: initialize -> listTools -> callTool and interact with your Spinnaker deployments.
Quick-start
npm (stdio transport)
npx spinnaker-mcpOr install globally:
npm install -g spinnaker-mcp
spinnaker-mcpThis downloads the pre-built Go binary for your platform and runs it with stdio transport.
Docker
docker run --rm -e GATE_URL=http://spin-gate:8084 -e TRANSPORT=stdio drumsergio/spinnaker-mcp:0.3.1Local build
git clone https://github.com/GeiserX/spinnaker-mcp
cd spinnaker-mcp
cp .env.example .env && $EDITOR .env
go run ./cmd/serverConfiguration
Variable | Default | Description |
|
| Spinnaker Gate API endpoint (without trailing /) |
| (empty) | Bearer token for authentication |
| (empty) | Basic auth username (alternative to token) |
| (empty) | Basic auth password |
| (empty) | Path to x509 client certificate (PEM) |
| (empty) | Path to x509 client key (PEM) |
|
| Skip TLS certificate verification |
| (empty = HTTP) | Set to |
|
| HTTP transport port (ignored when TRANSPORT=stdio) |
|
| HTTP transport bind address (set to |
Authentication priority: Bearer token > Basic auth > x509 client cert > No auth.
Put them in a .env file (from .env.example) or set them in the environment.
Claude Code / Claude Desktop configuration
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": ["-y", "spinnaker-mcp"],
"env": {
"GATE_URL": "https://spin-gate.example.com",
"GATE_TOKEN": "your-token-here"
}
}
}
}Testing
go test -v -race ./...Tested with Inspector. Before making a PR, make sure this MCP server behaves well via that tool.
Credits
Spinnaker -- open-source continuous delivery platform
MCP-GO -- Go MCP implementation
GoReleaser -- painless multi-arch releases
Maintainers
Contributing
Feel free to dive in! Open an issue or submit PRs.
Spinnaker-MCP follows the Contributor Covenant Code of Conduct.
Other MCP Servers by GeiserX
genieacs-mcp -- TR-069 device management
cashpilot-mcp -- Passive income monitoring
duplicacy-mcp -- Backup health monitoring
lynxprompt-mcp -- AI configuration blueprints
pumperly-mcp -- Fuel and EV charging prices
telegram-archive-mcp -- Telegram message archive
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeiserX/spinnaker-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server