Authentication

All deployments require authentication. Based Page uses email-based OTP — no password to remember.

First-Time Login

1. Ask Claude to log in — say "Log me in to Based Page"
2. Browser opens — Based Page opens your default browser to the sign-in page
3. Enter your email — type your email address
4. Verify — enter the one-time code sent to your inbox
5. Done — credentials are saved locally for future requests

The entire flow takes about 15 seconds.

Claude calls the login tool automatically, which opens your browser.

Auto-Provisioned Agent Identity

If you deploy without logging in first, Based Page automatically provisions a temporary agent identity. No browser, no email, no friction. The deploy just works.

This happens for both headless AI agents and regular users who haven't signed in yet:

1. Agent identity is auto-created with free plan limits (5 deploys)
2. An API key and claim token are generated
3. Credentials are saved to ~/.based-page/credentials.json
4. Deploy goes live immediately

Agent deploys can be claimed by a real user later, transferring them to a permanent account. See Claiming Agent Deploys.

Claiming Agent Deploys

When an AI agent deploys on your behalf, you can transfer those deployments to your real account.

Via the claim MCP tool

If you have the claim token (shown in deploy output and whoami):

"Claim this agent's deploys with token bpc_xxxxx"

Via the login tool (same machine)

If you're on the same machine where the agent deployed, just log in:

"Log me in to Based Page"

The login tool detects existing agent credentials, completes browser login, and automatically claims the agent's deploys.

Via the claim URL (any machine)

Agent deploy output includes a claim URL like:

https://based.page/claim?token=bpc_xxxxx

Visit this URL, sign in with your email, and the agent's deployments transfer to your account.

What happens after claiming

• All agent deployments transfer to your account (URLs stay the same)
• The agent's API key is invalidated
• If the agent deploys again, it gets a fresh identity automatically
• You can claim multiple agent identities (up to your plan limit)

Credentials Storage

After login, your credentials are saved to:

~/.based-page/credentials.json

This file contains your email address and an API key. Subsequent requests authenticate automatically without re-prompting.

WARNING

credentials.json contains your API key. Do not commit it to version control or share it. The default location (~/.based-page/) is in your home directory, outside any project.

Environment Variable

For CI/CD pipelines or headless environments where a browser isn't available, set an API key directly:

export BASED_PAGE_API_KEY=bp_your_api_key_here

When this variable is set, Based Page skips the browser login and authenticates directly with the provided key. API keys can be generated from the Based Page dashboard.

Check Auth Status

Ask Claude:

"Who am I signed in as on Based Page?"

This calls the whoami tool and returns your email address (or agent identity info).

Logout

Ask Claude:

"Log me out of Based Page"

This calls the logout tool, deleting your stored credentials. You'll need to sign in again for future deployments.

Next Step

Ready to go — continue to First Deploy to create your first live page.