
publish-website agent skill: deploy a static site or HTML from Claude Code, Codex, Cursor or Gemini
publish-website agent skill: deploy a static site or HTML from Claude Code, Codex, Cursor or Gemini CLI and get a live URL. No signup.
·
Ask your coding agent to "publish this", "host this" or "put this online" and it uploads the folder to beacon.host and hands back https://<slug>.beacon.host. No account needed. Works in Claude Code, Codex, Cursor, Gemini CLI, OpenCode and any agent that reads SKILL.md.
What it hosts:
https://<slug>.beacon.hosthttps://<slug>.worker.beacon.host (free account, no Cloudflare account)What your agent returns:
Your site is live:
https://quiet-river-42.beacon.host
It will be deleted in 24 hours. To keep it, open this link and sign in with your email:
https://beacon.host/claim/quiet-river-42#ctk_...An anonymous site lasts 24 hours; the claim link keeps it, and signing in takes an emailed code, no password. How claiming works: https://beacon.host/guides/host-static-site-no-signup#claim-the-site-later
No shell in your agent? Use the MCP server instead: claude mcp add --transport http beacon https://beacon.host/mcp (setup for other clients: https://beacon.host/mcp).
Any agent that reads Agent Skills (Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and others):
npx skills add beacon-host/skill -gClaude Code plugin:
/plugin marketplace add beacon-host/skill
/plugin install beacon-host@beacon-hostGemini CLI extension:
gemini extensions install https://github.com/beacon-host/skillCodex plugin:
codex plugin marketplace add beacon-host/skill
codex plugin add beacon-host@beacon-hostCursor reads .cursor-plugin/plugin.json from this repo.
beacon.host also runs a remote MCP server at https://beacon.host/mcp (Streamable HTTP, no OAuth) with publish_site, get_site, and get_docs tools. The Gemini CLI extension connects to it automatically. In Claude Code:
claude mcp add --transport http beacon https://beacon.host/mcpscripts/publish.py publishes a folder or a single file. It needs Python 3.8+ and nothing else.
python3 scripts/publish.py ./dist # a folder
python3 scripts/publish.py report.html # one HTML file, served as index.html
python3 scripts/publish.py ./dist my-site # choose the subdomain
python3 scripts/publish.py --helpIt prints JSON with url, slug, expiresAt, and, for anonymous sites, claimUrl. Running it again on the same path updates the same site. The slug and claim token are saved in ./.beacon/publish.json, which is git-ignored.
To make sites permanent, set BEACON_API_KEY to an API key, or save it as {"apiKey": "chk_..."} in ~/.config/beacon/config.json, the file beacon login writes. Keys come from POST https://beacon.host/v1/auth/verify-otp or beacon login.
The script never uploads .git, node_modules, virtualenvs, files matched by the folder's .gitignore or .beaconignore, or files that usually hold secrets (.env and .env.*, .npmrc, .netrc, SSH keys, *.pem, *.key). It is the same script beacon.host serves at https://beacon.host/publish.py.
For workers and larger projects, use the beacon CLI:
curl -fsSL https://beacon.host/install.sh -o install-beacon.sh && sh install-beacon.sh
beacon deploy --pretty| Path | What it is |
|---|---|
skills/publish-website/SKILL.md | The skill. It's the same file beacon.host serves at https://beacon.host/skill.md |
scripts/publish.py | A zero-dependency publisher (Python standard library only) |
.claude-plugin/plugin.json, .claude-plugin/marketplace.json | Claude Code plugin and marketplace |
.codex-plugin/plugin.json | Codex plugin |
.cursor-plugin/plugin.json | Cursor plugin |
gemini-extension.json | Gemini CLI extension. The skill is discovered from skills/ |
assets/logo.svg | Logo |
Everything this plugin sends goes to beacon.host or its file storage:
https://beacon.host/mcp, go to https://beacon.host.*.r2.cloudflarestorage.com) through presigned URLs that the beacon.host API returns.scripts/publish.py reads an API key from BEACON_API_KEY or ~/.config/beacon/config.json and sends it only to the beacon.host API (or to the URL you set in BEACON_API_URL).publish.py and the beacon CLI installer from beacon.host.Anonymous sites are deleted after 24 hours. Sites and workers in an account stay until you delete them.
MIT. See LICENSE.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/skill to learn what the "Skill" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx skills add beacon-host/skill -gclaude mcp add --transport http beacon https://beacon.host/mcp| Name | What it does |
|---|---|
get_docs | Return the full beacon.host documentation as Markdown (the same text as https://beacon.host/skill.md): the REST API, the beacon CLI, accounts and API keys, claiming sites, password protection, and Wor |
get_site | Check a beacon.host site: whether it is live, its URL, whether it has a password, and when it expires. With the site's claim_token (or an API key that owns the site) it also returns the file list, tot |
publish_site | Publish a website or any file (PDF, image, HTML, CSS/JS) to a live public HTTPS URL at <slug>.beacon.host in one call. Files keep their content type, so PDFs and images open in the browser. No account |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/skill)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "skill" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.