Overview

The Scalr MCP (Model Context Protocol) Server enables AI assistants to interact with the Scalr API through natural language. Ask questions, query resources, create workspaces, and manage your infrastructure—all through conversation.

Currently, the MCP server runs locally, where you create the Docker container and makes direct API calls to your Scalr account.

In the example below, we'll configure ClaudeDesktop, Cursor client, or VS Code, but the MCP server will work with any MCP-compatible client.

Prerequisites

Regardless of the MCP client you are using, you will need to review the following prerequisites before using the MCP server.

• Docker installed and running on your machine. Docker must be running when starting the MCP server.
• Scalr API token (Personal Access Token or Service Account Token). Learn how to generate a token here. It is recommended to create a dedicated API token for the MCP server use with the minimum required permissions.
• MCP-compatible client (e.g., Claude Desktop)

Example LLM Configurations

Choose between Claude, Cursor, or VS Code depending on what you have installed locally:

The following section provides information specific to configuring the Claude desktop app and running the MCP server locally. To start, add the following configuration to your Claude Desktop config file:

1. Open Claude Settings
2. Navigate to "Developer"
3. Click "Add MCP Server"
4. Add the following to the config file.

JSON

{
  "mcpServers": {
    "scalr": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--pull=always",
        "--env",
        "SCALR_API_TOKEN=your_api_token_here",
        "--env",
        "SCALR_API_URL=https://your-account.scalr.io",
        "scalr/mcp-server:latest"
      ]
    }
  }
}

You must replace the following values:

• your_api_token_here with your actual Scalr API token
• your-account.scalr.io with your Scalr instance URL (e.g., mycompany.scalr.io)

Before restarting Claude, ensure that Docker is running on your machine. Once confirmed, close and reopen Claude Desktop to load the new configuration. Start with a simple question like "List all of my Scalr environments" to make sure that it is pulling the information back from the Scalr API:

Available MCP Tools

MCP tools give large language models (LLMs) the ability to perform actions by calling executable functions exposed by servers. The following tools are available for the Scalr MCP server.

Note: All endpoints marked with x-mcp-tool: true in the Scalr Public OpenAPI Specification are available as MCP tools.

Troubleshooting

Claude Desktop doesn't show Scalr tools

• Check configuration file syntax: Ensure your JSON is valid (use a JSON validator)
• Restart Claude Desktop: Completely quit and reopen the application
• Check Docker: Ensure Docker is running: docker ps
• View logs: Check Claude Desktop logs for errors:
  • macOS: ~/Library/Logs/Claude/mcp-server-scalr.log
  • Windows: %APPDATA%\Claude\Logs\mcp-server-scalr.log
  • Linux: ~/.config/Claude/logs/mcp-server-scalr.log

Authentication Errors

• Verify API token: Test your token with curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://your-account.scalr.io/api/iacp/v3/account

• Check token permissions: Ensure the token has appropriate read/write permissions

Docker pull errors

If you see "pull access denied" or network errors:

# Manually pull the image to test connectivity
docker pull scalr/mcp-server:latest

# Check if image exists
docker images | grep scalr/mcp-server

Tools not responding

• Check API connectivity: Ensure you can reach your Scalr instance
• Review rate limits: Check if you're hitting API rate limits
• Increase timeout: Docker might need more time on slower connections

Example Prompts

Here are some example questions you can ask Claude:

** Discovery & Exploration**

• "Show me all workspaces in the production environment"
• "Which Terraform modules are most used?"
• "What versions of Terraform are running across my infrastructure?"

Security

• "Review token usage in my account. Show tokens that don't have owners, have never been rotated, and don't have a description. Separate it into three outputs."
• "Suggest ways to tighten my Scalr account security"
• "How many tokens have not been rotated in the last 30 days"

Monitoring & Insights

• "Show me recent runs that failed"
• "What policy checks have failed recently?"
• "Show me usage statistics for AWS provider"

Management

• "Create a workspace named 'new-app-staging' in the dev environment"
• "Show me details about workspace ws-abc123"
• "List all VCS providers configured in my account"

Analytics

• "Which Terraform resources are most commonly used?"
• "Show me module usage by namespace"
• "What provider versions are in use?"
• "List all access tokens and their usage"

Support & Resources

• Scalr API Documentation: https://docs.scalr.io/reference/overview-1
• Model Context Protocol: https://modelcontextprotocol.io/
• Docker Hub: https://hub.docker.com/r/scalr/mcp-server