MCP Tools Reference

Based Page exposes tools through the Model Context Protocol (MCP). Claude and Cursor call these tools automatically based on your natural-language requests.

Authentication

Tool	Description
login	Sign in via browser-based email verification
logout	Sign out and clear stored credentials
whoami	Show the currently authenticated user

Requirements

Tool	Description
gather_requirements	Get structured questions to ask before building a page

Composition

Tool	Description
list_blocks	List available composable blocks for building pages
list_styles	List available style presets (colors, fonts, spacing)
compose_page	Assemble a full HTML page from blocks and a style preset
list_frameworks	List available CDN frameworks and usage patterns

Templates

Tool	Description
list_templates	List all available deployment templates
use_template	Get the full HTML source of a template

Deployments

Tool	Description
deploy	Deploy HTML or files to a live URL instantly
update	Update an existing deployment with new content
teardown	Delete a deployment permanently
get_status	Get deployment status, URL, and metadata
list_deploys	List all active deployments

Deployment Flow

gather_requirements → compose_page / use_template / custom HTML → deploy (live URL)

1. Gather requirements — Claude asks structured questions to understand what you want (optional if you've provided enough detail)
2. Build the page — using blocks + styles (compose_page), templates, or custom HTML
3. Deploy — deploy returns a live URL at {slug}.based.page immediately

Every deployed page automatically gets title, description, favicon, OG tags, and a social sharing preview image generated from your metadata.

MCP Annotations

Each tool declares annotations that describe its behavior:

Annotation	Meaning
readOnlyHint	Does not modify any state
destructiveHint	Permanently deletes resources
openWorldHint	Interacts with external services