# hushdrop MCP server

> Allows AI agents to publish files, HTML pages, or static sites to branded, password-protected, zero-knowledge links on custom domains.

- Repository: https://github.com/maxtechera/hushdrop
- Page: https://hostedmcp.org/servers/maxtechera/hushdrop
- Transport: stdio
- Stars: 8
- License: MIT
- Latest version: 0.3.3

## Install

### Claude Code

```sh
claude mcp add --env 'BLOB_READ_WRITE_TOKEN=<YOUR_BLOB_READ_WRITE_TOKEN>' hushdrop -- npx -y hushdrop-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "hushdrop": {
      "command": "npx",
      "args": [
        "-y",
        "hushdrop-mcp"
      ],
      "env": {
        "BLOB_READ_WRITE_TOKEN": "<YOUR_BLOB_READ_WRITE_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "hushdrop": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hushdrop-mcp"
      ],
      "env": {
        "BLOB_READ_WRITE_TOKEN": "<YOUR_BLOB_READ_WRITE_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"hushdrop","type":"stdio","command":"npx","args":["-y","hushdrop-mcp"],"env":{"BLOB_READ_WRITE_TOKEN":"<YOUR_BLOB_READ_WRITE_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "hushdrop": {
      "command": "npx",
      "args": [
        "-y",
        "hushdrop-mcp"
      ],
      "env": {
        "BLOB_READ_WRITE_TOKEN": "<YOUR_BLOB_READ_WRITE_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add hushdrop --env 'BLOB_READ_WRITE_TOKEN=<YOUR_BLOB_READ_WRITE_TOKEN>' -- npx -y hushdrop-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.hushdrop]
command = "npx"
args = ["-y", "hushdrop-mcp"]

[mcp_servers.hushdrop.env]
BLOB_READ_WRITE_TOKEN = "<YOUR_BLOB_READ_WRITE_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'BLOB_READ_WRITE_TOKEN=<YOUR_BLOB_READ_WRITE_TOKEN>' hushdrop npx -- -y hushdrop-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "hushdrop": {
      "command": "npx",
      "args": [
        "-y",
        "hushdrop-mcp"
      ],
      "env": {
        "BLOB_READ_WRITE_TOKEN": "<YOUR_BLOB_READ_WRITE_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BLOB_READ_WRITE_TOKEN` | no | yes | Vercel Blob token for self-hosting on your own domain. Optional. |

## Tools (9)

- `publish_html`: Publish raw HTML as a branded, password-protected (zero-knowledge AES-256) link on your own domain. Returns the URL and (if locked) the password. Locked by default.
- `publish_file`: Publish a file from a local path. Non-HTML files get an unguessable URL; pass page=true to wrap any file in a branded download page (optionally password-protected).
- `update_site`: Replace the content of an existing drop in place — same URL/slug, new HTML. (Set a password to re-lock; zero-knowledge means content can't be re-keyed without re-supplying it.)
- `list_sites`: List the drops currently live in your store (slug, URL, size, password if known locally, upload date).
- `delete_site`: Delete a drop (and any sibling file) by slug. Burns the artifact immediately.
- `set_password`: Change the password gate on a hosted drop. Zero-knowledge means re-keying re-encrypts, so re-supply the HTML; returns the new URL + password.
- `set_expiry`: Set (or clear) the auto-expiry on a hosted drop. The host's gc cron deletes it after the deadline.
- `set_email_gate`: Restrict a hosted drop so only viewers with a given email domain can open it (e.g. 'acme.com'); pass 'off' to remove.
- `set_feedback`: Toggle the viewer feedback widget on a hosted drop (collect reactions/comments from recipients).

## FAQ

### Is it really zero-knowledge?

Yes, for locked drops, AES-256 encryption runs in your browser before the upload occurs, meaning the server only ever stores ciphertext.

### Can agents use it without MCP?

Yes, because it is a single CLI, any agent capable of running shell commands can use it to publish content.

### Does it need Vercel?

Vercel is only required if you choose to self-host the service; the managed and hosted tiers can be used with just npx.
