Claude Code plugin

The permahost plugin connects Claude Code to the permahost.io MCP server and adds a permahost skill, so Claude can publish files and static sites at permanent public URLs when you ask it to.

LLM-friendly version (Markdown): https://permahost.io/docs/plugins/claude.md

Install

In Claude Code, run:

Claude Code

> /plugin install permahost --marketplace tmphost/permahost

Or in two steps: add the marketplace, then install the plugin from it.

Claude Code

> /plugin marketplace add tmphost/permahost
> /plugin install permahost@permahost

The marketplace is the public GitHub repository tmphost/permahost; its .claude-plugin/marketplace.json lists one plugin, permahost, from plugin/claude.

What it adds

Part	What it does
MCP server `permahost`	HTTP server at `https://mcp.permahost.io/mcp` with one tool, `file`, and its actions `upload`, `download`, `get`, `url` and `list` (MCP tool).
Skill `permahost`	Loads when you want to host, share, publish or link a file, a report, an image or a static site, or fetch one back. It covers each action, `textContent` for text files, multi-file sites in one folder, finding a folder to update with `list`, and credits.

The first time Claude calls a permahost.io tool, Claude Code opens the browser at app.permahost.io. Sign in or sign up, and Claude Code keeps the token. /mcp lists the permahost server with its status, and signs in from there too.

Try it

Claude Code

> Publish this HTML report and give me the link.

Claude uploads the file into a new folder with format: "textContent" and answers with its URL, such as https://k7q2m9xa3bd.file.permahost.io/report.html. The id and URL here are examples. Later: "Update the report on permahost with this new version": it finds the folder with list and replaces the file at the same URL.

For large or binary files, Claude does better with the permahost CLI in its shell: it uploads from disk without passing the bytes through the conversation. See plugin or CLI?

Update or remove

/plugin opens Claude Code's plugin manager, where the permahost plugin can be updated, turned off or uninstalled.

Self-hosted permahost

Instead of the plugin, add your own server's MCP URL as a server named permahost:

Shell

$ claude mcp add --transport http permahost https://files.example.com/mcp

License

The plugin is licensed under the Apache License 2.0. The permahost server it connects to is AGPL-3.0-only.