What it does
The server lets an AI coding agent create BasicDeploy containers and manage them through MCP tools. Each container is provisioned with a PostgreSQL database, S3-compatible object storage, a Kafka broker, environment variables and a public HTTPS URL. The agent can deploy a .tar, .tgz or .zip archive (Node, Python, Go or Docker, auto-detected), run shell commands, read logs, manage Kafka topics, check the authenticated account, switch the always-on flag, sleep or wake containers, and share or delete them.
It suits an agent that needs an app, its database, storage and Kafka topics on a public URL without manual setup. It can also check the account's plan, container limit and storage limit, or share a container with another user by email for a set number of hours.
The server runs through npx with no separate install. It works with Claude Code, Cursor, OpenAI Codex CLI and other MCP clients. A BasicDeploy API key must be set as BASICDEPLOY_API_KEY, and BASICDEPLOY_URL can override the default API address. Deployed apps must listen on 0.0.0.0:8080, and the database, S3 and Kafka connection variables are preset in the container environment. Startup output is written to /workspace/deploy.log. The project is released under the MIT license.
Limitations and requirements
Requires Node.js 18 or newer and a BasicDeploy API key; tools cannot be called without the key. Larger container sizes need the Pro or Scale plan, and always-on on the Free plan uses a paid add-on slot. create_topic fails if the topic or storage budget is exceeded. delete_container and delete_topic are permanent: deleting a container also destroys its database and all files, and deleting a topic removes all its messages. Deployed apps must listen on 0.0.0.0:8080.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.AkaciaNL/basicdeploy-mcp
The runtime your agent deploys to — DB, storage, and a public URL in one MCP call.
v1.0.7As shown on registry.modelcontextprotocol.io when we last read it