Publish a local file or folder and get a link
publish_pathPublish a local file, zip, or directory to a public URL with preserved structure, so recipients can open links and view documents, images, code, and sibling assets inline.
Instructions
Publish a local file, a zip, or a whole directory to a public URL, preserving the directory structure. Use this when the page needs sibling files (CSS, JS, images) — write them into a directory first, then publish that directory. It is also the way to share any document: Word (doc/docx), Excel (xls/xlsx) and Markdown render as readable pages, code and data files get syntax-highlighted previews, and images and video display inline — the recipient opens a link instead of downloading a file. (PowerPoint files publish and download fine but have no rendered preview.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "publish_path"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path to a file or directory on this machine. A directory is uploaded recursively with its structure preserved; symbolic links and common private paths (.git, .env*, node_modules, .ssh, .aws) are skipped. An explicitly selected single file is uploaded as requested, so never select credentials or other secrets. A zip archive is unpacked server-side. | |
| update_url | No | A URL returned by an earlier publish. When given, the content of that page is replaced and the link stays the same. Requires the server to be configured with a Plopino token. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public link to the published page — give this to the user. | |
| note | Yes | Human-readable status: created vs updated, and how long the page is kept. | |
| claimUrl | No | Private browser claim link for the publisher only. Never give it to page viewers or append it to the public URL. |