Spinnaker
MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: moves money, runs code or commands, deletes data, or sends messages for you.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y spinnaker-mcp
MCP client config
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": [
"-y",
"spinnaker-mcp"
]
}
}
}Run
docker run -i --rm drumsergio/spinnaker-mcp:v0.3.7
MCP client config
{
"mcpServers": {
"spinnaker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"drumsergio/spinnaker-mcp:v0.3.7"
]
}
}
}
spinnaker-mcp
A bridge that exposes any Spinnaker instance as an MCP server via the Gate API, written in Go.
It gives an LLM 37 tools to read and operate Spinnaker: applications, pipelines, executions, strategies and infrastructure.
Features
- Applications and pipelines: list, read, trigger, save, update and delete pipelines, with revision history.
- Executions: list, search by trigger type, time range and status, cancel, pause, resume, restart a stage, evaluate SpEL.
- Deployment strategies: list, save and delete.
- Infrastructure: server groups, load balancers, clusters, firewalls, instances and console output, images, networks, subnets, accounts.
- Orchestration task status (deploy, resize, rollback).
- Bearer token, basic auth, x509 client certificate, or the session cookie of a Gate behind SSO (
spinnaker-mcp login). - stdio or HTTP transport; HTTP binds to
127.0.0.1by default. - Ships as an npm package (
npx spinnaker-mcp), a Docker image and multi-arch Go binaries.
Quick start
Add the server to your MCP client (Claude Code, Claude Desktop, Cursor):
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": ["-y", "spinnaker-mcp"],
"env": { "GATE_URL": "https://spin-gate.example.com", "GATE_TOKEN": "your-token-here" }
}
}
}
Needs Node 18 or newer; the npm package runs the Go binary over stdio. Docker, local builds and the other credentials are in Getting started.
A variable whose value is only an unexpanded placeholder, such as ${GATE_TOKEN}, counts as unset.
Documentation
The full documentation is at geiserx.github.io/spinnaker-mcp.
- Getting started: npm, Docker, Helm, local build, and the client configuration
- Configuration: every environment variable, the read-only toolset, the HTTP endpoints
- Usage: the 37 tools and which ones change Spinnaker, the 10 resources, the 5 prompts
- Development: testing, contributing, credits
- Related projects: the other MCP servers and the registry listings
