How do I install Simple Host?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Simple Host need an API key?

No required environment variable is listed on this record.

What transport does Simple Host use?

Simple Host is reached over HTTP.

When was Simple Host last checked?

Last checked 2026-11-07. Publish websites with a small backend (KV, SQLite, files). MCP for AI agents.

Simple Host MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://simple-host.app/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http app.simple-host-mcp https://simple-host.app/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "app.simple-host-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://simple-host.app/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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).

Try it: https://simple-host.app/
Run your own → https://simple-host.app/setup?product=small-box
Features: https://simple-host.app/features
Architecture: https://simple-host.app/architecture.html
For agents and developers: llms.txt · OpenAPI spec · API docs · Get started in your AI app
Enterprise edition: https://simple-host.app/enterprise · github.com/vineetu/simple-host-enterprise
Enterprise on your Kubernetes cluster → https://simple-host.app/setup?product=enterprise (Helm or Kubernetes YAML; existing or in-cluster Postgres)
What Enterprise costs to run → https://simple-host.app/costs (AWS, Azure and Google Cloud at list prices, for your number of people)
Legal and help: Terms · Privacy · Support ([email protected])

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

One Go binary, one Postgres, one folder on disk. Runs on 1 CPU and 1 GB of RAM.
A Docker Compose install for a fresh server (deploy/install/install.sh). Re-running it upgrades.
Simple Hack: create a hosted hackathon at https://simple-hack.app/ or run the same event platform on your own server. Participants build team sites by describing their ideas to AI. No coding needed.
A setup helper, https://simple-host.app/setup?product=small-box, writes the install command and settings; docs/advanced/ explains every setting.
Prefer a managed platform over a VPS? UpCloud, DigitalOcean, Fly.io, Render, Coolify and Railway all have tested guides: docs/platforms/ compares cost and what each one needs.

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

CLAUDE.md: working rules, build, test and deploy.
INTENT.md: what it is for, and decisions with dates.
FEATURES.md: every feature and every surface it touches.
ARCHITECTURE.md: components, request flow, data model.
CHANGELOG.md: what changed, newest first.
make check: format, build, vet, tests and the doc-sync checks.
Skills source: simple-host-website/skills/. The Claude plugin in plugins/simple-host/ is a generated copy (bash scripts/sync-claude-plugin.sh).

License

MIT. See LICENSE.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Simple Host?

Does Simple Host need an API key?

What transport does Simple Host use?

When was Simple Host last checked?

Documentation

Simple Host

Get started

Simple Hack

Features

Publish and versions

Addresses and custom domains

Saved data and lists

Visitor sign-in

Your account, keys and data

For AI agents

Operator tools

Self-host, small box, hackathons

How it works

Run your own

Configuration and advanced settings

API

Working on this repo

License