Model Context Protocol (MCP)

AI Tools

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.

  1. Sign up for Rackspace Spot: Create an account at spot.rackspace.com.

  2. Create an organization: The MCP server operates within an organization - it needs somewhere to provision Cloudspaces and VMs.

  3. Add billing details: Add a valid payment method before creating your first bid in a Cloudspace.

  4. 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

Hosted MCP Server

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

Run the following command in your Terminal.

claude mcp add --transport http rackspace-spot https://mcp.spot.rackspace.com/mcp

Add to your MCP configuration (~/.cursor/mcp.json or Settings → MCP):

{ "mcpServers": { "rackspace-spot": { "url": "https://mcp.spot.rackspace.com/mcp" } } }

Run the following command in your Terminal.

codex mcp add rackspace-spot --url https://mcp.spot.rackspace.com/mcp

Add to .vscode/mcp.json in your workspace, or your user settings.json:

{ "servers": { "rackspace-spot": { "type": "http", "url": "https://mcp.spot.rackspace.com/mcp" } } }

Devin supports remote MCP servers natively over HTTP. Run the following command in your Terminal.

devin mcp add rackspace-spot https://mcp.spot.rackspace.com/mcp

Any client that supports a remote HTTP MCP server works with the hosted configuration. Clients without native remote-MCP support can connect through the mcp-remote bridge:

{ "mcpServers": { "rackspace-spot": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.spot.rackspace.com/mcp"] } } }
Bridge not connecting after browser login?

Some GUI clients spawn mcp-remote twice, which can kill the OAuth callback listener before the redirect arrives (mcp-remote#245). Run the bridge once in a terminal to authenticate with npx -y mcp-remote@latest https://mcp.spot.rackspace.com/mcp, then restart your client - it reuses the cached token.


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

Prompt

"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

Prompt

"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

Prompt

"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