Lets AI agents deploy and manage containers with integrated PostgreSQL, S3 storage, and Kafka brokers via a single MCP call.
Also known as AkaciaNL/basicdeploy-mcp
- Stars
- 0
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- 1.0.7
- Last commit
- Sep 3, 2026
- License
- MIT
What is BasicDeploy MCP?
BasicDeploy lets AI agents deploy and manage containers with integrated PostgreSQL, S3 storage, and Kafka brokers via a single MCP call. It exposes 12 tools, such as list_containers, create_container, set_always_on.
Summary generated from the project's README
About BasicDeploy MCP server
Deploying and managing full-stack container environments is what developers do using basicdeploy-mcp. This server allows AI coding agents like Claude Code or Cursor to provision persistent runtimes that include a PostgreSQL database, S3-compatible object storage, and a Kafka broker through a single command. It handles the automatic setup of environment variables and public HTTPS URLs, making it easy for an agent to move from code to a live application.
Users connect to the service by providing a BasicDeploy API key and a base URL via environment variables in their MCP client configuration. The server supports various deployment methods, including unpacking tarballs or zip files into a workspace where it auto-detects runtimes like Node, Python, or Go. Once running, agents can interact with the infrastructure using tools to execute shell commands, read logs, manage Kafka topics, or adjust memory settings between 256MB and 2048MB.
Beyond simple deployment, the server provides management capabilities such as sleeping containers to save memory, waking them for traffic, or sharing specific containers with other users via email. It also offers visibility into account limits and plan details, ensuring the agent knows the available storage and container quotas.
What you can do with it
- 1Provision a full-stack environmentAn agent can create a container with integrated database and storage services in one step.
- 2Deploy application code from diskA developer can instruct an AI to take a local archive and host it on a public URL.
- 3Debug running applicationsAn AI agent can inspect the output of a running container to troubleshoot errors.
- 4Manage message streaming infrastructureDevelopers can use an agent to organize data streams by creating or clearing Kafka topics.
Written from the project's README. Every use case is checked against a quote from it.
How to install BasicDeploy MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BasicDeploy MCP in Claude Code
$ claude mcp add --env 'BASICDEPLOY_API_KEY=<YOUR_BASICDEPLOY_API_KEY>' basicdeploy-mcp -- npx -y basicdeploy-mcpInstall BasicDeploy MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"basicdeploy-mcp": {
"command": "npx",
"args": [
"-y",
"basicdeploy-mcp"
],
"env": {
"BASICDEPLOY_API_KEY": "<YOUR_BASICDEPLOY_API_KEY>"
}
}
}
}Install BasicDeploy MCP in VS Code
.vscode/mcp.json
{
"servers": {
"basicdeploy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"basicdeploy-mcp"
],
"env": {
"BASICDEPLOY_API_KEY": "<YOUR_BASICDEPLOY_API_KEY>"
}
}
}
}Install BasicDeploy MCP in VS Code CLI
$ code --add-mcp '{"name":"basicdeploy-mcp","type":"stdio","command":"npx","args":["-y","basicdeploy-mcp"],"env":{"BASICDEPLOY_API_KEY":"<YOUR_BASICDEPLOY_API_KEY>"}}'Install BasicDeploy MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"basicdeploy-mcp": {
"command": "npx",
"args": [
"-y",
"basicdeploy-mcp"
],
"env": {
"BASICDEPLOY_API_KEY": "<YOUR_BASICDEPLOY_API_KEY>"
}
}
}
}Install BasicDeploy MCP in Codex
$ codex mcp add basicdeploy-mcp --env 'BASICDEPLOY_API_KEY=<YOUR_BASICDEPLOY_API_KEY>' -- npx -y basicdeploy-mcpInstall BasicDeploy MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.basicdeploy-mcp] command = "npx" args = ["-y", "basicdeploy-mcp"] [mcp_servers.basicdeploy-mcp.env] BASICDEPLOY_API_KEY = "<YOUR_BASICDEPLOY_API_KEY>"
Install BasicDeploy MCP in Gemini CLI
$ gemini mcp add -s user -e 'BASICDEPLOY_API_KEY=<YOUR_BASICDEPLOY_API_KEY>' basicdeploy-mcp npx -- -y basicdeploy-mcpInstall BasicDeploy MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"basicdeploy-mcp": {
"command": "npx",
"args": [
"-y",
"basicdeploy-mcp"
],
"env": {
"BASICDEPLOY_API_KEY": "<YOUR_BASICDEPLOY_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for basicdeploy-mcp 1.0.7 in an isolated container with no network and no keys. It answered and listed 12 tools.
BasicDeploy MCP tools 12
Read from the server with tools/listlist_containersList all BasicDeploy containers owned by (or shared with) the authenticated user. Returns each container's id, subdomain, public URL, status, and creation time.
create_containerCreate a new empty BasicDeploy container. A PostgreSQL database and an S3 bucket are provisioned automatically for it. Returns the container's id, subdomain, and public URL. Use deploy_app or exec_command afterwards to put an application in it. Optional memoryMb (256/512/1024/2048) and alwaysOn require the plan/add-ons to allow them (see get_account); larger sizes need Pro/Scale, and always-on on Free consumes a paid add-on slot.
set_always_onTurn a container's always-on (24/7, never sleeps) flag on or off. On Free this consumes a paid always-on add-on slot (fails if none is free); on Pro/Scale every container is always-on already. Returns the updated container.
wake_containerWake a slept container so it serves traffic again (start it). A no-op if it is already running. Note: any web request to the container's public URL also wakes it automatically. Returns the updated container.
sleep_containerSleep a running container: stop it to free memory while keeping its volume, database, and public URL, so it wakes again on the next request. Returns the updated container.
get_accountShow the account's plan and capabilities: plan tier, container limit (plan base + add-ons), the memory sizes you may select, storage limit, how many always-on add-ons you hold, and whether containers auto-sleep. Use this to see what you're allowed to set.
get_containerGet full details of one container: id, subdomain, public URL, status, ports, database name and username, S3 bucket, volume path, and timestamps.
exec_commandRun a shell command inside a container (like docker exec). Returns the combined stdout/stderr output and the exit code. Useful for inspecting files, installing packages, or restarting processes inside the container.
get_logsFetch recent logs from a container. Use this to debug crashes or check application output.
deploy_appDeploy an application from a local tarball (.tar, .tar.gz, .tgz, or .zip) to BasicDeploy. The runtime (Node.js, Python, or Go) is auto-detected from the archive contents. If containerId is omitted, a new container (with DB + S3) is created for the app; if provided, the archive is deployed into that existing container. Returns the resulting container and its public URL.
share_containerShare a container with another BasicDeploy user by email, giving them access to it. The recipient is emailed a link that signs them in and opens the container. Optionally pass expiresInHours to make the share expire after that many hours (omit for a share that never expires).
delete_containerPERMANENTLY delete a container. This destroys the container, its database, and all its files (S3 bucket contents included) and cannot be undone. Only call this when the user has clearly asked for the container to be removed.
Configuration
BASICDEPLOY_API_KEYRequiredSecretYour BasicDeploy API key (bd_...). Create one at https://basicdeploy.com/api-keys — required to call any tool (the server still starts without it so clients can introspect the tool list).
BASICDEPLOY_URLBasicDeploy API base URL.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableakacianl/basicdeploy-mcp is public and reachablegithub.com/akacianl/basicdeploy-mcp ↗Pass
- Package names this repository as its sourcebasicdeploy-mcp names akacianl/basicdeploy-mcp as sourcenpmjs.com/package/basicdeploy-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-03github.com/akacianl/basicdeploy-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from basicdeploy-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBasicDeploy MCP Server
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:
{
"mcpServers": {
"basicdeploy": {
"command": "npx",
"args": ["-y", "basicdeploy-mcp@latest"],
"env": {
"BASICDEPLOY_API_KEY": "bd_your_api_key",
"BASICDEPLOY_URL": "https://basicdeploy.com"
}
}
}
}
Claude Code:
claude mcp add basicdeploy \
--env BASICDEPLOY_API_KEY=bd_your_api_key \
--env BASICDEPLOY_URL=https://basicdeploy.com \
-- npx -y basicdeploy-mcp@latest
Claude Code plugin (this repo doubles as a plugin marketplace):
/plugin marketplace add AkaciaNL/basicdeploy-mcp
/plugin install basicdeploy-mcp@basicdeploy
Then set BASICDEPLOY_API_KEY in your environment (the plugin reads it via ${BASICDEPLOY_API_KEY}).
OpenAI Codex CLI:
codex mcp add basicdeploy \
--env BASICDEPLOY_API_KEY=bd_your_api_key \
--env BASICDEPLOY_URL=https://basicdeploy.com \
-- npx -y basicdeploy-mcp@latest
or add it directly to ~/.codex/config.toml:
[mcp_servers.basicdeploy]
command = "npx"
args = ["-y", "basicdeploy-mcp@latest"]
env = { BASICDEPLOY_API_KEY = "bd_your_api_key", BASICDEPLOY_URL = "https://basicdeploy.com" }
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. |
delete_container |
containerId |
Permanent: destroys the container, its database, and all files. |
whoami |
(none) | The account this connection is authenticated as (email + id). |
get_kafka |
(none) | Kafka connection details (SASL/SCRAM): internal + external bootstrap, username/password, consumer‑group prefix, topics, usage and limits. Provisions on first call. |
create_topic |
label? |
Create a Kafka topic (auto‑namespaced under your prefix; optional readable label). Fails if the topic/storage budget is exceeded. |
purge_topic |
name |
Empty a topic you own (deletes its messages, keeps the topic). Restart processing after a mistake. |
delete_topic |
name |
Permanent: delete a topic you own and all its messages. |
Runtime
Deployed apps must listen on 0.0.0.0:8080, the port the public URL serves. DATABASE_URL, S3_ENDPOINT / S3_ACCESS_KEY / S3_SECRET_KEY / S3_BUCKET, and KAFKA_BOOTSTRAP / KAFKA_USERNAME / KAFKA_PASSWORD / KAFKA_GROUP_PREFIX are preset in the container environment. Startup output goes to /workspace/deploy.log.
Example prompts
- "Create a 1GB always‑on container and deploy
./dist/app.tar.gzto it, give me the URL." - "Show the last 100 log lines of my
blue-foxcontainer." - "What plan am I on and how many containers can I run?"
- "Share my container with teammate@example.com for 24 hours."
License
MIT. BasicDeploy is a product of Akacia (KVK 99629569, Netherlands).
BasicDeploy MCP questions
How do I add BasicDeploy MCP to Claude Code?
Run claude mcp add --env 'BASICDEPLOY_API_KEY=<YOUR_BASICDEPLOY_API_KEY>' basicdeploy-mcp -- npx -y basicdeploy-mcp in your terminal. Add --scope user to make it available in every project.
How do I add BasicDeploy MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does BasicDeploy MCP provide?
It exposes 12 tools, including list_containers, create_container, set_always_on, wake_container, sleep_container.
What services are included in a BasicDeploy container?
Every container automatically includes a PostgreSQL database, S3-compatible object storage, a Kafka broker, and a public HTTPS URL.
How do I deploy an application to a container?
You can deploy a .tar, .tar.gz, .tgz, or .zip file from your disk using the deploy_app tool, which auto-detects the runtime and starts the app on port 8080.
What environment variables are provided to my deployed app?
The runtime presets variables for your database URL, S3 credentials, S3 bucket, and Kafka connection details.
Can I share my container with others?
Yes, you can share a container with another user via email, and you can optionally set an expiration time for the share.