mcp-server-spotinst

MCP server for the Spot.io (Spotinst) API. Supports both AWS and Azure Ocean clusters with multi-account access.

Tools (34)

Cross-Account

Tool	Description
`list_accounts`	List all Spotinst accounts accessible with the current token
`list_all_clusters`	List ALL clusters across ALL accounts and clouds (AWS + Azure)

AWS Ocean

Tool	Description
`list_clusters`	List AWS Ocean K8s clusters
`get_cluster`	Get AWS Ocean cluster details
`list_vngs`	List AWS Virtual Node Groups (launch specs)
`get_vng`	Get AWS VNG details
`list_elastigroups`	List all Elastigroups
`get_elastigroup`	Get Elastigroup details
`get_allowed_instance_types`	Get allowed EC2 instance types
`get_right_sizing`	Get right-sizing resource suggestions (AWS only)

Azure Ocean

Tool	Description
`list_clusters_azure`	List Azure Ocean clusters
`get_cluster_azure`	Get Azure Ocean cluster details
`list_vngs_azure`	List Azure Virtual Node Groups
`get_vng_azure`	Get Azure VNG details

Both Clouds (pass `cloud="azure"` for Azure)

Tool	Description
`get_cluster_nodes`	List nodes in an Ocean cluster
`get_cluster_costs`	Get aggregated cost breakdown by namespace or resource
`list_rolls`	List deployment rolls
`get_roll`	Get roll details
`get_cluster_log`	Get scaling and activity log events

Stateful Nodes (AWS Managed Instances)

Tool	Description
`list_stateful_nodes`	List all Stateful Nodes (Managed Instances)
`get_stateful_node`	Get Stateful Node details

Scheduling & Health

Tool	Description
`get_cluster_scheduling`	Get scheduling and auto-scaler configuration
`get_cluster_health`	Composite health check: nodes, recent errors, active rolls

Cost Analysis

Tool	Description
`get_cost_trending`	Week-over-week (or custom period) cost comparison
`get_savings_summary`	30-day cost and savings summary

Tag Filtering

Tool	Description
`filter_clusters_by_tag`	Filter clusters by tag key/value
`filter_vngs_by_tag`	Filter VNGs by tag key/value

Export (YAML)

Tool	Description
`export_cluster_yaml`	Export cluster config as YAML for GitOps/backup
`export_vng_yaml`	Export VNG config as YAML for GitOps/backup

Write Operations (require `confirm=true`)

Tool	Description
`remove_instances`	Recommended — Remove instances using a named strategy (see below)
`initiate_roll`	Rolling restart of nodes in an Ocean cluster
`detach_instances`	Detach and optionally terminate instances from an AWS Ocean cluster
`update_vng`	Update an AWS VNG configuration
`update_vng_azure`	Update an Azure VNG configuration

All tools accept an optional account_id parameter to query any account.

Instance Removal Strategies

The remove_instances tool provides a safe, intent-based interface for removing instances. Instead of remembering which API flags to set, you pick a strategy:

Strategy	What happens	Use case
`drain_and_replace`	Gracefully drain pods (respects PDBs), terminate, Ocean replaces. Default and safest.	Replacing a problematic node in production
`replace`	Immediately terminate, Ocean auto-replaces. No graceful drain. AWS only.	Fast replacement when drain isn't needed
`remove_permanently`	Terminate + reduce cluster capacity. No replacement. AWS only.	Downsizing the cluster

When confirm=false (default), the tool shows a detailed execution plan so you can review before proceeding:

Code

remove_instances("o-abc123", "i-abc123", strategy="drain_and_replace")

→ SAFETY: Action NOT executed. Set confirm=true to proceed.
  DRAIN AND REPLACE 1 instance(s) in cluster o-abc123:
    Instances: ['i-abc123']
    Method: Rolling restart (20% per batch)
    - Pods will be gracefully drained (PDBs respected)
    - Instances will be terminated after drain
    - Ocean will automatically launch replacements

Setup

Environment Variables

server.ts

export SPOTINST_TOKEN="your-spotinst-api-token"
export SPOTINST_ACCOUNT_ID="act-xxxxxxxx"

Install with pip

Terminal

pip install mcp-server-spotinst

Install with uvx (no install needed)

bash

uvx mcp-server-spotinst

Claude Code Config

Add to ~/.mcp.json:

config.json

{
  "mcpServers": {
    "spotinst": {
      "command": "uvx",
      "args": ["mcp-server-spotinst"],
      "env": {
        "SPOTINST_TOKEN": "your-token",
        "SPOTINST_ACCOUNT_ID": "act-xxxxxxxx"
      }
    }
  }
}

Docker