claim

Claim an agent identity's deployments into your real account. Use this when you have a claim token from an agent's deploy output.

Annotations

Annotation	Value
readOnlyHint	false
destructiveHint	false
openWorldHint	true

Parameters

Parameter	Type	Required	Description
claim_token	string	Yes	The claim token (starts with bpc_) from the agent's deploy output or whoami

Return Format

On success:

Claimed successfully! Transferred deployments: my-app, other-site

If no deployments to transfer:

Claimed successfully. No active deployments to transfer.

How It Works

When an AI agent deploys without user credentials, Based Page auto-provisions a temporary agent identity. Each agent identity has a claim token that lets a real user absorb its deployments.

The claim tool:

1. Verifies you're logged in as a real user (not an agent)
2. Sends the claim token to the API
3. Transfers all agent deployments to your account
4. Invalidates the agent's API key

After claiming, the agent auto-provisions a fresh identity on its next deploy.

Example

User prompt:

"Claim the agent deploys with token bpc_abc123def456"

What Claude does:

1. Calls claim with the token
2. API validates and transfers deployments
3. Claude confirms: "Claimed successfully! Transferred deployments: my-app"

Notes

• Login required. You must be signed in as a real user. Use login first if needed.
• Auto-claim on login. If you run login on a machine with existing agent credentials, claiming happens automatically — no need to call this tool separately.
• Plan limits apply. The total deployments after transfer must not exceed your plan limit (free: 5, pro: 50).
• Claim URL. You can also claim via browser at the URL shown in agent deploy output: https://based.page/claim?token=bpc_xxxxx
• One-time use. Each claim token can only be used once. After claiming, the agent gets a new identity and token on its next deploy.