sota.io

MCP Setup

The sota.io MCP server lets AI agents like Claude Code, Claude Desktop, Cursor, and Windsurf deploy, manage, and monitor applications natively through the Model Context Protocol.

The MCP server is open source: GitHub | npm

What is MCP?

MCP (Model Context Protocol) enables AI assistants to interact with external tools and services. The sota.io MCP server exposes 8 platform operations as tools that AI agents can invoke directly — no CLI or API calls needed.

Installation

Run directly with npx (no install required):

npx -y @sota-io/mcp

Or install globally:

npm install -g @sota-io/mcp

Requirements: Node.js >= 20

Prerequisites

You need a sota.io API key to authenticate the MCP server. Create one at Dashboard Settings or see API Keys.

IDE Configuration

Each IDE has its own MCP configuration format. Choose yours below — every snippet is copy-paste ready.

Claude Code

CLI method (recommended):

claude mcp add sota -- npx -y @sota-io/mcp

Then set your API key:

export SOTA_API_KEY=sota_your_api_key_here

Manual JSON — add to .claude/settings.json:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Authentication

The MCP server authenticates using the SOTA_API_KEY environment variable. This must be set in the env block of your MCP configuration — shell environment variables do not automatically pass to MCP servers.

Create an API key at Dashboard Settings. Keys use the sota_ prefix.

Verify Setup

After configuration, ask your AI assistant:

"List my sota.io projects"

The assistant should invoke the list-projects tool and return your project list. If you see an error, check the Troubleshooting section.

Troubleshooting

npx: command not found

If you use nvm or fnm, your IDE may not inherit the shell PATH. Use the absolute path to npx:

which npx
# Example: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

Replace "command": "npx" with the full path in your MCP config:

{
  "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
  "args": ["-y", "@sota-io/mcp"]
}

SOTA_API_KEY not set

The env block in MCP config is required. Every config snippet above includes it — make sure you've added your actual API key.

Next Steps