Basicdeploy Mcp

io.github.AkaciaNLPublished by GitHub account AkaciaNLv1.0.7Updated Oct 24, 2026

The runtime your agent deploys to — DB, storage, and a public URL in one MCP call.

VerifiedSTDIODesktop onlyDatabasesCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

Lets an AI coding agent create and manage BasicDeploy containers with a PostgreSQL database, S3 storage, Kafka and a public HTTPS URL.

What you can do
  • List, inspect, create, wake, sleep, share and permanently delete containers
  • Deploy a local tar or zip archive, auto-detect the runtime and start the app on port 8080
  • Run shell commands inside a container and fetch recent logs
  • Manage Kafka topics: view connection details, create, purge and delete topics
  • Check the authenticated account, plan limits and memory sizes
When to use it
Useful when you want an agent to stand up a hosted app with its own database, object storage and public URL without leaving the chat, or to operate and debug existing BasicDeploy containers and Kafka topics.
Requirements
Runs locally via npx, requiring Node.js 18 or newer. Needs a BasicDeploy account and an API key in BASICDEPLOY_API_KEY; BASICDEPLOY_URL optionally overrides the API base URL (defaults to the BasicDeploy site). Network access to the BasicDeploy API.
Before you install
The API key is a secret that authorizes every tool call, including destructive ones. delete_container and delete_topic are permanent and destroy data, files and messages; purge_topic deletes messages; exec_command runs arbitrary shell commands in the container. Larger memory sizes and always-on may require a paid plan or add-on, and sharing a container emails a sign-in link to another user.

Installation

In SourceWeft

  1. Open Basicdeploy Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[BasicDeploy]

BasicDeploy 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.

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:

json
{  "mcpServers": {    "basicdeploy": {      "command": "npx",      "args": ["-y", "basicdeploy-mcp@latest"],      "env": {        "BASICDEPLOY_API_KEY": "bd_your_api_key",        "BASICDEPLOY_URL": "https://basicdeploy.com"      }    }  }}

Claude Code:

bash
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):

bash
/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:

bash
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:

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

VariableRequiredDescription
BASICDEPLOY_API_KEYYesYour API key (bd_…). Required to call any tool (the server still starts and lists its tools without it, so clients can introspect it).
BASICDEPLOY_URLNoAPI base URL. Defaults to https://basicdeploy.com.

Tools

ToolArgumentsDescription
list_containers(none)List your containers: subdomain, status, URL, id, createdAt.
create_containermemoryMb? (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_containercontainerIdFull details: URL, status, ports, DB name/user, S3 bucket, volume path.
deploy_apptarballPath, 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_commandcontainerId, commandRun a shell command inside the container; returns output + exit code.
get_logscontainerId, tail? (default 200)Fetch recent container logs.
set_always_oncontainerId, enabledTurn a container's 24/7 always‑on flag on/off.
wake_containercontainerIdWake a slept container so it serves traffic again.
sleep_containercontainerIdSleep 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_containercontainerId, email, expiresInHours?Share a container with another user by email (they get a sign‑in link). Omit expiresInHours for an unlimited share.
delete_containercontainerIdPermanent: 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_topiclabel?Create a Kafka topic (auto‑namespaced under your prefix; optional readable label). Fails if the topic/storage budget is exceeded.
purge_topicnameEmpty a topic you own (deletes its messages, keeps the topic). Restart processing after a mistake.
delete_topicnamePermanent: 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.gz to it, give me the URL."
  • "Show the last 100 log lines of my blue-fox container."
  • "What plan am I on and how many containers can I run?"
  • "Share my container with [email protected] for 24 hours."

License

MIT. BasicDeploy is a product of Akacia (KVK 99629569, Netherlands).

Source: README.md at commit c6654bd

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts