Hatch
Server Details
Hosting for AI agents: publish a live website in one tool call, ephemeral or forever.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- VibeRooster/viberooster.github.io
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 24 tools
Despite 24 tools, the descriptions are unusually good at cross-referencing: hatch/convert/deploy/upload, list/lookup, and await_decision/poll_decision/continue_decision each explicitly state when to use which alternative. The main soft spots are `poll_approval` (a 'Tier-2 phone approval' that no other tool ever creates) and the mild identity overlap between `whoami` and `lookup`, plus `alarm`/`share` sitting in a publishing-oriented set.
No casing chaos — everything is snake_case — but verb style is mixed: multi-word tools follow verb_noun (get_pairing_code, poll_decision, rename_org), while single words are bare verbs or nouns (hatch, convert, deploy, upload, auth, alarm, catalog, share, lookup, whoami). Names like `hatch` (create) and `convert` (rename/tier/domain) are semantically opaque until you read the description.
24 tools is heavy for what is essentially publish-a-site plus account plumbing; the surface sprawls across site hosting, pairing/session lifecycle, Stripe billing, HITL reviews, and Squawk admission. Each cluster is coherent, but the aggregate is at the top of the 16-25 'heavy' band, and at least one tool (poll_approval) has no visible counterpart.
Create (hatch), content update (upload/deploy), rename/tier/domain/promo (convert), inspect (list/lookup), auth, share, billing, pairing, and review lifecycles are all covered. However there is no delete/expire/take-down operation for a roost, no cancel-subscription path, and no tool that initiates the Tier-2 phone approval that `poll_approval` waits on — real dead ends for lifecycle management.
Publisher details
- Operator
- Vibe Rooster · Publisher source
- Operator website
- https://www.viberooster.com · Publisher source
- Vendor relationship
- Independent
- Documentation
- https://www.viberooster.com/install · Publisher source
- Privacy policy
- Not provided
- Trust center
- Unknown
- Restrictions
- Free-tier usage requires no account. Enterprise-tier features require paid plan. · Publisher source
Available Tools
24 toolsalarmAlarm the paired phoneAInspect
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.
Android plays alarm audio. The alarm channel bypasses Do Not Disturb after the person grants that access. iOS requests Critical Alerts and this push is sent with a critical sound at full volume. Apple has not granted the Critical Alerts entitlement (com.apple.developer.usernotifications.critical-alerts) yet, so iOS does not bypass the Ring/Silent switch until that grant. Do not tell the user the silent switch was bypassed.
A claimed roost requires a paired agent session. If no phone is paired, or the phone has not allowed notifications, the call fails and nothing is sent.
Inputs: message (required), hatchId, tenantId, sessionToken.
authProtect a site with a loginADestructiveIdempotentInspect
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:
• enable with mode: "password" and a password → ONE shared site password (everyone uses the same one). Best for a private demo or staging link.
• setPassword with a new password → rotate the shared password.
• disable → remove the login and serve the site publicly again.
• status → report whether auth is on and which mode.
Returns { enabled, mode, loginUrl }. The sign-in screen lives at /__roost/login. Prefer password mode; useraccounts is unavailable (per-hatch databases are no longer provisioned).
Inputs: mode, action, hatchId, password, +2 more.
await_decisionAwait human decisionAInspect
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 HTML MUST expose window.VR_HITL_GET_SETTINGS so the review can attach those assumptions as JSON. When the user integrates n8n, Temporal, CI, or any external workflow, pass webhookUrl (MCP opens the review; the platform POSTs each transition to that URL — prefer webhook over poll_decision for automation). See PARTNER-WEBHOOKS.md for event payloads.
Inputs: title, policy, hatchId, options, +7 more.
catalogList payable featuresARead-onlyIdempotentInspect
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 }] }.
Inputs: grant.
checkoutCreate a payment linkAInspect
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).
Required ids by grant: publish / record / credit_topup / workspace_coin_pack (Pack) → hatchId; workspace_subscription (Roost) / custom_domain → workspaceId (or hatchId in that workspace); agentic_pro (Roost Audit) → orgId or workspaceId/hatchId attached to the org.
Do not use Stripe MCP (mcp.stripe.com) for VibeRooster features — that would charge a different Stripe account. Hatch checkout stamps hatch/workspace/org metadata the webhook expects.
Inputs: grant (required), orgId, hatchId, priceId, +3 more.
continue_decisionContinue HITL after changes requestedAInspect
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).
Inputs: decisionId (required), title, hatchId, tenantId, +3 more.
convertRename or change tierADestructiveIdempotentInspect
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.
Optional promo (boolean). true lists this hatch on the public carousel even when its tier would hide it, if the hatch is active, has a public slug, and is not expired, and forces the Powered By chip on. A password still keeps it off the carousel. false unmarks Promo and returns the normal carousel and chip rules. Omit promo to leave the flag unchanged. promo alone is enough.
Roost and Roost Audit include 10 subscription Pins. convert with newTier: forever is allowed while those slots remain. After that, call checkout with grant publish (Pin, $4.99/yr). Do not use convert to collect payment.
Pins are hidden from the carousel by default; pass galleryListed: true to feature the site publicly. Paid Roost hatches stay off the carousel unless promo is true.
Inputs: promo, hatchId, newTier, tenantId, +4 more.
deployReplace site code (advanced)ADestructiveIdempotentInspect
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).
Inputs: script (required), workerName (required), policy, hatchId, +6 more.
get_pairing_codeGet pairing codeAInspect
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 opens a page that forwards into the app when the same link is opened on the phone. Do not show only appUrl; that viberooster:// link does nothing in a desktop chat. appUrl is only for an in-app QR. Do not call again until poll_pairing returns expired/completed or you intentionally rotate with forceNew.
Inputs: hatchId, forceNew, tenantId, workspaceId.
hatchHatch a new siteAInspect
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.
Pick apex from the user's intent (homes / estate / land / wedding / events / agency / site / omit for theroost.dev). Do NOT invent other apexes.
Ways to call it:
• html (PREFERRED for n8n / a single review page) → one self-contained HTML string published at /. Do not also pass site/manifest/script.
• Omit html, manifest, site, and script → a placeholder page is published instantly.
• Pass manifest (file list with sizes) → returns presigned uploads[]; you PUT each file's bytes directly to its URL. PREFER this for any project with images, fonts, video, or more than a few KB of HTML.
• Pass site (inline files map) → small text-only sites only. File keys must be paths like index.html (n8n may send index; that is accepted as index.html).
• Pass script → advanced: full server-side code as one ES module (1.5 MiB max, text only — NEVER base64-embed binaries here).
Optional promo (boolean). true lists this hatch on the public carousel even when its tier would hide it, if the hatch is active, has a public slug, and is not expired, and forces the Powered By chip on. A password still keeps it off the carousel. false unmarks Promo and returns the normal carousel and chip rules. Omit promo to leave an existing hatch unchanged, or to create one under the normal rules. To change Promo later, call convert with promo — do not hatch again.
Do not send empty strings for optional fields (hatchId, preferredSlug, apex, html, site). Omit them.
Inputs: tier (required), apex, html, kind, +14 more.
listList workspace hatchesARead-onlyIdempotentInspect
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 optional when this connector is already paired to a workspace. Requires a workspace-paired session — call whoami, then get_pairing_code with workspaceId if unidentified.
Inputs: workspaceId, sessionToken.
list_templatesList HTML templatesARead-onlyIdempotentInspect
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 url for the HTML and hatch notes — this tool does not return the file body. Add a template by opening a pull request that adds templates/<name>.md on that repo. No arguments.
Inputs: no named parameters.
lookupLookup a siteARead-onlyIdempotentInspect
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 forced on). A password still keeps a Promo hatch off the carousel. Use this to recover state across turns when the user mentions their site without giving you the hatchId. To see every hatch in a workspace, use list instead.
Inputs: slug, hatchId, tenantId.
poll_approvalPoll destructive-op approvalARead-onlyIdempotentInspect
Poll a pending Tier-2 phone approval. Returns the result once the owner approves or denies on their phone.
Inputs: approvalId (required), hatchId, tenantId.
poll_checkoutWait for paymentARead-onlyIdempotentInspect
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.
Inputs: sessionId (required).
poll_decisionPoll decision resolutionARead-onlyIdempotentInspect
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 means the await_decision timeoutSeconds deadline passed before the human submitted.
Inputs: decisionId (required), hatchId, tenantId.
poll_pairingPoll pairing completionARead-onlyIdempotentInspect
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 hatchId when known. Device claim ≠ forever billing upgrade.
Inputs: code (required), hatchId, tenantId, workspaceId.
refresh_sessionRefresh agent sessionAInspect
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.
Inputs: refreshToken (required), hatchId, tenantId, workspaceId.
rename_orgRename organization and workspaceAIdempotentInspect
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, workspaceName, orgId, orgName, plan }.
Inputs: orgName, workspaceId, sessionToken, workspaceName.
squawk_poll_accessPoll Squawk accessAInspect
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 print, log, or paste the rin_ token into chat. After it is installed, further roost traffic uses the Squawk tools (squawk, squawk_whoami, squawk_read, squawk_ack, squawk_watch, and the rest listed in SQUAWK-AGENT.md). A one-shot HTTP call is not a substitute. If this host cannot hot-add an MCP server mid-turn, write that config where this client loads MCP servers and use the Squawk tools on the next turn. Do not invent a Cursor API. Later polls return status approved and the member id, without the token and without mcpServers. Rejected and expired have no token. One approval admits this agent to that one roost.
Inputs: requestId (required), sessionToken.
squawk_request_accessRequest Squawk accessAInspect
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. Optional roostId must match the paired roost. Optional publicKey makes the later member agent_signed.
Inputs: runtime (required), displayName (required), roostId, publicKey, +1 more.
uploadUpload files to an existing siteADestructiveIdempotentInspect
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; Hatch does not schedule regenerations.
Inputs: manifest (required), policy, hatchId, tenantId, +4 more.
whoamiCheck identityARead-onlyIdempotentInspect
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.
Inputs: hatchId, tenantId, sessionToken.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Instant web publishing for AI agents. POST HTML, get a live URL. No account needed.
Hosting run by your AI agent: publish websites, apps, databases, domains and email from chat.
Host websites and data for AI agents: build pages, tables and actions, then publish.
Hosting for AI agents: your AI client deploys Docker apps to live HTTPS URLs over MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceInstant web hosting for AI agents. Publish a live site in one call, no account needed.5MIT

SnapHostofficial
AlicenseNot gradedqualityBmaintenanceSend a live, private link to a client from Claude. SnapHost publishes what your assistant builds as a shareable website with a stable URL, updates it in place, restricts viewers by email or password, rolls back bad versions, serves custom domains, and stores form and waitlist data with no backend.MIT- AlicenseNot gradedqualityBmaintenanceEnables AI agents to self-host static websites by creating projects, editing files, previewing drafts, and publishing versioned releases with custom domains and a web dashboard.MIT
- AlicenseAqualityDmaintenancePublish live web pages from AI coding agents. Instant shareable URLs for dashboards, landing pages, and reports with password protection.41MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.