Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Spotinst MCP ServerList all my Ocean clusters across all clouds and show their current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-spotinst
MCP server for the Spot.io (Spotinst) API. Supports both AWS and Azure Ocean clusters with multi-account access.
Tools (19)
Cross-Account
Tool | Description |
| List all Spotinst accounts accessible with the current token |
| List ALL clusters across ALL accounts and clouds (AWS + Azure) |
AWS Ocean
Tool | Description |
| List AWS Ocean K8s clusters |
| Get AWS Ocean cluster details |
| List AWS Virtual Node Groups (launch specs) |
| Get AWS VNG details |
| List all Elastigroups |
| Get Elastigroup details |
| Get allowed EC2 instance types |
| Get right-sizing resource suggestions (AWS only) |
Azure Ocean
Tool | Description |
| List Azure Ocean clusters |
| Get Azure Ocean cluster details |
| List Azure Virtual Node Groups |
| Get Azure VNG details |
Both Clouds (pass cloud="azure" for Azure)
Tool | Description |
| List nodes in an Ocean cluster |
| Get aggregated cost breakdown by namespace or resource |
| List deployment rolls |
| Get roll details |
| Get scaling and activity log events |
All tools accept an optional account_id parameter to query any account.
Setup
Environment Variables
export SPOTINST_TOKEN="your-spotinst-api-token"
export SPOTINST_ACCOUNT_ID="act-xxxxxxxx"Install with pip
pip install mcp-server-spotinstInstall with uvx (no install needed)
uvx mcp-server-spotinstClaude Code Config
Add to ~/.mcp.json:
{
"mcpServers": {
"spotinst": {
"command": "uvx",
"args": ["mcp-server-spotinst"],
"env": {
"SPOTINST_TOKEN": "your-token",
"SPOTINST_ACCOUNT_ID": "act-xxxxxxxx"
}
}
}
}Run Standalone
mcp-server-spotinstMulti-Account Usage
Your personal API token can access multiple Spotinst accounts. Use list_accounts to see all available accounts, then pass account_id to any tool:
list_clusters(account_id="act-be5e7ffe")
get_cluster_nodes("o-390ef886", account_id="act-9785011e", cloud="azure")Or use list_all_clusters for a single-call inventory across everything.
API Reference
Uses the Spot.io REST API at https://api.spotinst.io.