Skip to content
Conduit

mcp server

spinnaker-mcp

MCP Server for Spinnaker — manage applications, pipelines, and deployments via the Model Context Protocol

GeiserX/spinnaker-mcpcommunitylistedunreviewed

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "spinnaker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<your GATE_URL>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

It gives an LLM 37 tools to read and operate Spinnaker: applications, pipelines, executions, strategies and infrastructure.

MCP Inspector connected to spinnaker-mcp started with TOOLSETS=readonly: only read tools are listed, and search_executions is selected with its arguments

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

↑↓ navigate openesc close