Spinnaker-MCP

A bridge that exposes any Spinnaker instance as an MCP v1 server via the Gate API, written in Go.

What you get

Category	Tool	Description
Applications	`list_applications`	List all Spinnaker applications
	`get_application`	Get detailed application info (accounts, clusters, attributes)
Pipelines	`list_pipelines`	List pipeline configurations for an application
	`get_pipeline`	Get a specific pipeline's full configuration
	`trigger_pipeline`	Trigger a pipeline with optional parameters
	`save_pipeline`	Save/create a pipeline definition
	`update_pipeline`	Update an existing pipeline definition
	`delete_pipeline`	Delete a pipeline definition
	`get_pipeline_history`	Get revision history for a pipeline config
Executions	`list_executions`	List recent executions, filterable by status
	`get_execution`	Get full execution details (stages, outputs, timing)
	`search_executions`	Rich search by trigger type, time range, status
	`cancel_execution`	Cancel a running execution with optional reason
	`pause_execution`	Pause a running execution at the current stage
	`resume_execution`	Resume a paused execution
	`restart_stage`	Restart a failed stage within an execution
	`evaluate_expression`	Evaluate a SpEL expression against an execution
Strategies	`list_strategies`	List deployment strategy configurations
	`save_strategy`	Create or update a deployment strategy
	`delete_strategy`	Delete a deployment strategy
Infrastructure	`list_server_groups`	List server groups (deployment targets) with instance counts
	`list_load_balancers`	List load balancers across all accounts and regions
	`list_clusters`	List cluster names grouped by account
	`get_cluster`	Get cluster details including server groups
	`get_scaling_activities`	Get scaling activities for a cluster
	`get_target_server_group`	Target-based server group lookup (newest, oldest, etc.)
	`list_firewalls`	List all firewalls/security groups across accounts
	`get_firewall`	Get firewall details by account, region, and name
	`get_instance`	Get instance details (health, metadata, launch time)
	`get_console_output`	Get instance console output for debugging
	`find_images`	Search for machine images by tags, region, account
	`get_image_tags`	List image tags for a repository
	`list_networks`	List VPCs/networks by cloud provider
	`list_subnets`	List subnets by cloud provider
	`list_accounts`	List all configured cloud accounts/credentials
	`get_account`	Get account details and permissions
Tasks	`get_task`	Get orchestration task status (deploy, resize, rollback)

Everything is exposed over JSON-RPC. LLMs and agents can: initialize -> listTools -> callTool and interact with your Spinnaker deployments.

Quick-start

npm (stdio transport)

Terminal

npx spinnaker-mcp

Or install globally:

Terminal

npm install -g spinnaker-mcp
spinnaker-mcp

This downloads the pre-built Go binary for your platform and runs it with stdio transport.

Docker

Terminal

docker run --rm -e GATE_URL=http://spin-gate:8084 -e TRANSPORT=stdio drumsergio/spinnaker-mcp:0.3.1

Local build

git clone https://github.com/GeiserX/spinnaker-mcp
cd spinnaker-mcp

cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuration

Variable	Default	Description
`GATE_URL`	`http://localhost:8084`	Spinnaker Gate API endpoint (without trailing /)
`GATE_TOKEN`	(empty)	Bearer token for authentication
`GATE_USER`	(empty)	Basic auth username (alternative to token)
`GATE_PASS`	(empty)	Basic auth password
`GATE_CERT_FILE`	(empty)	Path to x509 client certificate (PEM)
`GATE_KEY_FILE`	(empty)	Path to x509 client key (PEM)
`GATE_INSECURE`	`false`	Skip TLS certificate verification
`TRANSPORT`	(empty = HTTP)	Set to `stdio` for stdio transport
`MCP_PORT`	`8085`	HTTP transport port (ignored when TRANSPORT=stdio)
`MCP_BIND_ADDR`	`127.0.0.1`	HTTP transport bind address (set to `0.0.0.0` to listen on all interfaces)

Authentication priority: Bearer token > Basic auth > x509 client cert > No auth.

Put them in a .env file (from .env.example) or set them in the environment.

Claude Code / Claude Desktop configuration

config.json

{
  "mcpServers": {
    "spinnaker": {
      "command": "npx",
      "args": ["-y", "spinnaker-mcp"],
      "env": {
        "GATE_URL": "https://spin-gate.example.com",
        "GATE_TOKEN": "your-token-here"
      }
    }
  }
}

Testing

go test -v -race ./...

Tested with Inspector. Before making a PR, make sure this MCP server behaves well via that tool.

Credits

Spinnaker -- open-source continuous delivery platform

MCP-GO -- Go MCP implementation

GoReleaser -- painless multi-arch releases

Maintainers

@GeiserX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

Spinnaker-MCP follows the Contributor Covenant Code of Conduct.

Other MCP Servers by GeiserX

genieacs-mcp -- TR-069 device management
cashpilot-mcp -- Passive income monitoring
duplicacy-mcp -- Backup health monitoring
lynxprompt-mcp -- AI configuration blueprints
pumperly-mcp -- Fuel and EV charging prices
telegram-archive-mcp -- Telegram message archive