# spinnaker-mcp

Exposes Spinnaker CD via Gate API: 37 tools for applications, pipelines, executions and infrastructure operations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: GeiserX
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/GeiserX/spinnaker-mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/spinnaker-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GATE_URL`, `GATE_TOKEN`, `GATE_USER`, `GATE_PASS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Find all executions of the `prod-deploy` pipeline completed in the last 24 hours with status `SUCCEEDED`
- Trigger the `staging-rollout` pipeline in the `web-app` application with parameter `version=1.2.3`
- Show console output for instance `i-0abc123` in server group `backend-v010`

## Similar
- [azure-devops](https://affpapa.org/en/nevibecode/skills/devops-skills-azure-devops.md) — skill · 360 installs
- [azure-pipelines-generator](https://affpapa.org/en/nevibecode/skills/azure-pipelines-generator.md) — skill · 722 installs
- [azure-devops-pipelines](https://affpapa.org/en/nevibecode/rules/azure-devops-pipelines.md) — rule · ★ 41430 repo stars
- [ensure-pipelines-host](https://affpapa.org/en/nevibecode/skills/ensure-pipelines-host.md) — skill · ★ 1167 repo stars
- [google-agents-cli-scaffold](https://affpapa.org/en/nevibecode/skills/google-agents-cli-scaffold.md) — skill · 585900 installs
- [prisma-compute](https://affpapa.org/en/nevibecode/skills/prisma-compute.md) — skill · 420500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
