@sota-io/mcp

MCP server for sota.io — deploy web apps via AI agents.

Quick Start

1. Get an API key from sota.io/dashboard/settings
2. Configure your IDE
3. Ask your AI: "Deploy my app to sota.io"

Installation

No install needed — run directly with npx:

npx -y @sota-io/mcp

Or install globally:

npm install -g @sota-io/mcp
sota-mcp

Configuration

Claude Code

CLI method:

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

Then set your API key in the shell environment:

export SOTA_API_KEY=sota_your_api_key_here

Manual JSON (.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"
      }
    }
  }
}

Tools

| Tool | Description | Parameters | |------|-------------|------------| | deploy | Deploy an app | project_id, directory? | | get-logs | Get build/runtime logs | project_id, deployment_id? | | set-env | Set environment variable | project_id, key, value | | get-env | List environment variables | project_id | | rollback | Rollback to previous deployment | project_id | | get-status | Get deployment status | project_id | | list-projects | List all projects | (none) | | create-project | Create a new project | name | | delete-project | Delete a project permanently | project_id |

deploy

Deploy an application to sota.io. Creates a tar.gz archive of the specified directory and uploads it.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID to deploy to | | directory | string | No | Directory to deploy (defaults to current working directory) |

"Deploy my app in the current directory to sota.io"

get-logs

Get build and runtime logs for a deployment. If no deployment_id is provided, returns logs for the latest deployment.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID to get logs for | | deployment_id | string | No | Specific deployment ID (defaults to latest) |

"Show me the build logs for my sota.io project"

set-env

Set an environment variable for a project.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID | | key | string | Yes | Environment variable name (e.g., DATABASE_URL) | | value | string | Yes | Environment variable value |

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

List environment variables for a project.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID |

"Show all environment variables for my project"

rollback

Rollback a project to its previous deployment. This swaps the container image without rebuilding.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID to rollback |

"Roll back my app to the previous version"

get-status

Get the current deployment status for a project, including URL and recent deployment history.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID to check status for |

"What's the status of my sota.io deployment?"

list-projects

List all projects on your sota.io account.

No parameters required.

"List my sota.io projects"

create-project

Create a new project on sota.io. The project slug is auto-generated from the name (lowercase, hyphens, max 63 chars) and used as the subdomain ({slug}.sota.io). For example, "My API" becomes my-api.sota.io.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | name | string | Yes | Name for the new project |

"Create a new sota.io project called my-api"

delete-project

Delete a project and all its deployments from sota.io. This action is permanent.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | project_id | string | Yes | Project ID to delete |

"Delete my sota.io project abc123"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SOTA_API_KEY | Yes | — | API key with sota_ prefix. Create at sota.io/dashboard/settings | | SOTA_API_URL | No | https://api.sota.io | API base URL |

Troubleshooting

"npx: command not found"

Problem: Your IDE doesn't inherit the shell PATH where nvm/fnm is loaded.

Fix: Use the absolute path to npx. Find it with:

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

Then update your MCP config to use the absolute path:

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

"SOTA_API_KEY environment variable is required"

Problem: The API key is not set in your MCP configuration.

Fix: Add the env block to your MCP server config. Shell environment variables do not automatically pass to MCP servers — the env block in the config is required:

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

Connection refused or timeout errors

Problem: Network issue or wrong API URL.

Fix: Check your internet connection. If you're using a custom API URL, verify SOTA_API_URL is set correctly. The default is https://api.sota.io.

License

MIT

Links

• Website
• Documentation
• Dashboard
• Issues