English Français العربية

Spinnaker

Official registry Cloud and DevOps

MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management

Source code Website Documentation

What can you do with Spinnaker?

  • 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.1 by default.
  • Ships as an npm package (npx spinnaker-mcp), a Docker image and multi-arch Go binaries.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package spinnaker-mcp
Claude Code 
claude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- npx -y spinnaker-mcp@0.4.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spinnaker": {
            "command": "npx",
            "args": [
                "-y",
                "spinnaker-mcp@0.4.0"
            ],
            "env": {
                "GATE_URL": "<GATE_URL>",
                "GATE_TOKEN": "<your gate_token>",
                "GATE_USER": "<GATE_USER>",
                "GATE_PASS": "<your gate_pass>",
                "GATE_COOKIE": "<your gate_cookie>",
                "GATE_COOKIE_FILE": "<GATE_COOKIE_FILE>",
                "GATE_CERT_FILE": "<GATE_CERT_FILE>",
                "GATE_KEY_FILE": "<GATE_KEY_FILE>",
                "GATE_INSECURE": "false",
                "TOOLSETS": "readonly"
            }
        }
    }
}

Environment variables

  • GATE_URL required Spinnaker Gate API URL (e.g. https://spin-gate.example.com)
  • GATE_TOKEN secret Bearer token for Gate
  • GATE_USER Basic auth username (alternative to a token)
  • GATE_PASS secret Basic auth password
  • GATE_COOKIE secret SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' once
  • GATE_COOKIE_FILE File holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)
  • GATE_CERT_FILE x509 client certificate (PEM); needs GATE_KEY_FILE
  • GATE_KEY_FILE x509 client key (PEM); needs GATE_CERT_FILE
  • GATE_INSECURE Skip TLS certificate verification of Gate (testing only)
  • TOOLSETS Tool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines
OCI package drumsergio/spinnaker-mcp:v0.4.0
Claude Code 
claude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- docker run -i --rm drumsergio/spinnaker-mcp:v0.4.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spinnaker": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "drumsergio/spinnaker-mcp:v0.4.0"
            ],
            "env": {
                "GATE_URL": "<GATE_URL>",
                "GATE_TOKEN": "<your gate_token>",
                "GATE_USER": "<GATE_USER>",
                "GATE_PASS": "<your gate_pass>",
                "GATE_COOKIE": "<your gate_cookie>",
                "GATE_COOKIE_FILE": "<GATE_COOKIE_FILE>",
                "GATE_CERT_FILE": "<GATE_CERT_FILE>",
                "GATE_KEY_FILE": "<GATE_KEY_FILE>",
                "GATE_INSECURE": "false",
                "TOOLSETS": "readonly"
            }
        }
    }
}

Environment variables

  • GATE_URL required Spinnaker Gate API URL (e.g. https://spin-gate.example.com)
  • GATE_TOKEN secret Bearer token for Gate
  • GATE_USER Basic auth username (alternative to a token)
  • GATE_PASS secret Basic auth password
  • GATE_COOKIE secret SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' once
  • GATE_COOKIE_FILE File holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)
  • GATE_CERT_FILE x509 client certificate (PEM); needs GATE_KEY_FILE
  • GATE_KEY_FILE x509 client key (PEM); needs GATE_CERT_FILE
  • GATE_INSECURE Skip TLS certificate verification of Gate (testing only)
  • TOOLSETS Tool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. spinnaker-mcp
  2. Features
  3. Quick start
  4. Documentation
  5. License

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.1 by 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

License

GPL-3.0-or-later

Frequently asked questions

What is Spinnaker?

MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management

How do I install Spinnaker?

It runs on your machine. In Claude Code: claude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- npx -y spinnaker-mcp@0.4.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Spinnaker need an API key?

Yes. It expects GATE_URL, GATE_TOKEN, GATE_PASS, GATE_COOKIE, which you set in its configuration.

Is Spinnaker open source?

Yes. Its code is on GitHub under the GPL-3.0 license.

Who maintains Spinnaker?

It is published by GeiserX. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.