Spotinst MCP Server

List all Spotinst accounts accessible with the current token.

List ALL Ocean clusters across ALL accounts and cloud providers (AWS + Azure). Scans every account in parallel and returns a unified list with account and cloud info.

List AWS Ocean Kubernetes clusters in a Spotinst account.

Args: account_id: Optional account ID to query (e.g. act-be5e7ffe). Defaults to SPOTINST_ACCOUNT_ID env var.

Get details of a specific AWS Ocean cluster.

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

List Azure Ocean clusters in a Spotinst account.

Args: account_id: Account ID for an Azure account (e.g. act-9785011e).

Get details of a specific Azure Ocean cluster.

Args: cluster_id: The Ocean cluster ID (e.g. o-390ef886) account_id: Account ID for an Azure account.

List AWS Ocean Virtual Node Groups (VNGs / launch specs).

Args: ocean_id: Optional Ocean cluster ID to filter by (e.g. o-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

Get details of a specific AWS VNG (launch spec).

Args: vng_id: The VNG/launch spec ID (e.g. ols-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

List Azure Ocean Virtual Node Groups.

Args: ocean_id: Optional Ocean cluster ID to filter by (e.g. o-390ef886) account_id: Account ID for an Azure account.

Get details of a specific Azure VNG.

Args: vng_id: The VNG ID (e.g. vng-14e08b61) account_id: Account ID for an Azure account.

List all Elastigroups in a Spotinst account.

Args: account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

Get details of a specific Elastigroup.

Args: group_id: The Elastigroup ID (e.g. sig-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

List all nodes in an Ocean cluster (AWS or Azure).

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

Get aggregated cost breakdown for an Ocean cluster (AWS or Azure).

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) start_time: Start time in ISO 8601 format (e.g. 2026-03-01T00:00:00Z) end_time: End time in ISO 8601 format (e.g. 2026-03-20T00:00:00Z) group_by: Group costs by: namespace or resource (default: namespace) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

Get right-sizing resource suggestions for workloads in an AWS Ocean cluster.

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) namespace: Optional namespace to filter suggestions account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

List all deployment rolls for an Ocean cluster (AWS or Azure).

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

Get details of a specific Ocean cluster roll (AWS or Azure).

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) roll_id: The roll ID (e.g. scr-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

Get scaling and activity log events for an Ocean cluster (AWS or Azure).

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) from_date: Start date in YYYY-MM-DD format (e.g. 2026-03-19) to_date: End date in YYYY-MM-DD format (e.g. 2026-03-20) severity: Filter by severity: ALL, INFO, WARN, ERROR (default: ALL) limit: Max number of log entries (default: 500) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

Get the list of allowed EC2 instance types for an AWS Ocean cluster.

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) account_id: Optional account ID to query. Defaults to SPOTINST_ACCOUNT_ID env var.

DESTRUCTIVE: Initiate a rolling restart of nodes in an Ocean cluster. This will drain and replace nodes in batches. Requires confirm=true.

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) confirm: Must be true to execute. Safety guard against accidental rolls. batch_size_percentage: Percentage of nodes to roll per batch (default: 20) batch_min_healthy_percentage: Min healthy nodes per batch (default: 50) respect_pdb: Respect PodDisruptionBudgets (default: true) launch_spec_ids: Comma-separated VNG IDs to roll (e.g. ols-abc,ols-def). Empty = all. instance_ids: Comma-separated instance IDs to roll. Empty = all in scope. account_id: Optional account ID. Defaults to SPOTINST_ACCOUNT_ID env var. cloud: Cloud provider: aws or azure (default: aws)

DESTRUCTIVE: Detach and optionally terminate instances from an AWS Ocean cluster. Requires confirm=true.

Args: cluster_id: The Ocean cluster ID (e.g. o-abc12345) instance_ids: Comma-separated EC2 instance IDs (e.g. i-abc123,i-def456) confirm: Must be true to execute. Safety guard. should_terminate: Terminate instances after detach (default: true) should_decrement_capacity: Reduce target capacity (default: true) account_id: Optional account ID. Defaults to SPOTINST_ACCOUNT_ID env var.

DESTRUCTIVE: Update an AWS VNG (launch spec) configuration. Requires confirm=true. Pass updates as a JSON string.

Args: vng_id: The VNG/launch spec ID (e.g. ols-abc12345) updates_json: JSON string of fields to update (e.g. '{"resourceLimits": {"maxInstanceCount": 20}}') confirm: Must be true to execute. Safety guard. account_id: Optional account ID. Defaults to SPOTINST_ACCOUNT_ID env var.

DESTRUCTIVE: Update an Azure VNG configuration. Requires confirm=true. Pass updates as a JSON string.

Args: vng_id: The VNG ID (e.g. vng-14e08b61) updates_json: JSON string of fields to update confirm: Must be true to execute. Safety guard. account_id: Account ID for an Azure account.