​
MCP Tool: search_customer_contacts

Searches for customer contacts using an email address. This tool is useful for finding specific contacts when you know their email address.

​
Example Prompt

Search for customer contact with email john.smith@acme.com

​
Input Parameters

NameTypeRequiredDescription
emailstringYesSearch for a customer contact by email

​
Response Fields

Below are the fields you may see in each customer contact object in the response:
FieldTypeDescription
idstringUnique identifier of the customer contact
firstNamestringFirst name of the customer contact
lastNamestringLast name of the customer contact
emailstringEmail address of the customer contact
phoneNumberstringPhone number of the customer contact
avatarUrlstringAvatar URL of the customer contact
accountsarrayArray of associated accounts with id and name
contactTypeIdstringID of the contact type
contactTypestringName of the contact type (e.g., “Decision Maker”)
customFieldValuesarrayCustom field values for the contact
metadataobjectAdditional metadata for the contact
createdAtstring (ISO8601)Creation timestamp
updatedAtstring (ISO8601)Last update timestamp

​
Sample Response

{
  "data": [
    {
      "id": "CONTACT001",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@acme.com",
      "phoneNumber": "+1-555-0123",
      "avatarUrl": "https://example.com/avatar.jpg",
      "accounts": [
        {
          "id": "ACC001",
          "name": "Acme Corporation"
        }
      ],
      "contactTypeId": "TYPE001",
      "contactType": "Decision Maker",
      "customFieldValues": [
        {
          "customFieldId": "CUSTOM001",
          "data": "Senior Manager",
          "metadata": {}
        }
      ],
      "metadata": {
        "department": "Engineering",
        "lastContactDate": "2025-07-24T10:00:00Z"
      },
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    }
  ],
  "status": true,
  "message": "Customer contacts search completed successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}