ScalePad MCP

The ScalePad Model Context Protocol (MCP) server lets compatible AI clients connect directly to the ScalePad API reference and, when configured with authentication, make live API calls — all from within your favorite AI-powered editor or assistant.

What the ScalePad MCP server can do

The ScalePad MCP server is powered by ReadMe and exposes the following capabilities to supported AI clients.

OpenAPI Tools

list-endpointsList available API paths, methods, and summaries

get-endpointInspect a specific endpoint — parameters, descriptions, and security requirements

search-specsSearch API paths, operations, and schemas

execute-requestMake a live API call

list-specsList available API specs with their titles

get-server-variablesReturn server variables when defined

Documentation Tools

searchFull-text search across all guide pages, returning matches with titles and IDs

fetchRetrieve the full content of a specific guide page by ID

Authentication

Required for live API calls

For live API execution via execute-request, configure your MCP client to forward the authentication header:

x-api-key: YOUR_SCALEPAD_API_KEY

When configured, this header is automatically forwarded to live API calls.

ScalePad MCP Server URL

MCP Server Endpoint

https://developer.scalepad.com/mcp

Use this URL when configuring any of the clients below.

Client setup

Choose your AI client below and follow the setup instructions.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scalepad": {
      "url": "https://developer.scalepad.com/mcp",
      "headers": {
        "x-api-key": "SCALEPAD_API_KEY"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "scalepad": {
      "serverUrl": "https://developer.scalepad.com/mcp",
      "headers": {
        "x-api-key": "${env:SCALEPAD_API_KEY}"
      }
    }
  }
}

Create .vscode/mcp.json in your workspace:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "scalepad-api-key",
      "description": "ScalePad API key",
      "password": true
    }
  ],
  "servers": {
    "scalepad": {
      "type": "http",
      "url": "https://developer.scalepad.com/mcp",
      "headers": {
        "x-api-key": "${input:scalepad-api-key}"
      }
    }
  }
}

Claude Desktop use the Developers UI for remote MCP servers.

Note

•The ScalePad MCP server forwards headers, please use Developer Settings and edit your claude_desktop_config file rather than using the custom connector flow.

•If both are configured, Claude may fall back to the custom connector setup and override your local config. This setup is desktop-only and will not appear in the Claude web app.

Open Settings → Developer
Click Edit Config
Open claude_desktop_config.json
Enable the connector in the conversation where you want to use it

Local Claude Desktop config for remote MCP server (macOS / Linux):

{
  "mcpServers": {
    "scalepad": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developer.scalepad.com/mcp",
        "--header",
        "x-api-key: ${API_KEY}"
      ],
      "env": {
        "API_KEY": "YOUR_SCALEPAD_API_KEY"
      }
    }
  }
}

On Windows, npx resolves to npx.cmd, which Claude Desktop's process launcher can't execute directly — leaving the command as "npx" fails with spawn npx ENOENT. Wrap it with cmd /c:

{
  "mcpServers": {
    "scalepad": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://developer.scalepad.com/mcp",
        "--header",
        "x-api-key: ${API_KEY}"
      ],
      "env": {
        "API_KEY": "YOUR_SCALEPAD_API_KEY"
      }
    }
  }
}

macOS / Linux — run the following command:

claude mcp add --transport http scalepad https://developer.scalepad.com/mcp \
  --header "x-api-key: YOUR_SCALEPAD_API_KEY"

On Windows, the trailing \ line continuation isn't valid in PowerShell or Command Prompt. Run it as a single line instead (this also works in any shell):

claude mcp add --transport http scalepad https://developer.scalepad.com/mcp --header "x-api-key: YOUR_SCALEPAD_API_KEY"

Verify your .claude.json contains:

{
  "mcpServers": {
    "scalepad": {
      "url": "https://developer.scalepad.com/mcp",
      "headers": {
        "x-api-key": "SCALEPAD_API_KEY"
      }
    }
  }
}

Configure via the Roo Code sidebar:

Open the Roo Code panel in the VS Code sidebar
Click the MCP Servers icon (server plug icon at the top of the panel)
Click Edit MCP Settings to open mcp_settings.json
Add the following configuration:

macOS / Linux:

{
  "mcpServers": {
    "scalepad": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developer.scalepad.com/mcp",
        "--header",
        "x-api-key: YOUR_SCALEPAD_API_KEY"
      ]
    }
  }
}

On Windows, npx resolves to npx.cmd, which can't be spawned directly — leaving the command as "npx" fails with spawn npx ENOENT. Wrap it with cmd /c:

{
  "mcpServers": {
    "scalepad": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://developer.scalepad.com/mcp",
        "--header",
        "x-api-key: YOUR_SCALEPAD_API_KEY"
      ]
    }
  }
}

Testing your MCP setup

Once configured, try any of these prompts in your AI client to verify the connection:

"List all available ScalePad API endpoints"

Discovers API pathslist-endpoints

"Show me the details for the List Hardware Assets endpoint"

Inspects an endpointget-endpoint

"Search the ScalePad API for anything related to clients"

Searches specssearch-specs

"Get me a list of all my clients"

Makes a live API callexecute-request

"Search the ScalePad docs for authentication"

Searches guidessearch

"Fetch the MCP setup guide"

Retrieves a guide pagefetch

Notes

Keep in mind

•For authenticated API execution, make sure your client is forwarding the required ScalePad auth headers.

•If you connect to a version-specific ReadMe branch, documentation search tools may not be available on that branch-specific MCP URL.

•This MCP server is provided through ReadMe.io, a third-party service that also hosts ScalePad’s API documentation.