Sota

io.github.sota-deploy

Deploy web apps via AI agents with sota.io. 9 tools for deploy, logs, env, and more.

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.sota-deploy-sota": {4      "command": "npx",5      "args": [6        "-y",7        "@sota-io/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @sota-io/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.sota-deploy-sota -- npx -y @sota-io/mcp@1.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.sota-deploy-sota": {4      "command": "npx",5      "args": [6        "-y",7        "@sota-io/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.1.1
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Sota?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Sota need an API key?

No required environment variable is listed on this record.

What transport does Sota use?

Sota runs locally over stdio.

When was Sota last checked?

Last checked 2026-10-28. Deploy web apps via AI agents with sota.io. 9 tools for deploy, logs, env, and more.

From the publisher

Documentation

@sota-io/mcp

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

Two transports

Since v1.4.0 this package ships two transports:

sota-mcp (stdio, default) — for Claude Code, Cursor, Windsurf, and any MCP client that spawns a local process. Pass your SOTA_API_KEY via env var.
sota-mcp-http (Streamable HTTP) — for self-hosting the remote endpoint that powers mcp.sota.io (used by Claude Desktop and Claude.ai web). Reads SUPABASE_JWT_SECRET, DATABASE_URL, etc. — most users do not need this; it's the same code that runs on mcp.sota.io if you want to host your own.

Most users want the stdio transport.

One-click install for Claude Desktop / Claude.ai web

If you use Claude Desktop or Claude.ai (Pro / Max / Team / Enterprise plan), the easiest install is not this npm package — it's the hosted remote endpoint at mcp.sota.io. Click here:

Add to Claude →

OAuth handles auth. New users can sign up entirely inside Claude via the create_account tool — no browser tab switch.

See https://sota.io/docs/integrations/claude.

Quick Start (stdio — Claude Code, Cursor, Windsurf, …)

Get an API key from sota.io/dashboard/settings
Configure your IDE
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`
`add-domain`	Add custom domain to project	`project_id`, `domain`
`list-domains`	List custom domains	`project_id`
`get-domain`	Get domain details and DNS status	`project_id`, `domain_id`
`remove-domain`	Remove custom domain	`project_id`, `domain_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"

`add-domain`

Add a custom domain to a project. Returns DNS instructions for pointing the domain.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain`	string	Yes	Domain name (e.g., "example.com" or "app.example.com")

"Add example.com as a custom domain to my project"

`list-domains`

List all custom domains for a project.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID

"Show all custom domains for my project"

`get-domain`

Get domain details including DNS verification status and SSL state.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain_id`	string	Yes	Domain ID

"Check the DNS status of my custom domain"

`remove-domain`

Remove a custom domain from a project.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain_id`	string	Yes	Domain ID to remove

"Remove the custom domain from my project"

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

Sota

io.github.sota-deploy

Deploy web apps via AI agents with sota.io. 9 tools for deploy, logs, env, and more.

Devops

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.sota-deploy-sota": {4      "command": "npx",5      "args": [6        "-y",7        "@sota-io/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @sota-io/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.sota-deploy-sota -- npx -y @sota-io/mcp@1.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.sota-deploy-sota": {4      "command": "npx",5      "args": [6        "-y",7        "@sota-io/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.1.1
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Sota?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Sota need an API key?

No required environment variable is listed on this record.

What transport does Sota use?

Sota runs locally over stdio.

When was Sota last checked?

Last checked 2026-10-28. Deploy web apps via AI agents with sota.io. 9 tools for deploy, logs, env, and more.

From the publisher

Documentation

@sota-io/mcp

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

Two transports

Since v1.4.0 this package ships two transports:

sota-mcp (stdio, default) — for Claude Code, Cursor, Windsurf, and any MCP client that spawns a local process. Pass your SOTA_API_KEY via env var.
sota-mcp-http (Streamable HTTP) — for self-hosting the remote endpoint that powers mcp.sota.io (used by Claude Desktop and Claude.ai web). Reads SUPABASE_JWT_SECRET, DATABASE_URL, etc. — most users do not need this; it's the same code that runs on mcp.sota.io if you want to host your own.

Most users want the stdio transport.

One-click install for Claude Desktop / Claude.ai web

If you use Claude Desktop or Claude.ai (Pro / Max / Team / Enterprise plan), the easiest install is not this npm package — it's the hosted remote endpoint at mcp.sota.io. Click here:

Add to Claude →

OAuth handles auth. New users can sign up entirely inside Claude via the create_account tool — no browser tab switch.

See https://sota.io/docs/integrations/claude.

Quick Start (stdio — Claude Code, Cursor, Windsurf, …)

Get an API key from sota.io/dashboard/settings
Configure your IDE
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`
`add-domain`	Add custom domain to project	`project_id`, `domain`
`list-domains`	List custom domains	`project_id`
`get-domain`	Get domain details and DNS status	`project_id`, `domain_id`
`remove-domain`	Remove custom domain	`project_id`, `domain_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`

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"

`add-domain`

Add a custom domain to a project. Returns DNS instructions for pointing the domain.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain`	string	Yes	Domain name (e.g., "example.com" or "app.example.com")

"Add example.com as a custom domain to my project"

`list-domains`

List all custom domains for a project.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID

"Show all custom domains for my project"

`get-domain`

Get domain details including DNS verification status and SSL state.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain_id`	string	Yes	Domain ID

"Check the DNS status of my custom domain"

`remove-domain`

Remove a custom domain from a project.

Parameter	Type	Required	Description
`project_id`	string	Yes	Project ID
`domain_id`	string	Yes	Domain ID to remove

"Remove the custom domain from my project"

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Sota?

Does Sota need an API key?

What transport does Sota use?

When was Sota last checked?

Documentation

@sota-io/mcp

Two transports

One-click install for Claude Desktop / Claude.ai web

Quick Start (stdio — Claude Code, Cursor, Windsurf, …)

Installation

Configuration

Claude Code

Claude Desktop

Cursor

Windsurf

Tools

deploy

get-logs

set-env

get-env

rollback

get-status

list-projects

create-project

delete-project

add-domain

list-domains

get-domain

remove-domain

Environment Variables

Troubleshooting

"npx: command not found"

"SOTA_API_KEY environment variable is required"

Connection refused or timeout errors

License

Links

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Sota?

Does Sota need an API key?

What transport does Sota use?

When was Sota last checked?

Documentation

@sota-io/mcp

Two transports

One-click install for Claude Desktop / Claude.ai web

Quick Start (stdio — Claude Code, Cursor, Windsurf, …)

Installation

Configuration

Claude Code

Claude Desktop

Cursor

Windsurf

Tools

deploy

get-logs

set-env

get-env

rollback

get-status

list-projects

create-project

delete-project

add-domain

list-domains

get-domain

remove-domain

Environment Variables

Troubleshooting

"npx: command not found"

"SOTA_API_KEY environment variable is required"

Connection refused or timeout errors

`deploy`

`get-logs`

`set-env`

`get-env`

`rollback`

`get-status`

`list-projects`

`create-project`

`delete-project`

`add-domain`

`list-domains`

`get-domain`

`remove-domain`

`deploy`

`get-logs`

`set-env`

`get-env`

`rollback`

`get-status`

`list-projects`

`create-project`

`delete-project`

`add-domain`

`list-domains`

`get-domain`

`remove-domain`