Skip to content

hashgraph-online/awesome-codex-plugins / plugins/bosmdavid-gif/dropthehassle-skill/skills/dropthehassle-publish

dropthehassle-publish

Verified

Publishes (deploys) a built website or web app to a free HTTPS link, then your own .com with no DNS. Use when the user wants to deploy a website, publish a website or host a website, or says "go live", "make it live", "put this live", "put it online", "publish my site", "deploy my website", "host my website", "share it with friends", "send my friends a link", "get a link", "make it public", "it only works on localhost" or "get a .com", or asks to deploy or host a site built with an AI tool (Claude Code, Cursor, Codex, Windsurf, Lovable, Bolt, v0, ChatGPT), or mentions DropTheHassle, and has not picked another host. Covers building first, CLI or MCP setup, deploying, Update and Restore, the claim link, the live check, linking a server part the user hosts on AWS, Google Cloud, DigitalOcean or their own server with set_backend, and domain search. The agent never spends money. The human pays.

FileKindSize
SKILL.mdskill md18.6 KB
references/domains.mdmarkdown3.7 KB
references/setup.mdmarkdown5.7 KB
references/troubleshooting.mdmarkdown7.7 KB
scripts/preflight.mjsexecutablescript10.3 KB

references/setup.md

View on GitHub
# Setting up DropTheHassle in your agent

Three ways in. None needs an account for the first deploy.

| | CLI | Local MCP server | Hosted MCP connector |
| --- | --- | --- | --- |
| Run | `npx -y dropthehassle@latest deploy [folder] --email <the user's email>` | `npx -y dropthehassle-mcp` (stdio) | `https://dropthehassle.com/mcp` (Streamable HTTP) |
| Reads the folder from disk | yes | yes (`folder`, absolute path) | no: files are sent inline |
| No-token tools | deploy | `deploy_site` (npm 0.4.2). Source 0.4.3 adds `search_domain` and `whoami` | `deploy_site`, `search_domain`, `whoami` |
| Needs | Node.js 18+, network to dropthehassle.com | Node.js 18+, network to dropthehassle.com | an MCP client that supports remote servers |

Versions checked on 2026-10-01: npm `dropthehassle` 0.3.0, npm `dropthehassle-mcp` 0.4.2. The
hosted connector reports 0.4.2 but already takes `site` addresses and allows `search_domain`
without a token. Current versions are listed in https://dropthehassle.com/llms.txt.

## Token (only for account tools)

- The human opens https://dropthehassle.com, menu (top right), **Connect your AI**, and copies a
  token that starts with `dth_`. An account can have up to 10 live tokens.
- Local server: put it in the server's `env` as `DTH_TOKEN`. Hosted: send
  `Authorization: Bearer <token>`.
- Leave it out until the human has the real token. A placeholder is never right. Don't commit it.
  Use a gitignored local config file where the tool has one.
- The token can deploy, list sites, rearrange names and create a payment link. It cannot pay.

## Claude Code

```bash
claude mcp add dropthehassle -- npx -y dropthehassle-mcp
```

With a token, run `claude mcp add dropthehassle -e DTH_TOKEN=dth_… -- npx -y dropthehassle-mcp`.
Do this in the human's own terminal so the token doesn't end up in the chat. To share the setting
with a project, `--scope project` writes `.mcp.json`. Only commit that file without a token in it.

Or skip MCP and run the CLI from the agent's shell, in the project folder after the build:
`npx -y dropthehassle@latest deploy . --email <the user's email>`.
Ask the user for their email first, then run it.

**Claude Code on the web** (claude.ai/code) runs in a cloud machine whose default network level
(Trusted) blocks dropthehassle.com. Either add the hosted connector `https://dropthehassle.com/mcp`
as a custom connector in claude.ai and enable it for the session, or edit the environment: set
network access to Custom, add `dropthehassle.com` and tick the default package-manager list. The
cloud machine is temporary, so `.dropthehassle.json` does not survive the session.
Guide: https://dropthehassle.com/guides/claude-code-on-the-web-deploy-custom-domain

## Cursor

`.cursor/mcp.json` in the project, or `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "dropthehassle": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dropthehassle-mcp"]
    }
  }
}
```

Add `"env": { "DTH_TOKEN": "dth_…" }` only with a real token, and keep a file with a token out of
git. One-click install link (no token):
`cursor://anysphere.cursor-deeplink/mcp/install?name=dropthehassle&config=eyJkcm9wdGhlaGFzc2xlIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiZHJvcHRoZWhhc3NsZS1tY3AiXX19`

## Codex

```bash
codex mcp add dropthehassle --url https://dropthehassle.com/mcp
```

or in `~/.codex/config.toml`:

```toml
[mcp_servers.dropthehassle]
url = "https://dropthehassle.com/mcp"
```

Codex keeps network access off in its sandbox by default. To use the CLI instead, approve the one
`npx -y dropthehassle@latest deploy . --email <the user's email>` command when Codex asks for network access. Setting
`[sandbox_workspace_write] network_access = true` opens the network for every command.
**Codex cloud**: turn on internet access for the environment and allow `dropthehassle.com` (plus
package managers so npm works). On the legacy setup, a GET-only method filter blocks the upload.
Codex's docs don't list MCP for cloud tasks, so use the CLI there.
Guide: https://dropthehassle.com/guides/codex-deploy-custom-domain

## Windsurf

New Windsurf tabs use the Devin Local agent. Put the server in the gitignored local file
`.devin/mcp_config.local.json`, or run `devin mcp add dropthehassle -- npx -y dropthehassle-mcp`:

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

Cascade (the older agent) opens its own MCP config from the Cascade panel, with the same
`mcpServers` shape. Guide: https://dropthehassle.com/guides/windsurf-deploy-custom-domain

## Any other MCP client

Use the same `mcpServers` block (`npx -y dropthehassle-mcp`), or add the hosted URL
`https://dropthehassle.com/mcp` as a remote server.

## Put the spending rule in the project

Paste this into `CLAUDE.md`, `AGENTS.md` or a Cursor rule so every session follows it:

```markdown
# DropTheHassle

Never buy anything without asking me. Never buy a domain, email or subscription for me without asking first. When something costs money, give me the payment link and let me pay.

The token cannot pay.
```

## Hosted connector: sending files inline

`deploy_site` on `https://dropthehassle.com/mcp` takes
`files: [{ "path": "index.html", "content": "<!doctype html>…", "encoding": "utf8" }, …]`.

- Paths are relative to the site root, with forward slashes.
- Use `utf8` for text files and `base64` (standard alphabet) for images, fonts and other binaries.
- Leave out `node_modules`, `.git` and hidden files. `.well-known` is allowed.
- The decoded files count against the same caps: 25 MB and 1,000 files before a claim, 100 MB and
  5,000 files signed in. Big video usually doesn't fit. Use the CLI or the local server for big
  sites, because they zip the folder from disk instead of sending it through the conversation.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall