# Spinnaker

> Spinnaker is an open-source MCP server for developer tools. Let an assistant inspect and operate Spinnaker pipelines through the Gate API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Website:** https://geiserx.github.io/spinnaker-mcp/
- **Repository:** https://github.com/geiserx/spinnaker-mcp
- **MCP Registry name:** io.github.GeiserX/spinnaker-mcp
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

This is a single Go binary that sits between an MCP client and a Spinnaker Gate API. Instead of opening each execution and stage in Deck one at a time, you can ask which executions of an application failed today, at which stage, and what that stage returned.

The server is read-only by default. Of its 38 tools, only the 27 that read are registered unless `TOOLSETS=all` is set, which adds the 11 that change things: triggering, judging, saving, updating and deleting pipelines, cancelling, pausing, resuming, restarting stages, and saving or deleting strategies. Most of those are flagged as destructive so clients that honour annotations can ask first. The `evaluate_expression` tool posts a SpEL expression to Gate but changes nothing.

It also offers 10 resources and 5 prompts for reviewing a pipeline, investigating a failed execution, auditing a pipeline, summarising an application's infrastructure and planning a rollback.

Calls run as whichever Gate identity you configure: bearer token, basic auth, a session cookie stored by `spinnaker-mcp login` for SSO setups, optionally with an x509 client certificate. Spinnaker's own access rules apply. It runs over stdio or HTTP, ships as npm, Docker, Helm and binaries for Linux, macOS and Windows, and is GPL-3.0-or-later.

## Features

- **Read-only by default:** Only the 27 read tools are registered until toolsets are enabled.
- **Pipeline and execution control:** Optional tools trigger, pause, resume, cancel and restart pipelines and stages.
- **Infrastructure views:** Read server groups, load balancers, clusters, instances, console output and accounts.
- **Ready-made prompts:** Five prompts cover reviewing, investigating, auditing, summarising and rollback planning.
- **Several auth methods:** Bearer token, basic auth, SSO session cookie or x509 client certificate.
- **Stdio or HTTP:** Runs over stdio, or over HTTP bound to localhost unless a token is set.
- **Many install routes:** Available via npm, Docker, Helm or prebuilt binaries.

## Good for

- Find which pipeline stage failed in today's executions
- See what changed in a pipeline since its last revision
- Audit pipelines before they run
- Plan a rollback from an application's infrastructure state
- Trigger or approve a Manual Judgment from an assistant, when allowed

## Install

### Claude Code (Terminal)

```sh
claude mcp add spinnaker-mcp --env GATE_URL='<GATE_URL>' --env GATE_TOKEN='<GATE_TOKEN>' --env GATE_PASS='<GATE_PASS>' --env GATE_COOKIE='<GATE_COOKIE>' -- npx -y spinnaker-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "spinnaker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<GATE_URL>",
        "GATE_TOKEN": "<GATE_TOKEN>",
        "GATE_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "spinnaker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<GATE_URL>",
        "GATE_TOKEN": "<GATE_TOKEN>",
        "GATE_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>"
      }
    }
  }
}
```

### VS Code (.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_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "spinnaker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<GATE_URL>",
        "GATE_TOKEN": "<GATE_TOKEN>",
        "GATE_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "spinnaker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<GATE_URL>",
        "GATE_TOKEN": "<GATE_TOKEN>",
        "GATE_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>"
      }
    }
  }
}
```

## Tools

- `trigger_pipeline`: Starts a pipeline run.
- `judge_stage`: Approves or rejects a Manual Judgment stage.
- `save_pipeline`: Saves a pipeline.
- `update_pipeline`: Updates an existing pipeline.
- `delete_pipeline`: Deletes a pipeline.
- `cancel_execution`: Cancels a running execution.
- `pause_execution`: Pauses an execution.
- `resume_execution`: Resumes a paused execution.
- `restart_stage`: Restarts a stage of an execution.
- `save_strategy`: Saves a deployment strategy.
- `delete_strategy`: Deletes a deployment strategy.
- `evaluate_expression`: Sends a SpEL expression to Gate for evaluation; read-only.

## FAQ

### Can the assistant change my deployments?

Not by default. Set TOOLSETS=all to add the 11 tools that change Spinnaker.

### What credentials does it need?

A Gate URL plus a bearer token, basic auth, an SSO session cookie, or an x509 client certificate.

### How do I install it?

Run npx -y spinnaker-mcp, or use the Docker image, the Helm chart or a binary.

### What licence is it under?

GPL-3.0-or-later.

### Is Spinnaker free?

Yes. Spinnaker is open source, so you can use and self-host it for free.

### How do I add Spinnaker to Claude Code?

Run this command in your terminal: claude mcp add spinnaker-mcp --env GATE_URL='<GATE_URL>' --env GATE_TOKEN='<GATE_TOKEN>' --env GATE_PASS='<GATE_PASS>' --env GATE_COOKIE='<GATE_COOKIE>' -- npx -y spinnaker-mcp

### What are the best alternatives to Spinnaker?

The closest alternatives to Spinnaker are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/spinnaker
