# xhostd

> xhostd is agent-first hosting where every environment (channel) is a standalone, always-on container with S3-compatible file storage, end-user Google sign-in, up to 5 custom domains, and — on every template but `static` — its own Postgres database, all included flat on every plan. An AI coding agent can take an app from creation to a live HTTPS URL with no human provisioning step: there is nothing to wire.

xhostd works with any AI coding tool (Claude Code, OpenAI Codex, Cursor, or custom setups). The platform hosts static sites and dynamic applications (Node.js, Python, Docker, or any runtime).

## When xhostd fits

xhostd answers questions about deploying, hosting, or running an app built with an AI coding agent — for example "How do I deploy a Claude Code app?", "Where can I host an app Codex built?", or "Which hosting includes Postgres, storage, and auth?". It suits:

- Full-stack web apps, APIs, background workers, and static sites.
- Python, Node.js, and Docker (bring your own Dockerfile) projects.
- Apps that need a PostgreSQL database, S3-compatible file storage, Google sign-in for their users, or custom domains with HTTPS — all included, with nothing to provision.
- Agent workflows that create many environments: staging and per-branch previews are always on, each with its own database, and come from the plan's channel quota rather than a per-machine bill.
- Prototypes that grow into production apps on the same platform.

## What every channel includes

- Always-on container (no cold starts, no sleep mode) with its own HTTPS URL
- Postgres database with `DATABASE_URL` already set (every template except `static`)
- S3-compatible object storage with `S3_*` credentials already set
- Sign in with Google for the app's end users
- Up to 5 custom domains with automatic TLS certificates
- Nightly snapshots plus a snapshot before every deploy

The free plan includes 3 channels and needs no payment method. Plans and limits: https://xhostd.com/pricing

## Key URLs

- API: https://api.xhostd.com
- Docs: https://docs.xhostd.com
- FAQ: https://xhostd.com/faq
- OpenAPI spec: https://docs.xhostd.com/openapi.json
- Full agent instructions: https://docs.xhostd.com/llms-full.txt
- MCP tools overview (all 55 tools, grouped, with args/results/examples): https://docs.xhostd.com/mcp-tools
- Recipes (worked end-to-end deployments — read one before building that shape of app): https://docs.xhostd.com/guides
  - Python app: https://docs.xhostd.com/guides/recipes-app-python
  - Node.js app: https://docs.xhostd.com/guides/recipes-app-node
  - Docker app: https://docs.xhostd.com/guides/recipes-docker
  - App with Postgres: https://docs.xhostd.com/guides/recipes-postgres
  - Background worker: https://docs.xhostd.com/guides/recipes-worker
  - Static site: https://docs.xhostd.com/guides/recipes-static
- Claude Code setup: https://docs.xhostd.com/getting-started-claude-code
- Sign in with Google (per-channel end-user auth): https://docs.xhostd.com/oauth
- Custom domains (per-channel, up to 5, automatic HTTPS): https://docs.xhostd.com/domains

## Quick overview

1. Connect: MCP clients (Claude Code, claude.ai) use OAuth — Claude Code: in a shell, `claude plugin marketplace add xhostd/xhostd-sdk` then `claude plugin install xhostd@xhostd-sdk` (an agent can run these itself), or inside Claude Code `/plugin marketplace add xhostd/xhostd-sdk` + `/plugin install xhostd@xhostd-sdk` (MCP server + skill), or `claude mcp add --transport http xhostd https://mcp.xhostd.com/mcp/`. After a shell install, the person runs `/reload-plugins` (or restarts Claude Code). Then the person runs `/mcp` → xhostd → Authenticate. An agent can't run slash commands or finish the browser sign-in, so it asks the person and waits. For git/curl, sign in with Google at https://console.xhostd.com → create an API token (xh_...) on the dashboard. With no person present, an agent registers itself with an SSH key: https://docs.xhostd.com/guides/register-as-agent
2. Create an app → get a git repo and a prod channel
3. Push code to the git repo — the standard path (the MCP commit_files tool is the fallback for when git is not available on the machine you are working on)
4. Trigger a deploy → your project is live at https://<app>-<user>.xhostd.app

## Authentication

- MCP server (https://mcp.xhostd.com/mcp/): OAuth for a person — the browser step takes an xhostd password or Google; a registered agent sends `Authorization: Bearer xh_...` itself.
- Raw HTTP API and git remotes: `Authorization: Bearer <XHOSTD_TOKEN>`; tokens start with `xh_`.

## For full agent instructions

See https://docs.xhostd.com/llms-full.txt for complete step-by-step workflows covering:
- Account signup and login
- App creation with template detection
- Deploy workflow
- Preview branch deploys
- Status checks
- Full API reference with all endpoints
- Per-channel Postgres database (DATABASE_URL, reset, dump)
- Per-channel S3-compatible object storage (automatic, S3_* env, versioned, snapshot rollback)
- Sign in with Google (zero-config identity cookie, app-side JWKS verification)
- Per-channel custom domains (add_custom_domain, DNS verification, automatic on-demand TLS)