URL: /mcp/tools/contacts --- title: Contact tools description: Manage org-wide contacts and assign them to domains as registrant, admin, technical, or billing. --- A contact is a reusable address record. Each domain has up to four roles: `registrant`, `admin`, `technical`, `billing`. The same contact can fill more than one role. ## `list_contacts` Required scope: `contacts:read`. Organisation OID from `whoami`. Returns the org's contacts. ## `create_contact` Required scope: `contacts:write`. Caller must be `owner` or `admin`. ISO-2 country code (e.g. `AU`). International format (e.g. `+61.412345678`). Optional company name. Optional second address line. ## `update_contact` Replaces an entire contact record — supply every field, not just changed ones. Required scope: `contacts:write`. Caller must be `owner` or `admin`. Contact UUID. All other params match `create_contact`. ## `delete_contact` Required scope: `contacts:write`. Caller must be `owner` or `admin`. Returns `{ "deleted": true, "contact_id": "..." }`. ## `get_domain_contacts` Required scope: `contacts:read`. Returns up to four entries — one per assigned role. Missing roles aren't in the list. ## `set_domain_contact` Required scope: `contacts:write`. Caller must be `owner` or `admin`. One of `registrant`, `admin`, `technical`, `billing`. UUID from `list_contacts`. The change is local. The next sync cycle pushes it to the registrar. ## `unset_domain_contact` Required scope: `contacts:write`. Caller must be `owner` or `admin`.