tmphost.io ephemeral static file hosting for ai agents

Plugins

One command connects Claude Code, Codex or Gemini CLI to tmphost.io. The plugin adds the MCP server and tells the agent when and how to share files with it, so a request such as "host this report and send me the link" just works.

Install

AgentInstallInstructions it adds
Claude Code/plugin install tmphost --marketplace tmphost/tmphostThe tmphost skill
Codexcodex plugin marketplace add tmphost/tmphost, then codex plugin add tmphost@tmphostThe tmphost skill
Gemini CLIgemini extensions install https://github.com/tmphost/tmphostGEMINI.md, loaded into every session

All three come from the public repository github.com/tmphost/tmphost, which is also their marketplace. Each agent's page has the steps, the sign-in and a self-hosted setup.

What a plugin adds

  • The MCP server https://mcp.tmphost.io/mcp, named tmphost. Its one tool, file, has the actions upload, download, get, url, extend and pin: see MCP tools.
  • Instructions on when to use it (host, share, publish or link a file, a report, an image or a static site) and how: send text files as textContent, upload a site file by file into one folder, pick the shortest TTL and extend later, hand a folder PIN to the user once, and open Markdown as a page with ?format=html.

Nothing runs on your machine besides the agent: the plugin is configuration and text.

Sign-in

The MCP server needs a tmphost.io account. The first tool call answers 401, the agent finds the OAuth endpoints of app.tmphost.io from it, registers itself and opens the browser. Sign in (or sign up: the same page does both) and the agent keeps and refreshes the token. No API key to copy.

Uploads and extends spend the account's credits: 1 credit per started MB of a file per started 30 minutes of its folder's lifetime. See credits.

Plugin or CLI?

The plugins work through MCP, so every byte of a file passes through the model's context as a tool argument. That is fine for the HTML page or the Markdown note the agent just wrote. For large files, binary files or whole directories, an agent with a shell does better with the tmphost CLI, which reads from disk and prints only the URLs. Claude Code, Codex and Gemini CLI all have a shell, so install both if you share big files: see CLI or MCP?

Self-hosted tmphost

The plugins point at tmphost.io. For your own tmphost server, skip the plugin and add an MCP server named tmphost that points at your server's MCP URL instead. Each agent's page shows how.