{"id":"com.viberooster/hatch","slug":"com-viberooster-hatch","title":"Hatch","description":"Hosting for AI agents: publish a live website in one tool call, ephemeral or forever.","version":"1.0.0-1","publisher":{"kind":"domain","id":"viberooster.com","label":"viberooster.com","url":"https://viberooster.com"},"website":"https://viberooster.com/install.html","repository":"https://github.com/VibeRooster/viberooster.github.io","remotes":[{"type":"streamable-http","url":"https://mcp.theroost.dev/mcp"}],"packages":[],"published":"2026-08-14","updated":"2026-08-14","status":"online","auth":"","latency_ms":972,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"hatch","title":"Hatch a new site","description":"Create a NEW site (a 'roost') and return its public URL in one call. Returns `{ hatchId, slug, url, apex, promo, uploads? }` — show `url` to the user and remember `hatchId`. NEVER call hatch twice for the same site — use `convert` to rename, change tier, or set Promo, and `upload`/`deploy` for content updates.\n\nPick `apex` from the user's intent (homes / estate / land / wedding / events / agency /","read_only":false},{"name":"upload","title":"Upload files to an existing site","description":"Add or replace files on an EXISTING roost. Pass `hatchId` plus a `manifest` listing each file's path, size, and optional content type. Returns one presigned PUT URL per file — upload bytes directly via HTTP (e.g. `curl -T file.png -H 'Content-Type: image/png' \"$url\"`). Files go live immediately as each PUT completes; no separate publish call is needed. Use after regenerating a dashboard locally; H","read_only":false},{"name":"lookup","title":"Lookup a site","description":"Resolve a roost by `slug` or `hatchId`. Returns a compact view `{ hatchId, slug, url, apex, tier, state, expiresAt, customDomain, galleryListed, promo, pageviews24h, visitors24h, topPaths, topCountries, topReferrers }`. `promo` is true when the hatch is marked Promo (listed on the public carousel even when its tier would hide it, if active, with a public slug, and not expired; Powered By chip forc","read_only":true},{"name":"list","title":"List workspace hatches","description":"List every hatch in a workspace. Returns `{ workspaceId, name, count, hatches: [{ hatchId, slug, url, apex, kind, tier, state, expiresAt, createdAt, promo, pageviews24h, visitors24h }] }`. `promo` is true when that hatch is marked Promo. Use this when you lost hatchIds, before hatching (so you do not create a duplicate), or when the user asks what is live in the workspace. `workspaceId` is optiona","read_only":true},{"name":"rename_org","title":"Rename organization and workspace","description":"Rename the organization and/or workspace after Roost or Roost Audit has been paid. Pass `orgName`, `workspaceName`, or both. Requires a workspace-paired session. Fails on free Hatch workspaces — call `checkout` with grant `workspace_subscription` (Roost) or `agentic_pro` (Roost Audit) first, then `poll_checkout`. Does not rename a hatch URL; use `convert` for that. Returns `{ workspaceId, workspac","read_only":false},{"name":"convert","title":"Rename or change tier","description":"Atomically rename a roost's URL, change gallery listing, mark or unmark Promo, or bind a custom domain (Roost / Roost Audit after checkout grant custom_domain). Pass `hatchId` plus at least one of `newPreferredSlug`, `galleryListed`, `promo`, or `customDomain`. Do NOT call `hatch` again to rename or to change Promo — that creates a second site.\n\nOptional `promo` (boolean). `true` lists this hatch ","read_only":false},{"name":"catalog","title":"List payable features","description":"List VibeRooster features the user can pay for (Pin $4.99/yr, Pack $4.99/yr/GB, Roost $259/mo, Roost Audit $459/mo, custom domain +$29/mo) with Stripe Price ids, amounts, and feature lists. Call this before `checkout` if you don't already know the grant. Returns `{ items: [{ grant, title, description, features, priceId, amountCents, scope }] }`.","read_only":true},{"name":"list_templates","title":"List HTML templates","description":"List HTML templates and explorable archetypes from the public template catalog (https://github.com/VibeRooster/hatch-mcp/tree/main/templates). Returns `{ repo, browse, templates: [{ name, title, description, url, prompt, referenceUrl? }] }`. `prompt` is the suggested text for the user. `referenceUrl` is the live example when one is published. Descriptions come from each file's frontmatter. Open `u","read_only":true},{"name":"checkout","title":"Create a payment link","description":"Create a Stripe Checkout Session so the user can pay for a VibeRooster feature in this chat. Returns `{ checkoutUrl, sessionId, grant, amountCents }` — ALWAYS show checkoutUrl to the user (open it / paste it). After they pay, call `poll_checkout` with sessionId until status is `complete`. The webhook applies the grant (Pin, Pack, Roost, Roost Audit, custom domain).\n\nRequired ids by grant: `publish","read_only":false},{"name":"poll_checkout","title":"Wait for payment","description":"Long-poll a Checkout Session from `checkout` (~18s). Returns `{ status: open|complete|expired, grantApplied, roostUrl, tier }`. If still `open`, tell the user to finish paying at checkoutUrl and call poll_checkout again. When `grantApplied` is true, the webhook has (or is about to) apply the grant — call `lookup` to confirm forever/tier.","read_only":true},{"name":"auth","title":"Protect a site with a login","description":"Put a sign-in screen in front of any roost so visitors must authenticate. Works on free, workspace, and forever hatches. Pass `hatchId` plus an `action`:\n• `enable` with `mode: \"password\"` and a `password` → ONE shared site password (everyone uses the same one). Best for a private demo or staging link.\n• `setPassword` with a new `password` → rotate the shared password.\n• `disable` → remove the log","read_only":false},{"name":"share","title":"Guest view link","description":"Issue a signed, expiring guest view URL for any tier (`?vt=…`). Use for private run reports without the shared site password. Returns `{ url, viewToken, expiresAt }`.","read_only":false},{"name":"await_decision","title":"Await human decision","description":"Create a human-in-the-loop review on the live artifact. Default options: Approve / Request changes / Reject. Reviewers see a Review required chip → modal. Request changes is non-terminal: webhook or poll returns changes_requested, then call continue_decision after regenerating. Optional timeoutSeconds and maxIterations (default 5). If the page has interactive controls (sliders/forms), the hatch HT","read_only":false},{"name":"continue_decision","title":"Continue HITL after changes requested","description":"After poll_decision returns status changes_requested, regenerate, then call this to reopen the same decision as pending_review for the next human round. Only decisionId is required (hatchId is read from the decision).","read_only":false},{"name":"poll_decision","title":"Poll decision resolution","description":"Long-poll (~20s) until the decision leaves pending_review. Only decisionId is required (hatchId is read from the decision). Returns changes_requested (regenerate + continue_decision), approved, rejected, timeout_exceeded, max_iterations_exceeded, not_found, or still pending_review (call again). Includes comment, settings, conversation, iteration. Polling never writes: timeout_exceeded only ever me","read_only":true},{"name":"whoami","title":"Check identity","description":"Return the caller's current identity and hatch state. Never errors when unidentified — returns a pairing path instead. After poll_pairing completes, whoami with the same hatchId should show identified:true via server-side session binding. Returns sessionExpiresAt (~1h) and grantExpiresAt (~7d). If sessionExpired:true, call refresh_session with your stored refreshToken.","read_only":true},{"name":"get_pairing_code","title":"Get pairing code","description":"Issue a pairing code + URL (TTL 2 hours) for claiming a hatch (`hatchId`) or authorizing an agent session in a workspace (workspaceId). Reuses the active pending code for this connector session unless `forceNew: true`. For workspace pairing, show `pairingUrl` (https://mcp.theroost.dev/open/workspace-pair) as the link the user taps — it opens the Vibe Rooster app on the phone, and on a computer it ","read_only":false},{"name":"poll_pairing","title":"Poll pairing completion","description":"Poll for pairing completion (Device-Grant style). Waits up to ~20s for phone approval before returning. Statuses: pending / completed / expired / not_found. On completed, store sessionToken, refreshToken, and grantId — refreshToken renews access for up to 7 days without re-pairing. When sessionToken expires (~1h), call refresh_session. The server also binds tokens to this connector session. Pass h","read_only":true},{"name":"refresh_session","title":"Refresh agent session","description":"Renew a short-lived access token (~1h) using the refreshToken from poll_pairing. The grant (and refresh capability) lasts up to 7 days — after that, re-pair via get_pairing_code. Each refresh rotates the refreshToken; store the new one. Requires the same connector session (MCP-Session-Id) as when you paired — if fingerprint mismatches, re-pair.","read_only":false},{"name":"poll_approval","title":"Poll destructive-op approval","description":"Poll a pending Tier-2 phone approval. Returns the result once the owner approves or denies on their phone.","read_only":true},{"name":"alarm","title":"Alarm the paired phone","description":"Sound a loud alarm on the phones paired to this roost. Pass `hatchId` and a short `message` — the phone shows that message and repeats the alarm until the person acknowledges it. Recipients are only phones paired to this roost or its workspace. There is no phone-number argument. Do not pass one, and do not try to reach any other device.\n\nAndroid plays alarm audio. The alarm channel bypasses Do Not","read_only":false},{"name":"squawk_request_access","title":"Request Squawk access","description":"Ask the roost owner to admit this agent to Squawk. Uses the caller's Hatch pairing session (Authorization: Roost, the bound connector session, or sessionToken from poll_pairing). Returns `{ requestId, status: \"pending\", expiresAt }`. The request expires 2 hours after it is opened. Does not create a Squawk member. This tool is on Hatch, not on the Squawk server. Pass displayName and runtime. Option","read_only":false},{"name":"squawk_poll_access","title":"Poll Squawk access","description":"Poll an admit request opened by squawk_request_access. Uses the same Hatch pairing session. While pending, returns `{ status: \"pending\", expiresAt }`. After the owner approves, returns the member, the rin_ token once, roostId, and mcpServers.squawk. Install the returned mcpServers.squawk block into this MCP client immediately. Use the url and the Authorization header exactly as returned. Do not pr","read_only":false},{"name":"deploy","title":"Replace site code (advanced)","description":"Replace the server-side code of an existing roost. Advanced — most agents should use `upload` (for static files) or `convert` (for renames) instead. Pass `hatchId`, `workerName`, and a full ES module `script` (text only, 1.5 MiB max).","read_only":false}],"server_info":{"name":"viberooster-hatch","version":"2026-11-19+0c46d14","title":"Hatch Roost"},"category":"news","tags":["web-search","cloud","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-14","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-viberooster-hatch/"}