Skip to main content
Glama
GeiserX

spinnaker-mcp


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)

npx spinnaker-mcp

Or install globally:

npm install -g spinnaker-mcp
spinnaker-mcp

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

Docker

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

{
  "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

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
5Releases (12mo)

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeiserX/spinnaker-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server