basicdeploy-mcp

BasicDeploy MCP Server

The persistent runtime your agent deploys to — DB, storage, URL, one MCP call.

An MCP (Model Context Protocol) server that lets AI coding agents — Claude Code, Cursor, and any other MCP client — deploy and manage BasicDeploy containers directly: create containers, deploy apps from a tarball, run commands, read logs, and share or delete containers.

Install

Requires Node.js >= 18.

cd mcp
npm install

You can also run it via npx/the basicdeploy-mcp bin once published, or point your MCP client at node /path/to/mcp/src/index.js.

Get an API key

• Log in to the BasicDeploy dashboard.
• Go to API Keys and click Create.
• Copy the key (it looks like bd_<40 characters>) — it is shown only once.

The server reads two environment variables:

Variable	Required	Description
BASICDEPLOY_API_KEY	Yes	Your API key (bd_...). The server refuses to start without it.
BASICDEPLOY_URL	No	API base URL. Defaults to https://basicdeploy.com.

Configure Claude Code

claude mcp add basicdeploy \
  --env BASICDEPLOY_API_KEY=bd_your_key_here \
  --env BASICDEPLOY_URL=https://basicdeploy.com \
  -- node /absolute/path/to/mcp/src/index.js

Configure via mcpServers JSON (Cursor, Claude Desktop, etc.)

{
  "mcpServers": {
    "basicdeploy": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/src/index.js"],
      "env": {
        "BASICDEPLOY_API_KEY": "bd_your_key_here",
        "BASICDEPLOY_URL": "https://basicdeploy.com"
      }
    }
  }
}

Tools

Tool	Arguments	Description
list_containers	—	List your containers: subdomain, status, URL, id, createdAt.
create_container	—	Create a new container. Database + S3 bucket are provisioned automatically.
get_container	containerId	Full details: URL, status, ports, DB name/user, S3 bucket, volume path.
exec_command	containerId, command	Run a shell command inside the container; returns output and exit code.
get_logs	containerId, tail? (default 200)	Fetch recent container logs.
deploy_app	containerId?, tarballPath	Deploy a .tar/.tar.gz/.tgz/.zip from disk. Auto-detects Node/Python/Go. Creates a new container when containerId is omitted.
share_container	containerId, email, expiresInHours?	Share a container with another user by email; they are emailed a sign-in link. Optional expiresInHours expires the share (omit for unlimited).
delete_container	containerId	Permanent — destroys the container, its database, and all files.

Example prompts

Once configured, you can ask your agent things like:

• "Deploy ./dist/app.tar.gz to BasicDeploy and give me the URL."
• "Show me the last 100 log lines of my blue-fox container."
• "Run ls -la /app inside container <id>."
• "Share my container with [e-mail]."