# NudgeHost

A remote MCP server that publishes text and files and hands back a public link. Useful when an agent has to send its output somewhere.

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

## What it does

NudgeHost is a file-hosting service with a remote MCP server. It lives at `https://www.nudgehost.com/api/mcp`, so there is nothing to install locally — your client just points at that URL. Four tools come with it. `share_text` turns text into a file and returns the link in one call, and the filename extension decides how the page looks: `.html` renders as a web page, `.csv` and `.json` open in a viewer, `.md` appears as formatted text with the source and a copy button. `create_upload_url` returns an address to push bytes to, valid for 300 seconds, `complete_upload` closes the upload out, and `list_links` walks the account's links with the newest first.

Because the tools act on an account, every request carries an API key. Sign up for a free account, create a key in the dashboard panel — it is shown once — and put it in the `NUDGEHOST_API_KEY` environment variable, then restart the client. The free plan is enough, and it holds 2 keys at a time.

Keep www in the URL. The apex `nudgehost.com` redirects to www, and the `Authorization` header is dropped on that hop, so a valid key comes back 401. The key shares one request budget with the REST API: 20 requests per 60 seconds on Free, 60 on Pro, 150 on Studio. Text passed to `share_text` is capped at 2MB in UTF-8.

## Requirements
- Remote server: `https://www.nudgehost.com/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http nudgehost https://www.nudgehost.com/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add nudgehost --url https://www.nudgehost.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nudgehost": {
            "url": "https://www.nudgehost.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nudgehost": {
            "type": "http",
            "url": "https://www.nudgehost.com/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http nudgehost https://www.nudgehost.com/api/mcp
```

## When to use it
- hand a colleague one link to an agent's output
- publish a text report as a page in the browser
- upload a file the server does not hold and get an address for the bytes
- turn a ZIP with an index file into a hosted site
- browse the account's links and page through them

## Example prompts
- Publish this report as a markdown file and give me the link
- Upload `build.zip` and tell me where it lives now
- Show the last 10 links on my account

## Similar
- [configuring-connections](https://affpapa.org/en/nevibecode/skills/configuring-connections.md) — skill · 2900 installs
- [building-tools](https://affpapa.org/en/nevibecode/skills/building-tools.md) — skill · 2900 installs
- [loops-cli](https://affpapa.org/en/nevibecode/skills/loops-cli.md) — skill · 1500 installs
- [12306](https://affpapa.org/en/nevibecode/skills/12306.md) — skill · 636 installs
- [daily-news-60s](https://affpapa.org/en/nevibecode/skills/daily-news-60s.md) — skill · 493 installs
- [whatsapp](https://affpapa.org/en/nevibecode/skills/whatsapp.md) — skill · 368 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