Start a token sign-in (gate)
start_token_signinUse when you (an agent) want to sign in to a site or API gated by TOKENLOCK, using a Bitcoin name or token your own wallet holds (for example a name bought with buy_name). Free; nothing is paid or sent. Step 1 of 2: returns challenge_id and the exact message to sign. For a TOKENLOCK site, pass its publishable site_key (pk_…, public on its sign-in page) and the site origin; the tokens it accepts come from the site. Without a site_key you can name the assets (or any_name) to get a general pass. Then sign message with your wallet (BIP-322 or legacy sign-message) and call finish_token_signin within 10 minutes. Counts as a sign-in on the site's plan only when it passes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_token_signin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assets | No | Without site_key: tokens or names that unlock (any one is enough). | |
| origin | No | The gated site's origin, e.g. https://example.com. Required with site_key. | |
| any_name | No | Without site_key: accept any vanity name on Bitcoin. | |
| site_key | No | The site's publishable key pk_… (from its sign-in page). Omit for a general pass. | |
| pass_ttl_seconds | No | How long the pass lasts (default 900). |