Skip to content

Deploy Tools

Starts a new deploy. Returns a job_id that Claude uses to track progress.

Deploy the site.

Claude calls this automatically at the end of most tasks. You can also say “deploy” at any time.

Polls the deploy job for status. Claude calls this in a loop until the deploy completes or fails.

Possible statuses:

  • queued — waiting to start
  • running — build in progress (~30–90 seconds for most sites)
  • succeeded — deployed successfully
  • failed — build error (Claude will report what went wrong)

Returns a signed preview URL for the current site state — without deploying. Use this to review changes before they go live.

Show me a preview of the site.

The preview link is valid for 24 hours and reflects the current draft state, not the last deploy.

  1. The portal materialises all site content into a temporary directory
  2. Astro builds the static site from that content (~30–90s)
  3. The output is uploaded to Cloudflare Pages
  4. The Cloudflare CDN serves the new version globally within seconds

Only status: "published" pages are included in the build. Draft and review pages are excluded.

After a successful deploy, Claude reports the site URL:

  • Typeroll subdomain: https://your-site.sites.typeroll.com
  • Custom domain (if configured): https://yourdomain.com

Both URLs update with every deploy.