# 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 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, or any runtime).

## 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 54 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
- 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: `/plugin marketplace add xhostd/xhost-sdk` + `/plugin install xhost@xhost-sdk` (MCP server + skill), or `claude mcp add --transport http xhost https://mcp.xhostd.com/mcp/`; then `/mcp` → Authenticate. 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 via Google sign-in for a person; a registered agent sends `Authorization: Bearer xh_...` itself.
- Raw HTTP API and git remotes: `Authorization: Bearer <XHOST_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)