AkaciaNL/basicdeploy-mcp

**The persistent runtime your agent deploys to: a database, object storage, a Kafka broker, and a public URL, one MCP call.**
An MCP (Model Context Protocol) server that lets AI coding agents (Claude Code, Cursor, and any MCP client) create and manage BasicDeploy containers directly. Every container comes with a PostgreSQL database, S3‑compatible object storage, a Kafka broker, environment variables, and a public HTTPS URL, all provisioned automatically. Your agent can create containers, deploy apps (Node, Python, Go, or Docker, auto‑detected), run commands, read logs, manage Kafka topics, check who it is authenticated as, set always‑on, and share or delete containers.
- 🌐 Site: https://basicdeploy.com
- 📦 npm: https://www.npmjs.com/package/basicdeploy-mcp
- 📚 Docs: https://basicdeploy.com/docs
Quick start
Requires Node.js ≥ 18. No install needed. npx fetches it on demand.
Get an API key at **https://basicdeploy.com/api-keys** (it looks like bd_…, shown once), then add this to your MCP client:
Claude Code:
Claude Code plugin (this repo doubles as a plugin marketplace):
Then set BASICDEPLOY_API_KEY in your environment (the plugin reads it via ${BASICDEPLOY_API_KEY}).
OpenAI Codex CLI:
or add it directly to ~/.codex/config.toml:
Environment variables
| Variable | Required | Description |
|---|---|---|
| BASICDEPLOY_API_KEY | Yes | Your API key (bd_…). Required to call any tool (the server still starts and lists its tools without it, so clients can introspect it). |
| BASICDEPLOY_URL | No | API base URL. Defaults to https://basicdeploy.com. |
Tools
| Tool | Arguments | Description |
|---|---|---|
| list_containers | (none) | List your containers: subdomain, status, URL, id, createdAt. |
| create_container | memoryMb? (256/512/1024/2048), alwaysOn? | Create a container. Database + S3 bucket provisioned automatically. Larger sizes need Pro/Scale; always‑on on Free uses a paid add‑on slot. |
| get_container | containerId | Full details: URL, status, ports, DB name/user, S3 bucket, volume path. |
| deploy_app | tarballPath, containerId? | Deploy a .tar/.tar.gz/.tgz/.zip from disk. Unpacks to /workspace, auto‑detects the runtime, and starts the app on :8080. Omit containerId to create a new container; pass one to deploy into an existing container. |
| exec_command | containerId, command | Run a shell command inside the container; returns output + exit code. |
| get_logs | containerId, tail? (default 200) | Fetch recent container logs. |
| set_always_on | containerId, enabled | Turn a container's 24/7 always‑on flag on/off. |
| wake_container | containerId | Wake a slept container so it serves traffic again. |
| sleep_container | containerId | Sleep a running container to free memory (wakes on next request). |
| get_account | (none) | Your plan, container limit (plan + add‑ons), selectable memory sizes, storage limit, and add‑ons. |
| share_container | containerId, email, expiresInHours? | Share a container with another user by email (they get a sign‑in link). Omit expiresInHours for an unlimited share. |