set_pin
Set or replace the Signal Registration Lock PIN so re-registering your phone number elsewhere requires it. Works on primary devices only; remove_pin disables it.
Instructions
Set or replace the Registration Lock PIN on your Signal account, so re-registering your phone number elsewhere (e.g. after a SIM swap) requires this PIN. pin (string, required): the new PIN, numeric, e.g. '123456'. Primary device only: on a linked signal-cli setup it fails with 'This command doesn't work on linked devices'. Affects the real account immediately; calling again with a new pin replaces the old one. If you forget it, re-registration is blocked until the lock lapses after 7 days of inactivity. Returns {status: 'PIN set'}. Use remove_pin to turn the lock off; finish_change_number needs this PIN when changing numbers.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pin": "<pin>"
},
"name": "set_pin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pin | Yes | 4–20 digit numeric PIN (e.g. '123456') |