Model Context Protocol (MCP)

The Spot MCP server connects Claude, Cursor, VS Code, and other AI tools to the Rackspace Spot API. You can spin up Kubernetes clusters, scale node pools, provision VMs, and compare live spot prices - all without leaving your AI-powered development tools.

Before you begin

The MCP server acts on your behalf within a Rackspace Spot organization, so you need an account set up before your first tool call succeeds.

Sign up for Rackspace Spot. Create an account at spot.rackspace.com. Billing details are required before you can place a bid.
Create an organization. The MCP server operates within an organization - it needs somewhere to provision Cloudspaces and VMs.
Add the server to your client. Follow the steps for your agent below, then sign in with OAuth on the first tool call.

Connect your agent

The MCP server is exposed via the hosted endpoint - no install and no environment variables. Add the URL once and your agent handles the rest, signing you in with OAuth on the first tool call. https://mcp.spot.rackspace.com/mcp

Use cases

Below are some examples of what you can do with the Spot MCP server on day one. Each is a single plain-language request that the server fulfills by calling the Spot API for you.

Price-shop before you provision

"What's the cheapest region to run 3 large nodes right now?"

The server compares live spot prices across regions and server classes and recommends a bid. Market research that normally means clicking through the dashboard becomes one question with a clear answer.

Spin up a cheap cluster on spot instances

"Give me a 3-node dev Kubernetes cluster in us-central, bid $0.02/hr."

The server provisions a CloudSpace and a spot node pool at spot-market prices and hands back the cluster. Ideal for ephemeral dev, test, and CI environments at a fraction of the usual cost.

Provision VMs conversationally

"Create an SSH key and launch 2 memory-heavy VMs."

The server runs the whole sequence in order. Self-service compute becomes approachable for engineers who'd rather describe what they need than write Terraform.

Available tools

Nearly 40 tools span discovery, pricing, Kubernetes, and VMs. Your agent picks the right ones for each request - you rarely need to name a tool yourself.

Discovery

Tool	Description
`listRegions`	List all available regions in Rackspace Spot
`getRegion`	Get details of a specific region
`searchServers`	Search for servers by region, cores, memory, and price
`listServerClasses`	List available server classes with pricing, optionally filtered by region
`getServerClass`	Get details of a specific server class

Organizations

Tool	Description
`listOrganizations`	List the organizations your login has access to

Kubernetes CloudSpaces

A CloudSpace is a managed Kubernetes cluster.

Tool	Description
`listCloudspaces`	List all Kubernetes CloudSpaces in an organization
`getCloudspace`	Get details of a specific Kubernetes CloudSpace
`createCloudspace`	Create a new Kubernetes CloudSpace
`deleteCloudspace`	Delete a Kubernetes CloudSpace
`getCloudspaceKubeconfig`	Get the kubeconfig YAML for a CloudSpace (for `kubectl` access)

Node pools

Spot pools are bid-based and preemptible; On-Demand pools are stable.

Tool	Description
`listSpotNodePools`	List all Spot node pools in a CloudSpace
`getSpotNodePool`	Get details of a specific Spot node pool
`createSpotNodePool`	Create a Spot node pool in a CloudSpace
`updateSpotNodePool`	Update a Spot node pool (scale nodes or change bid price)
`deleteSpotNodePool`	Delete a Spot node pool
`listOnDemandNodePools`	List all On-Demand node pools in a CloudSpace
`getOnDemandNodePool`	Get details of a specific On-Demand node pool
`createOnDemandNodePool`	Create an On-Demand node pool in a CloudSpace
`updateOnDemandNodePool`	Update an On-Demand node pool (scale nodes)
`deleteOnDemandNodePool`	Delete an On-Demand node pool

VM CloudSpaces & pools

Tool	Description
`listVMCloudSpaces`	List all VM CloudSpaces in an organization
`getVMCloudSpace`	Get details of a specific VM CloudSpace
`createVMCloudSpace`	Create a new VM CloudSpace
`deleteVMCloudSpace`	Delete a VM CloudSpace
`listVMPools`	List all VM pools in a VM CloudSpace
`getVMPool`	Get details of a specific VM pool
`createVMPool`	Create a new VM pool in a VM CloudSpace
`updateVMPool`	Update a VM pool (scale instances)
`deleteVMPool`	Delete a VM pool

Last updated on

Was this page helpful?