# io.github.AkaciaNL/basicdeploy-mcp (npm · basicdeploy-mcp)

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

- Trust score: 66/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `basicdeploy-mcp`: 66/100 (this document), [markdown](https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp.md), [page](https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp)

## Channel facts

- Registry: `npm`
- Package: `basicdeploy-mcp`
- Version: `1.0.6`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Known CVEs were checked across the 94 of 98 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Dependency health was assessed across the 94 of 98 dependencies we could resolve, so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 80/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 900 tokens (~90/item across 10 items; 10 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add akacianl-basicdeploy-mcp -- npx -y basicdeploy-mcp
```

### Codex

```bash
codex mcp add akacianl-basicdeploy-mcp -- npx -y basicdeploy-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "akacianl-basicdeploy-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "basicdeploy-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add akacianl-basicdeploy-mcp --command npx --arg -y --arg basicdeploy-mcp
```

### Hermes

```yaml
mcp_servers:
  akacianl-basicdeploy-mcp:
    command: "npx"
    args: ["-y", "basicdeploy-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "akacianl-basicdeploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "basicdeploy-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-07 (score 66, +31)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 100

### 2026-08-06 (score 35)

First indexed and scored.

## MCP tools (10)

### `list_containers` (~43 tokens)

List all BasicDeploy containers owned by (or shared with) the authenticated user. Returns each container's id, subdomain, public URL, status, and creation time.

### `create_container` (~175 tokens)

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

Input parameters:

- `alwaysOn` (boolean): Keep the container running 24/7 (never auto-sleep). On Free this uses a paid add-on slot.
- `memoryMb` (number): Memory for the container in MB: 256, 512, 1024, or 2048. Defaults to the plan's default.

### `set_always_on` (~91 tokens)

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

Input parameters:

- `containerId` (string, required): The container's UUID.
- `enabled` (boolean, required): true to enable always-on, false to disable.

### `get_account` (~64 tokens)

Show 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_container` (~54 tokens)

Get full details of one container: id, subdomain, public URL, status, ports, database name and username, S3 bucket, volume path, and timestamps.

Input parameters:

- `containerId` (string, required): UUID of the container

### `exec_command` (~73 tokens)

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

Input parameters:

- `command` (string, required): Shell command to execute inside the container
- `containerId` (string, required): UUID of the container

### `get_logs` (~57 tokens)

Fetch recent logs from a container. Use this to debug crashes or check application output.

Input parameters:

- `containerId` (string, required): UUID of the container
- `tail` (integer): Number of log lines to return from the end (default 200)

### `deploy_app` (~154 tokens)

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

Input parameters:

- `containerId` (string): Optional UUID of an existing container to deploy into. Omit to create a new one.
- `tarballPath` (string, required): Absolute path on local disk to the app archive (.tar, .tar.gz, .tgz, .zip)

### `share_container` (~119 tokens)

Share 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).

Input parameters:

- `containerId` (string, required): UUID of the container
- `email` (string, required): Email address of the user to share with
- `expiresInHours` (integer): Optional. Hours until the share expires. Omit for an unlimited (never-expiring) share.

### `delete_container` (~70 tokens)

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

Input parameters:

- `containerId` (string, required): UUID of the container to delete

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp#diagnostics

## Score history

- 2026-08-07: 66
- 2026-08-06: 35

## Links

- npm package: https://www.npmjs.com/package/basicdeploy-mcp
- Socket report: https://socket.dev/npm/package/basicdeploy-mcp
- Repository: https://github.com/AkaciaNL/basicdeploy-mcp
- Changelog RSS feed: https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp.json
- HTML version of this page: https://verifymcp.io/servers/akacianl-basicdeploy-mcp/basicdeploy-mcp