# tmphost

> tmphost is a free MCP server for files and documents. Publish files to temporary public URLs that delete themselves when they expire. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://tmphost.io
- **Repository:** https://github.com/tmphost/tmphost
- **MCP Registry name:** io.github.tmphost/tmphost
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

tmphost puts static files in folders with a time to live, 30 minutes by default and up to a configurable maximum, then deletes the folder. The README describes a credit system: new accounts get 1,000 operations and 250 more every 30 days, and each file costs one credit per started megabyte for each started 30 minutes of the folder's remaining life.

Folders can be extended, updated in place so the URL stays the same, and protected with a six-digit PIN, either static or from an authenticator app. Folder IDs are eight random characters so links cannot be guessed. Without signing in, the web uploader makes folders that last at most 10 minutes by default.

The backend is Go (Fiber and GORM) with a Vue front end, storing bytes on local disk or S3, and it also ships a CLI and a documented OpenAPI spec.

## Features

- **Expiring folders:** Files vanish automatically when the folder's TTL ends.
- **Credit metering:** Cost scales with file size and time kept.
- **PIN protection:** Folders can ask visitors for a six-digit PIN.
- **In-place updates:** Re-uploading a path keeps the same URL and expiry.
- **CLI and API:** Also available through a command-line tool and OpenAPI.

## Good for

- Share an HTML report from an agent for a few hours
- Preview a prototype site on a throwaway URL
- Hand over a PDF that should not stay online
- Protect a temporary link with a PIN

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tmphost https://mcp.tmphost.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tmphost.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tmphost": {
      "url": "https://mcp.tmphost.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tmphost": {
      "type": "http",
      "url": "https://mcp.tmphost.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tmphost": {
      "serverUrl": "https://mcp.tmphost.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tmphost": {
      "type": "http",
      "url": "https://mcp.tmphost.io/mcp"
    }
  }
}
```

## Tools

- `uploadFile`: Uploads a file into a new or existing folder, optionally with a PIN.
- `extendFolder`: Extends a folder's expiry.
- `addPinToFolder`: Adds a PIN to a folder.

## FAQ

### How long do files last?

30 minutes by default, extendable up to the configured maximum.

### How do I sign in?

With Google or GitHub OAuth.

### How many operations do I get?

1,000 at sign-up and 250 every 30 days, without carry-over.

### Can strangers guess my link?

Folder IDs are eight random base36 characters, so URLs are not guessable.

### Is tmphost free?

Yes. tmphost is free to use.

### How do I add tmphost to Claude Code?

Run this command in your terminal: claude mcp add --transport http tmphost https://mcp.tmphost.io/mcp

### What are the best alternatives to tmphost?

The closest alternatives to tmphost are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/tmphost
