Skip to content
MCP server

SnapDeploy

Deploy and manage SnapDeploy containers from chat, with scoped tokens and no delete

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, Web, API
Runs
Locally
Version
0.1.2
Listing updated
2 days ago

About SnapDeploy

SnapDeploy is a freemium MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • SNAPDEPLOY_API_KEYScoped personal access token (sd_pat_…) from https://snapdeploy.dev/api-keysRequired
  • SNAPDEPLOY_READ_ONLYSet to 1 to expose only the read tools

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $12 a month

Free Small container that sleeps when idle; Always-On from $12/month per container; databases from $14/month.

Prices change. Check snapdeploy.dev before you buy.

SnapDeploy 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 to SnapDeploy

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools