Tool
upsert_contact
Add or update a contact
Idempotent
SurfacesChat agentMCPRegister a person in the contacts registry (add-or-update by email). Use to save someone you found or were asked to track. Provide `sourceUrl` + `confidence` when the contact came from web research. Auto-commits (reversible via undo).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
email | string | yes | The contact's email (the unique key). |
name | one of | no | Display name. |
▸expand name
| |||
vip | boolean | no | Mark as VIP. |
labels | string[] | no | Label names to apply (created if new). |
sourceUrl | one of | no | Where this contact came from (e.g. a web-research URL). |
▸expand sourceUrl
| |||
confidence | integer | no | 0–100 confidence in the data (for researched contacts). |
lifecycle | prospectactiveinvalid | no | Override the lifecycle (default: prospect for agent adds). |
Example
json
{
"email": "ada@example.com"
}