spinnaker-mcp
This server bridges Spinnaker's Gate API to the MCP protocol, enabling LLMs and agents to interact programmatically with Spinnaker's continuous delivery features.
Applications
List all applications and get detailed info including accounts, clusters, and attributes.
Pipelines
List, get, trigger, save, update, and delete pipeline configurations.
Get pipeline revision history.
Executions
List recent executions (optionally filtered by status) and get full details (stages, outputs, timing).
Search executions by trigger type, time range, status, or event ID.
Cancel, pause, or resume executions; restart failed stages; evaluate SpEL expressions against execution contexts.
Deployment Strategies
List, save/update, and delete deployment strategy configurations.
Infrastructure
List server groups, load balancers, clusters, firewalls/security groups, VPCs/networks, subnets, and cloud accounts.
Get cluster details, scaling activities, and target server groups by selection strategy (newest, oldest, etc.).
Get instance details, console output, find images by tags/region/account, and list Docker image tags.
Tasks
Get the status and details of orchestration tasks (e.g., deploy, resize, rollback).
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.
Related MCP server: HostBridge MCP Server
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
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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