NudgeHost

com.nudgehostPublished by nudgehost.comOfficial publisherv1.0.2Updated Oct 26, 2026

File hosting for agents. Upload any file, get a public link in seconds.

VerifiedStreamable HTTPWeb executableCloud & Infrastructure Files & Storage

Server details

Identifier: com.nudgehost/file-hosting
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to nudgehost.com, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.nudgehost%2Ffile-hosting.svg)](https://sourceweft.com/mcp/com.nudgehost%2Ffile-hosting?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

NudgeHost is a remote file-hosting MCP server that lets an assistant publish text or upload files and get back public links.

What you can do: Publish text as a hosted file and get its link, with rendering chosen by filename extension (HTML page, CSV/JSON viewer, Markdown, or plain text)
Start an upload for a file the server does not hold and get a time-limited upload URL
Finish an upload after the bytes are sent, turning a ZIP containing index.html into a hosted site
List the account's links, newest first, with paging
When to use it: Useful when an assistant needs to hand a file or a snippet of text to someone outside the chat as a shareable public link, or to publish a small static site from a ZIP. It is a hosting service, not a document store for private material.
Requirements: Remote server at www.nudgehost.com; nothing to install. A NudgeHost account and an API key from the dashboard, sent as an Authorization bearer token (the README uses the NUDGEHOST_API_KEY environment variable). A free account is enough; rate limits depend on the plan.

Before you install

Everything published becomes a public link, so do not share secrets or private data. The API key grants access to the account's links and uploads; keep it in an environment variable rather than in config files. Uploads and link counts are limited by plan, and the tools create and list data on the account.

Installation

In SourceWeft

Open NudgeHost in the dashboard and add it to a workspace.
Connect the required credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.nudgehost%2Ffile-hosting/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "nudgehost": {
      "type": "http",
      "url": "https://www.nudgehost.com/api/mcp"
    }
  }
}

README

NudgeHost MCP server

NudgeHost is a file-hosting service for people and AI agents. Upload any file and get a link in seconds.

This repository describes NudgeHost's remote MCP server and holds its registry entry. The server runs at https://www.nudgehost.com/api/mcp, so there is nothing here to install or run. Full documentation is at nudgehost.com/docs/api.

Registry entry

The server is listed in the official MCP Registry as com.nudgehost/file-hosting. server.json in this repository is that entry.

You need an API key

The MCP server's tools act on a NudgeHost account, the same account you upload with on the website, so every request carries an API key. A free account is enough. Every plan can use the API, including the free one, and a free account can hold 2 keys at once.

Sign up at nudgehost.com.
Open the API keys panel of your dashboard and create a key. It is shown once, so copy it before you close the panel.
Set the environment variable NUDGEHOST_API_KEY to that key, then start or restart your client.

Send every request to www.nudgehost.com. The apex, nudgehost.com, redirects to www, and the Authorization header is dropped on that hop, so a good key comes back 401. The setups below already use www.

The four tools

Tool	What it does
`share_text`	Publishes text as a file and returns the link, in one call. A filename ending in `.html` or `.htm` produces a page the recipient reads in the browser. A `.csv` or `.json` file opens in the table or JSON viewer. A `.md` or `.markdown` file shows as formatted text, with a Source view and a Copy source button, and HTML inside it shows as typed. Any other filename shows the text as plain text, with a Copy text button. Markdown and plain text also have the raw text at the link plus `/raw`. Content is capped at 2MB, measured in UTF-8 bytes.
`create_upload_url`	Starts an upload for a file the server does not hold, and returns the URL to send the bytes to. That URL expires after 300 seconds.
`complete_upload`	Finishes an upload once the bytes have been sent. Calling it twice is safe. A ZIP with a file named `index.html` inside, in any folder, becomes a hosted site at its own address. A ZIP without an `index.html`, or over 100MB, stays a download.
`list_links`	Lists the account's links, newest first. `limit` takes a whole number from 1 to 100 and defaults to 50, and `cursor` fetches the next page.

Connecting a client

These setups are copied from Connecting a client on the docs page.

Each setup below names an environment variable, NUDGEHOST_API_KEY, rather than the key itself, so the key stays out of the config file. Set that variable to an API key from your dashboard, then start or restart the client so it reads the new value.

Claude Code. Put this in .mcp.json in the folder you start Claude Code from. Tested 13 October 2026, on its default runtime and with MCP_PROTOCOL_NEGOTIATION set to legacy.

json

{  "mcpServers": {    "nudgehost": {      "type": "http",      "url": "https://www.nudgehost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${NUDGEHOST_API_KEY}"      }    }  }}

{  "mcpServers": {    "nudgehost": {      "type": "http",      "url": "https://www.nudgehost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${NUDGEHOST_API_KEY}"      }    }  }}

Cursor. Add this entry to ~/.cursor/mcp.json, which Cursor reads for every project. Tested 13 October 2026.

json

{  "mcpServers": {    "nudgehost": {      "url": "https://www.nudgehost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${env:NUDGEHOST_API_KEY}"      }    }  }}

{  "mcpServers": {    "nudgehost": {      "url": "https://www.nudgehost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${env:NUDGEHOST_API_KEY}"      }    }  }}

Codex CLI. Add this table to ~/.codex/config.toml. It needs no feature flag. Tested 13 October 2026.

toml

[mcp_servers.nudgehost]url = "https://www.nudgehost.com/api/mcp"bearer_token_env_var = "NUDGEHOST_API_KEY"

[mcp_servers.nudgehost]url = "https://www.nudgehost.com/api/mcp"bearer_token_env_var = "NUDGEHOST_API_KEY"

The Codex CLI test covered connecting and listing links.

Cursor plugin

This repository is also a Cursor plugin. Its mcp.json points Cursor at the server above, and .cursor-plugin/plugin.json declares one required setting, NUDGEHOST_API_KEY, for an API key from the API keys panel of your NudgeHost dashboard. The plugin holds no key itself.

Example

Publishing a ZIP as a site from Cursor walks through the three steps that turn a folder into a live site.

Rate limits

Each key gets a fixed number of requests per 60 second window, set by the account's plan.

Free: 20 requests per 60 seconds
Pro: 60 requests per 60 seconds
Studio: 150 requests per 60 seconds

The MCP tools and the REST API share one budget per key. Upload size and the number of live links also depend on the plan, and the pricing page has the current figures.

Licence

The text and examples in this repository are under the MIT licence. The NudgeHost service has its own terms.

Source: README.md at commit 762dc32

Tools

This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

v1.0.2LatestOct 14, 2026
v1.0.1Oct 14, 2026
v1.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts