Simple Host
Open ChatGPT Plugins. Click Add, then choose Add custom MCP server. Name it Simple Host, paste https://simple-host.app/mcp, and save. In the sign-in window, sign in with Google or an email code, then choose Allow. In a chat, pick Simple Host from the + menu, or just ask.
Open Claude, then Settings, then Connectors, then Browse connectors. Search for Simple Host, choose Connect, sign in, then choose Allow. It works on web, desktop, and phone. Claude also lists a Simple Host plugin (Customize → Plugins → Discover) that adds the connector and skills in one step.
Ask your AI app for a website, and it goes live at its own address, https://<site>.<handle>.simple-host.app/, with a place to save things (RSVPs, votes, sign-ups).
The landing page opens with a 25-second film, narrated by the owner, that plays
with sound when you click it: add Simple Host to your AI, ask for a site, share the
link. Simple Host’s app pages share one blue ink theme, with local fonts, readable body text,
and one system light/dark setting. Your published pages keep their own styles.
Small-box installs get this shared presentation in their next release.
Get started
Connect Simple Host to your own AI app once, then ask it to build and publish a site. Simple Host hosts and manages the result.
- Chat apps: add the connector
https://simple-host.app/mcp and sign in in the window that opens. Open the native accordion for your app (hash links such as #chatgpt open it): get-started page.
- Coding agents: install the skills with
npx skills add vineetu/simple-host.
- Claude Code plugin:
/plugin marketplace add vineetu/simple-host, then /plugin install simple-host@simple-host.
Then ask: "Build me a wedding RSVP page and put it online."
Simple Hack
Hackathons, now for everyone. Anyone can build with AI: describe your idea and
your AI builds the team site. The best idea wins, not the best coder. Organisers
create an event and share one link. College students, product managers, leaders
and people who aren’t programmers can take part.
Get started with Simple Hack walks through adding
https://simple-hack.app/mcp to ChatGPT, Claude, Grok, GitHub Copilot or a coding agent.
Sign in once in the browser window with Google or an email code, then choose Allow.
The page has copyable organiser, participant and judge prompts, a short FAQ, and
its existing downloads and skill files under collapsed “Other ways to install”.
For Claude Code and Codex, install the five Hack skills (Node.js required), then add
the OAuth connector in your agent:
npx -y skills add https://github.com/vineetu/simple-host/tree/main/hack-toolkit --global --agent codex claude-code --yes
Features
Publish and versions
- Publish a folder (archive or inline files) in one call. Every publish is a new version.
- Look before it goes live: publish without making it live, open a one-hour preview link, then make it live.
- Roll back to any kept version. Rename a site and old links keep working.
- Take a site offline and back online. Nothing is deleted.
- Delete is recoverable for 7 days from Recently deleted.
- Download a copy of any site. Public, or unlisted: hidden from your person page, and from search engines unless the site has its own domain or name.
- Visitor analytics per site, from server logs, with top pages and referring domains. No tracking script.
Addresses and custom domains
- Every site has its own address and browser origin:
<site>.<handle>.simple-host.app.
- Your person address opens your public showcase or an owned site you select.
- Curate the showcase with a plain-text bio, pins and manual order; a live JSON feed lists the same visible projects. Your home page covers the dashboard, connector and small-box installs.
- A free
<name>.simple-host.app, live at once.
- Your own domain, subdomain or bare domain. Ownership is proved with one TXT record; the certificate is issued automatically.
www and the bare domain are set up together, one redirecting to the other.
Saved data and lists
- Per-site saved data: one JSON document with atomic operations (set, increment, append, remove).
- Lists that visitors add to: comments, RSVPs, votes, sign-ups.
- Every piece of saved data has a kind: Shared (default, public), Page info (owner writes, everyone reads), Submissions (visitors send; private to the owner by default; each visitor sees, changes and withdraws their own; optional email digest), Personal (one private record per visitor) and Shared board (a list a group edits item by item).
- Private Submissions: only signed-in visitors add; the owner reads all, each visitor only their own.
- The owner can delete entries in any list, edit entries in a private list, empty a list, and download it as CSV. Every change to saved data can be undone for 30 days (History, Recently deleted).
Visitor sign-in
- Visitors sign in with Google or an emailed code on the site's own address.
- Saves are made as that visitor. One sign-in covers one site.
- A small
auth.js client handles it for the page.
Your account, keys and data
- Sign in with an emailed code or Google.
- Named API keys: list, create and revoke them one at a time. Deploy-only keys for CI; a key unused for 180 days stops working. Sign out everywhere in one step.
- Change your sign-in email, confirmed from both addresses, with a 7-day undo.
- An email after each new sign-in or app connection. Can be turned off.
- Download all your data in one archive. Delete your account for good.
For AI agents
- A connector (MCP) at
https://simple-host.app/mcp with sign-in, for chat apps and agents.
- Skills:
website-deploy, website-deploy-builder, connect-domain.
- Plugins for Claude and ChatGPT, and
npx skills add vineetu/simple-host for coding agents.
llms.txt and a full OpenAPI spec.
Operator tools
- Admin console: disk use, running release, every account and site, API traffic.
- Take down a site or suspend an account without deleting anything; restore later.
- Issue participant accounts. Download all entries.
Self-host, small box, hackathons
How it works
- A single Go binary serves every site's files and the REST API.
- Postgres holds accounts, sites, versions and saved data.
- A folder on disk holds the versioned site files.
No object store, no CDN, no build farm. Details: ARCHITECTURE.md and the architecture page.
Run your own
On a company's Kubernetes cluster, run Simple Host Enterprise instead; https://simple-host.app/costs estimates what it costs there (AWS, Azure, Google Cloud).
docker run -d --name simple-host-postgres -p 5432:5432 -e POSTGRES_USER=simplehost -e POSTGRES_PASSWORD=simplehost -e POSTGRES_DB=simplehost postgres:16-alpine
docker exec -i simple-host-postgres psql -U simplehost -d simplehost < db/schema.sql
DB_DSN='postgres://simplehost:simplehost@localhost:5432/simplehost?sslmode=disable' DATA_DIR=./data/sites SITE_DOMAIN=localhost:8090 PUBLIC_BASE_URL=http://localhost:8090 ADMIN_API_KEY=$(openssl rand -hex 32) go run ./cmd/server
Open http://localhost:8090 and sign in with that ADMIN_API_KEY (the admin key). Production build:
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ./simple-host ./cmd/server
Configuration and advanced settings
DB_DSN and ADMIN_API_KEY are required; everything else has a default. The setup helper at
https://simple-host.app/setup?product=small-box writes the install command and .env for a small
box. Its questions, client-side validation, generated settings and install commands run in your
browser. It never asks for a password or key and sends none of your choices to a model. Every setting, by area with recipes (stricter sign-in,
shorter retention, a small hackathon box): docs/advanced/. The full
reference: docs/configuration.md.
API
Authenticated routes take X-API-Key: <key>. JSON in, JSON out. The full contract is openapi.yaml; a readable version is docs.html.
| Endpoint | Method | Description |
|---|
/v1/auth, /v1/auth/verify | POST | Email-code sign-in, returns an API key |
/v1/sites | GET | List your sites |
/v1/sites/{name}/files | POST / PUT | Publish from JSON: {"files": {"index.html": "<h1>hi</h1>"}} |
/v1/sites/{name} | POST / PUT / PATCH / DELETE | Publish an archive / new version / rename or offline / delete |
/v1/sites/{name}/state | GET / PUT / PATCH | Saved data with atomic operations |
/v1/sites/{name}/collections/{coll} | GET / POST | Lists |
/v1/sites/{name}/data/{name} | GET / POST / PUT / PATCH | Saved data by kind (Page info, Submissions, Personal, Shared board); .../kind declares one |
/v1/me/keys | GET / POST / DELETE | Named API keys, deploy-only keys for CI |
/v1/sites/{name}/domain | POST / GET / DELETE | Your own domain |
Working on this repo
License
MIT. See LICENSE.
