login

Sign in to Based Page via browser-based email verification. Opens your default browser to complete authentication.

Annotations

Annotation	Value
readOnlyHint	false
destructiveHint	false
openWorldHint	true

Parameters

None.

Return Format

On success:

Logged in successfully as user@example.com. You can now use deploy, update, and other tools.

If already authenticated:

Already logged in as user@example.com. Use the logout tool first if you want to switch accounts.

How It Works

When invoked, the tool launches your system browser to the Based Page authentication page. You enter your email and complete one-time-password verification. Claude confirms successful login with the authenticated email address.

Example

User prompt:

"Log me in to Based Page"

What Claude does:

1. Calls login (no parameters).
2. Your browser opens to the Based Page sign-in page.
3. You enter your email and verify the OTP.
4. Claude confirms: "Logged in as you@example.com"

Agent Claim on Login

If the machine has existing agent credentials (from a previous headless deploy), calling login will:

1. Complete browser login as normal
2. Automatically claim the agent's deployments into your new account
3. Report which deployments were transferred

Logged in as you@example.com. Claimed agent deploys: my-app, other-site

Notes

• Deploy doesn't need login. Deploying without credentials auto-provisions an agent identity instantly. The login tool is for when you want a permanent account.
• Headless setups. In SSH or containers, use BASED_PAGE_API_KEY for a real account, or let agent auto-provisioning handle it.
• Credentials persist. Stored credentials persist locally across sessions until the logout tool is called.