# SnapDeploy

> SnapDeploy is a freemium MCP server for cloud and infrastructure. Deploy and manage SnapDeploy containers from chat, with scoped tokens and no delete. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** CLI, Web, API
- **Website:** https://snapdeploy.dev/docs/mcp
- **Repository:** https://github.com/aar-labs/snapdeploy-mcp
- **MCP Registry name:** io.github.somdip-2310/snapdeploy
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

SnapDeploy is a container host, and this connector lets an assistant ship apps to it. Saying deploy this repo links a connected GitHub repository, starts the build, waits, and returns the live URL, or the error code, message and tail of the build log. A repeat of the same request within ten minutes returns the original deployment instead of building again.

The tools are grouped by token scope: read (list_apps, get_status, get_logs, get_deployments, check_quota, list_repos, detect_env_vars), deploy (deploy, deploy_image, set_env, start_container, stop_container, wake_container) and manage (create_database, add_domain, assign_always_on). deploy_image uploads a docker save archive built for linux/arm64, up to 2 GB on the free tier and 10 GB on Always-On. Setting SNAPDEPLOY_READ_ONLY=1 exposes only the read tools.

The safety model is strict: deleting containers, add-ons, domains or the account, cancelling subscriptions and changing passwords are refused server-side for every token and need a person signed in to the dashboard. Environment variable values come back as (set) and add-on credentials are masked. Tokens are shown once, can expire in 30, 90 or 365 days or never, and have their own rate limit.

On the platform, a Small container is free and sleeps after 15 minutes idle; Always-On starts at $12 a month.

## Features

- **One-step deploys:** Link the repo, build and return a live URL or the build error.
- **Docker image upload:** Deploy a docker save archive of up to 2 GB free or 10 GB on Always-On.
- **Nested token scopes:** Read, deploy and manage scopes limit what a token may do.
- **No deletion:** Deletes and cancellations are blocked for every token.
- **Masked secrets:** Environment values return as (set) and credentials are masked.
- **Read-only mode:** An environment switch exposes only the read tools.

## Good for

- Ship a GitHub repository to a live URL from chat
- Read build logs after a failed deploy
- Set environment variables without exposing their values
- Add a managed database or custom domain from an assistant
- Check quota before deploying

## Install

### Claude Code (Terminal)

```sh
claude mcp add snapdeploy --env SNAPDEPLOY_API_KEY='<SNAPDEPLOY_API_KEY>' -- npx -y @snapdeploy/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": [
        "-y",
        "@snapdeploy/mcp"
      ],
      "env": {
        "SNAPDEPLOY_API_KEY": "<SNAPDEPLOY_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": [
        "-y",
        "@snapdeploy/mcp"
      ],
      "env": {
        "SNAPDEPLOY_API_KEY": "<SNAPDEPLOY_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "snapdeploy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@snapdeploy/mcp"
      ],
      "env": {
        "SNAPDEPLOY_API_KEY": "<SNAPDEPLOY_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": [
        "-y",
        "@snapdeploy/mcp"
      ],
      "env": {
        "SNAPDEPLOY_API_KEY": "<SNAPDEPLOY_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": [
        "-y",
        "@snapdeploy/mcp"
      ],
      "env": {
        "SNAPDEPLOY_API_KEY": "<SNAPDEPLOY_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_apps`: Lists your apps.
- `get_status`: Returns the status of a container.
- `get_logs`: Returns logs for a container.
- `get_deployments`: Lists deployments.
- `check_quota`: Shows plan quota usage.
- `list_repos`: Lists connected GitHub repositories.
- `detect_env_vars`: Scans a repository for environment variables and where they were found.
- `deploy`: Creates the container if needed, builds from a repository and returns the live URL.
- `deploy_image`: Uploads and deploys a Docker image archive.
- `set_env`: Sets environment variables.
- `start_container`: Starts a container.
- `stop_container`: Stops a container.
- `wake_container`: Wakes a sleeping container.
- `create_database`: Creates a managed database add-on.
- `add_domain`: Attaches a custom domain.
- `assign_always_on`: Assigns a spare Always-On slot to a container.

## FAQ

### Can an assistant delete my app?

No. Deletion is refused server-side for every token.

### Does it need a GitHub repo?

deploy builds from a connected GitHub repository; deploy_image takes a Docker archive instead.

### What does hosting cost?

A Small container is free; Always-On Small is $12 a month, Medium $25 and Large $45.

### How is it installed?

Through npx @snapdeploy/mcp with a SNAPDEPLOY_API_KEY token.

### Which image architecture is needed?

linux/arm64 for uploaded images.

### Is SnapDeploy free?

SnapDeploy has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add SnapDeploy to Claude Code?

Run this command in your terminal: claude mcp add snapdeploy --env SNAPDEPLOY_API_KEY='<SNAPDEPLOY_API_KEY>' -- npx -y @snapdeploy/mcp

### What are the best alternatives to SnapDeploy?

The closest alternatives to SnapDeploy are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/snapdeploy
