> ## Documentation Index
> Fetch the complete documentation index at: https://docs.htmldrop.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> From a file on your machine to a live URL, three ways: the browser, an AI agent, or the API.

## The fastest way: drop it

Go to [htmldrop.app](https://htmldrop.app) and drag an `.html` or `.md` file onto
the drop area. You get a live URL immediately — no account, no email.

Anonymous drops are capped at **2 MB** and stay live for **7 days**. Sign up
free at any point and the drops made in that browser are claimed into your
account automatically.

## From an AI agent

If your assistant speaks [MCP](/agents/overview), it can publish on your behalf.
Connect once:

```bash theme={null}
claude mcp add --transport http htmldrop https://htmldrop.app/mcp
```

Then just ask:

> Publish this page with htmldrop

The agent calls `htmldrop_publish` and replies with the live URL. Setup guides:
[ChatGPT](/agents/chatgpt) · [Claude](/agents/claude) ·
[Claude Code](/agents/claude-code) · [Codex](/agents/codex) ·
[Cursor and Cline](/agents/cursor-and-cline).

## From the command line

```bash theme={null}
npx @htmldrop.app/cli login    # browser sign-in, once
npx @htmldrop.app/cli deploy   # publishes the current directory
```

<Warning>
  The npm packages are **scoped**: `@htmldrop.app/cli` and `@htmldrop.app/mcp`.
  The unscoped `htmldrop` package on npm is an unrelated third-party project — do
  not install it.
</Warning>

## From the API

```bash theme={null}
curl -F "file=@page.html" https://htmldrop.app/api/v1/drops
```

That endpoint is the anonymous one — it needs no credentials and returns a share
URL. For anything tied to your account, see [authentication](/api/authentication).