Add or Rename a Contact
upsert_contactAdd or rename a contact for a phone number in the local encrypted contact book; explicit confirmation is required, and adding does not authorize SMS recipients.
Instructions
Add a contact or rename the contact that owns this number in the local encrypted contact book. A number you add here does not become an allowed send_sms recipient until the user saves it themselves. Requires confirm: true.
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": {
"phone": "<phone>",
"name": "<name>",
"confirm": "<confirm>"
},
"name": "upsert_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name to show for this number. | |
| note | No | An optional note kept with the contact. | |
| phone | Yes | The contact's number, international (+353…) or national. | |
| confirm | Yes | Must be true: the user explicitly asked for this change. |