First Deploy

This walkthrough takes you from setup to a live page in under a minute.

Prerequisites

• Based Page MCP server installed
• Authenticated with your Based Page account

Step 1: Ask Claude to deploy

Tell Claude what you want:

"Deploy a landing page for my app called Acme"

That's it — one sentence.

Step 2: Claude builds the page

Claude has several approaches:

• Blocks + styles: Picks a style preset, selects composable blocks (hero, features, footer, etc.), and assembles them with compose_page.
• Templates: Retrieves a built-in template and customizes it.
• Custom HTML: Writes a complete HTML document from scratch.

Step 3: Deploy goes live immediately

Claude calls deploy and the page is live:

Your page is live at: https://acme.based.page ID: abc123

The URL is live the moment deploy returns. Your page automatically gets a title, meta description, favicon, OG tags, and a social sharing preview image.

Step 4: Update or tear down

Update the live page:

"Update my Acme page — change the headline to 'Now in Public Beta'"

Claude calls update with the deployment ID and new content. Changes go live immediately.

Remove it entirely:

"Take down the Acme page"

Claude calls teardown (with a confirmation step) and the URL returns 404.

What Just Happened

Step	Tool	Action
2	gather_requirements	Asked targeted questions (if needed)
2	compose_page or use_template	Built the page HTML
3	deploy	Deployed to a live URL instantly
4	update / teardown	Modified or removed the page

Multi-file Deploy Example

For a site with separate CSS and JS files:

"Deploy a site with index.html, a stylesheet, and a script. Separate files."

Claude calls deploy with a files array:

Deployed successfully!

URL: https://my-site.based.page
ID: xyz789

See Multi-file Deploys for the full format.

What's Next

• Using Templates — explore built-in templates
• Custom Sites — deploy any HTML
• Multi-file Deploys — sites with separate CSS, JS, and images
• React & Frameworks — React apps with no build step
• MCP Tools Reference — full documentation of every tool