spinnaker-mcp — Claude Code MCP server: Spinnaker CD control
Exposes Spinnaker CD via Gate API: 37 tools for applications, pipelines, executions and infrastructure operations.
GPL-3.0 ★ 6 updated 2026-10-21
claude mcp add --env GATE_URL=<GATE_URL> --env GATE_TOKEN=<GATE_TOKEN> --env GATE_USER=<GATE_USER> --env GATE_PASS=<GATE_PASS> --transport stdio spinnaker-mcp -- npx -y spinnaker-mcpWhat spinnaker-mcp does
Written in Go, connects to any Spinnaker instance. The agent gets access to applications, pipelines (read, trigger, save, delete, revision history), executions (search by trigger type, time and status, cancel, pause, restart a stage, evaluate SpEL), deployment strategies and infrastructure (server groups, load balancers, clusters, firewalls, instances, images, networks, subnets, accounts). Tracks orchestration task status for deploy, resize and rollback.
Authentication via token, basic auth, x509 client certificate or Gate session cookie behind SSO (use spinnaker-mcp login). Runs over stdio or HTTP (defaults to 127.0.0.1). An environment variable set to an unexpanded placeholder like ${GATE_TOKEN} is treated as unset. Ships as an npm package (runs the Go binary via stdio), Docker image and multi-arch binaries. Requires Node 18 or later.
What it helps with
- trigger Spinnaker pipelines from the agent
- search executions by time range and status
- cancel, pause or restart a pipeline stage
- read pipeline revision history
- check orchestration task status for deploy or rollback
Example prompts for the agent
- Find all executions of the
prod-deploypipeline completed in the last 24 hours with statusSUCCEEDED - Trigger the
staging-rolloutpipeline in theweb-appapplication with parameterversion=1.2.3 - Show console output for instance
i-0abc123in server groupbackend-v010
How to install spinnaker-mcp
Platform CLI
claude mcp add --env GATE_URL=<GATE_URL> --env GATE_TOKEN=<GATE_TOKEN> --env GATE_USER=<GATE_USER> --env GATE_PASS=<GATE_PASS> --transport stdio spinnaker-mcp -- npx -y spinnaker-mcpReplace <…> with your own values
Platform CLI
codex mcp add spinnaker-mcp --env GATE_URL=<GATE_URL> --env GATE_TOKEN=<GATE_TOKEN> --env GATE_USER=<GATE_USER> --env GATE_PASS=<GATE_PASS> -- npx -y spinnaker-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"spinnaker-mcp": {
"command": "npx",
"args": [
"-y",
"spinnaker-mcp"
],
"env": {
"GATE_URL": "<GATE_URL>",
"GATE_TOKEN": "<GATE_TOKEN>",
"GATE_USER": "<GATE_USER>",
"GATE_PASS": "<GATE_PASS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"spinnaker-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"spinnaker-mcp"
],
"env": {
"GATE_URL": "<GATE_URL>",
"GATE_TOKEN": "<GATE_TOKEN>",
"GATE_USER": "<GATE_USER>",
"GATE_PASS": "<GATE_PASS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GATE_URL=<GATE_URL> -e GATE_TOKEN=<GATE_TOKEN> -e GATE_USER=<GATE_USER> -e GATE_PASS=<GATE_PASS> spinnaker-mcp npx -y spinnaker-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about spinnaker-mcp
How to install spinnaker-mcp in Claude Code?
Run claude mcp add spinnaker-mcp -e GATE_URL=<GATE_URL> -e GATE_TOKEN=<GATE_TOKEN> -e GATE_PASS=<GATE_PASS> -- npx -y spinnaker-mcp with your Gate URL and credentials.
What does spinnaker-mcp do?
Gives the agent 37 tools to read and operate Spinnaker via Gate API: pipelines, executions, deployment strategies and infrastructure.
Which authentication methods does spinnaker-mcp support?
Token, basic auth, x509 client certificate and Gate session cookie behind SSO. For the cookie, use the spinnaker-mcp login command.