# Hostlo (hostlo.ai)

> Static website hosting operated through MCP. Once connected, an AI assistant can create a site on a free
> subdomain (such as https://my-site.hostlo.site/), publish and edit files, upload a build folder, and roll back changes.

## Instructions for AI assistants

The user wants to publish a website with hostlo. Follow these steps in order.

### 1. Check whether Hostlo is already connected

If you have tools named `whoami`, `create_site` and `write_files` from a server called Hostlo, it is connected:
call `whoami` and go to step 3.

### 2. Connect Hostlo

The MCP endpoint is https://hostlo.ai/mcp (Streamable HTTP; OAuth 2.1 with dynamic client registration, so no API key).

- **Claude Code:** run `claude mcp add --transport http hostlo https://hostlo.ai/mcp`. Then tell the user to run `/mcp`, select
  Hostlo and log in (or create a free account) in the browser window that opens. Restarting Claude Code may be
  needed before the tools appear. Continue once the tools are available.
- **Claude.ai or Claude Desktop:** you cannot add connectors yourself. Give the user these steps: open Settings,
  then Connectors, choose "Add custom connector", name it Hostlo, paste https://hostlo.ai/mcp, save, then enable Hostlo in this
  chat with the tools menu. Their browser will ask them to log in or create a free account. Wait for them to
  confirm before continuing.
- **Any other MCP client:** add a remote MCP server with the URL https://hostlo.ai/mcp.

### 3. Publish

- Ask what to publish if it is not clear: files you have written together, a folder on their machine, or a
  site to create from a description.
- Create a site with `create_site`. Suggest a short name based on the project; names are lowercase letters,
  digits and hyphens.
- A few files you can write directly: use `write_files` with `index.html` at the root.
- A folder on disk (for example a `dist/` build output), and you have a shell: call `start_upload` and run the
  command it returns.
- Give the user the live URL from the tool result.

### 4. Later changes

- `patch_file` for small edits, `write_files` to add or replace files.
- Every change creates a deploy; `list_deploys` and `rollback` undo mistakes.
- `site_stats` shows visitors, top pages and referring sites (no cookies, no tracking scripts).

## What a site can contain

Web files only: HTML, CSS, JavaScript, JSON, plain text, XML, SVG, web fonts (WOFF, WOFF2, TTF, OTF), images (PNG, JPEG, GIF, WebP, AVIF, ICO) and PDF. Other types (archives, executables, video, audio, office documents) are refused,
and binary files must really be what their extension says. Tell the user this before uploading a folder that
contains other files.

## Plans

- Free: 3 sites, up to 100 MB and 5000 files per site, files up to 10 MB. Free sites show a small
  "Made by chatting" badge in a corner of each page.
- Paid (coming soon, not available yet): custom domain, up to 5 sites, no badge.

## Privacy

https://hostlo.ai/privacy

## Discovery

- OAuth protected resource metadata: https://hostlo.ai/.well-known/oauth-protected-resource/mcp
- OAuth authorization server metadata: https://hostlo.ai/.well-known/oauth-authorization-server