Skip to main content
Glama
AkaciaNL

BasicDeploy MCP Server

BasicDeploy MCP Server

The persistent runtime your agent deploys to — a database, object storage, 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, 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, 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:

{
  "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.

Related MCP server: Coolify MCP Server

Tools

Tool

Arguments

Description

list_containers

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

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.

Runtime

Deployed apps must listen on 0.0.0.0:8080 — that's the port the public URL serves. DATABASE_URL and S3_ENDPOINT / S3_ACCESS_KEY / S3_SECRET_KEY / S3_BUCKET 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 teammate@example.com for 24 hours."

License

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Dokploy deployments, including creating and deploying applications, managing databases, configuring domains with SSL, and monitoring application status through a standardized interface.
    29
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to deploy and manage applications on Coolify through structured tools, supporting project management, app lifecycle control, pre-configured templates, and deployment monitoring with built-in safety guardrails.
    169
    3
    MIT
  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to manage cloud infrastructure through natural language by providing a unified interface to the Dokploy platform. Supports Docker containers, applications, databases, domains, monitoring, and deployment operations through conversational commands.
    29
    1
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AkaciaNL/basicdeploy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server