# Drop2Run

Lets an agent publish what it just wrote — a page, a markdown or PDF file — and hand back a working URL.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3
- Author: Drop-to-run
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Drop-to-run/drop2run-cli
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/drop2run

## What it does

Drop2Run is an MCP server that takes text files from your agent and puts them online. Twenty tools sit in five groups: publishing (`publish_files`, `publish_dir`), site management, sharing, comments, and sign-in. `publish_dir` reads a folder from disk, so it only exists in the local build.

Two ways to connect. Run it locally with `npx -y @drop2run/mcp` and sign in through the `login` and `login_code` tools. Or point your client at `https://mcp.dropto.run/mcp`, where the hosted copy asks you to authenticate as it connects. Either sign-in lands in the same token store the CLI uses, so one covers both.

Destructive calls are guarded: `delete_site` and `change_subdomain` make you type the site's current subdomain back before they run. To take a site offline without losing it, `pause_site` reverses. Only text files get published. The Drop2Run service behind the API is closed source; what you can read is the code running on your machine, with your token and your privileges.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.dropto.run/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http drop2run https://mcp.dropto.run/mcp
```

2. **Platform CLI**
```bash
claude mcp add drop2run -- npx -y @drop2run/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add drop2run --url https://mcp.dropto.run/mcp
```

2. **Platform CLI**
```bash
codex mcp add drop2run -- npx -y @drop2run/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "drop2run": {
            "url": "https://mcp.dropto.run/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "drop2run": {
            "command": "npx",
            "args": [
                "-y",
                "@drop2run/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "drop2run": {
            "type": "http",
            "url": "https://mcp.dropto.run/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "drop2run": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@drop2run/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http drop2run https://mcp.dropto.run/mcp
```

2. **Platform CLI**
```bash
gemini mcp add drop2run npx -y @drop2run/mcp
```

## When to use it
- send a client a link to a finished page instead of a zip
- put a markdown doc online the moment the agent finishes it
- publish a built site from the `dist` folder
- roll a site back to an earlier version
- invite someone to review a site and work through comments

## Example prompts
- Publish the `dist` folder and give me the link
- Put `report.md` online as its own site
- List my sites and pause the last one

## Similar
- [printing-press-publish](https://affpapa.org/en/nevibecode/skills/printing-press-publish.md) — skill · 6900 installs
- [base44-cli](https://affpapa.org/en/nevibecode/skills/base44-cli.md) — skill · 10900 installs
- [langgraph-cli](https://affpapa.org/en/nevibecode/skills/langgraph-cli.md) — skill · 9000 installs
- [platform-deploy-validate](https://affpapa.org/en/nevibecode/skills/platform-deploy-validate.md) — skill · 3000 installs
- [github-release-management](https://affpapa.org/en/nevibecode/skills/github-release-management.md) — skill · 1200 installs
- [use-railway](https://affpapa.org/en/nevibecode/skills/use-railway.md) — skill · 951 installs

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