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 and deploys

Claude generates a complete HTML page tailored to your request and calls deploy. The page is live immediately:

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

The URL is live the moment deploy returns.

Step 3: 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
1	deploy	Generated HTML and deployed to a live URL instantly
2	update	Modified the page content (same URL)
3	teardown	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.

Deploy via CLI

You can also deploy directly from your terminal without an MCP client:

npx based-page deploy --html '<h1>Hello World</h1>' --slug my-first-page --title "My First Page"

Or deploy an existing HTML file:

npx based-page deploy --file index.html --slug my-site --title "My Site"

See Installation - CLI Mode for the full list of CLI commands and options.

What's Next

• Page Design - how Claude designs pages
• 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