# htmldrop

Publishes HTML, Markdown, PDFs, and images as shareable links with expiry and optional passwords. Useful for reports, demos, and agent-created files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: vin-spiegel
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vin-spiegel/htmldrop
- Updated: 2026-07-27
- HTML: https://affpapa.org/en/nevibecode/mcp/htmldrop

## What it does

htmldrop turns HTML, Markdown, PDF, and image files into links that others can open. Markdown, text, and JSON become reader pages, while PDFs and images are delivered in their original form. Each published item receives its own subdomain, an expiry time, and a preview card.

The hosted MCP endpoint is `https://htmldrop.link/mcp`. Its `publish_html` tool accepts HTML, Markdown, or a remote URL, with optional title, TTL, password, and owner key fields. The same service also exposes REST publishing endpoints.

A self-hosted deployment needs `BASE_DOMAIN` and wildcard DNS for artifact subdomains. Storage can use the local filesystem or an S3-compatible service; ephemeral hosts need persistent storage or published files disappear after redeployment.

## Requirements
- Remote server: `https://htmldrop.link/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http htmldrop https://htmldrop.link/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add htmldrop --url https://htmldrop.link/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "htmldrop": {
            "url": "https://htmldrop.link/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "htmldrop": {
            "type": "http",
            "url": "https://htmldrop.link/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http htmldrop https://htmldrop.link/mcp
```

## When to use it
- publish an HTML report as a link
- turn Markdown into a reader page
- share a PDF or image without building a site
- add password protection to a published artifact
- set an expiry period for shared content

## Example prompts
- Publish this HTML report with htmldrop and return the link.
- Turn `report.md` into a reader page with the title “Results”.
- Publish this PDF with a password and the requested expiry.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md