# beacon.host

> Web hosting for AI agents: HTML reports, dashboards, mini apps and static sites published to https://<slug>.beacon.host with one command, one API call or one MCP tool call. Free, no account or install needed (anonymous sites last 24 hours and come with a claim link; set expiresAt for a link that expires on schedule, or add a password, both free). Sign in with an emailed code for permanent sites and for serverless API backends (Cloudflare Workers) at https://<slug>.worker.beacon.host.

Fastest publish, one request: `curl -sS https://beacon.host/v1/publish -F file=@report.html` (add `-H 'Accept: text/plain'` for just the link). A folder, no install: `curl -fsSL https://beacon.host/publish.py | python3 - ./dist`

Raw API for big sites, three calls: `POST /v1/sites` with a file manifest (path, size, contentType, sha256 hash), `PUT` each file to its presigned `uploadUrl`, then `POST` the returned `finalizeUrl` with header `X-Claim-Token: <claimToken>`. Accounts have no password: `POST /v1/auth/send-otp` then `POST /v1/auth/verify-otp` returns an API key (`Authorization: Bearer chk_...`).

## Docs

- [Agent skill (start here)](https://beacon.host/skill.md?ref=llms): publish, update, sign in, claim, workers, errors, limits. About 4k tokens. Install it with `npx skills add beacon-host/skill -g`.
- [Full API reference](https://beacon.host/llms-full.txt): every endpoint with request and response examples, including workers, multipart uploads, versions, and rollback.
- [OpenAPI 3.1 spec](https://beacon.host/openapi.json): machine-readable description of the /v1 API.
- [Human docs](https://beacon.host/docs): the same reference as HTML.
- [Host a static site with no signup](https://beacon.host/guides/host-static-site-no-signup?ref=llms): one command, the HTTP API, MCP, a comparison of no-account hosts, and how a human claims the site later.
- [Share an HTML file as a link](https://beacon.host/guides/share-html-file-as-link?ref=llms): one request, free password, update in place, expiry.
- [Publish from Claude Code or Codex](https://beacon.host/guides/publish-html-from-claude-code?ref=llms): one prompt, skill/MCP/CLI setup, the Codex sandbox network fix, and measured time to a live URL.
- [Temporary links](https://beacon.host/guides/temporary-website-hosting?ref=llms): 24-hour links with no account, your own expiry with an API key, and what happens at expiry.
- [Password-protect an HTML page](https://beacon.host/guides/password-protect-html-page?ref=llms): one call adds HTTP Basic Auth to any site, including anonymous ones, free.
- [File upload API](https://beacon.host/file-upload-api?ref=llms): upload a PDF, image or HTML file with no account and get a public link that opens in the browser.
- [Workers](https://beacon.host/workers?ref=llms): deploy a JavaScript, TypeScript or Hono API or webhook receiver to https://<slug>.worker.beacon.host. No Cloudflare account; sign in with an emailed code; the URL stays up until deleted.
- [Deploy a webhook receiver](https://beacon.host/guides/deploy-webhook-from-agent?ref=llms): signed GitHub or Stripe receiver at https://<name>.worker.beacon.host, no Cloudflare account.
- [Agent skill install page](https://beacon.host/agent-skill?ref=llms): install commands per agent, and how publish-website compares with other deploy skills.
- [All guides](https://beacon.host/guides?ref=llms)

## Compare

- [here.now alternatives: beacon.host, Netlify Drop and Vercel compared](https://beacon.host/vs/here-now.md?ref=llms): verified no-account limits, claim windows, prices and one publish command per host.
- [Netlify Drop, tiiny.host and surge.sh alternatives](https://beacon.host/vs/netlify-drop-tiiny-host-surge.md?ref=llms): which hosts still publish without an account, how long unclaimed links last, measured times, checked 1 October 2026.

## Tools

- [publish.py](https://beacon.host/publish.py): standard-library Python script that publishes a file or folder and prints the URL (`--expires 2h` for a link that expires sooner).
- [install.sh](https://beacon.host/install.sh?ref=llms): installs the agent skill and the `beacon` CLI on macOS/Linux (`beacon deploy --pretty`).
- [install.ps1](https://beacon.host/install.ps1?ref=llms): the same for Windows.
- [MCP server](https://beacon.host/mcp): remote MCP endpoint (Streamable HTTP, no OAuth) with publish_site, get_site, get_docs; setup for Claude Code, Codex, Cursor, VS Code, claude.ai and ChatGPT.
- [HTML to URL](https://beacon.host/html-to-url): browser tool for people: drop an HTML file, folder or .zip, or paste HTML, and get a public link. No account; links last 24 hours unless claimed.

## Discovery

- [Agent Skills index](https://beacon.host/.well-known/agent-skills/index.json)
- [Limits](https://beacon.host/v1/limits): rate limits and size caps as JSON.
- [API catalog (RFC 9727)](https://beacon.host/.well-known/api-catalog)
- [Markdown homepage](https://beacon.host/index.md)

## Optional

- [Dashboard](https://beacon.host/dashboard): human sign-in to keep sites, see and delete them, view usage, and copy the API key (drag-and-drop publishing works without signing in on / and /html-to-url).