MCP Tool: get_customer_contact

Retrieves detailed information about a specific customer contact by its unique identifier. This tool provides comprehensive contact details including personal information, associated accounts, and contact type.

Example Prompt

Get customer contact with ID CONTACT001

Input Parameters

NameTypeRequiredDescription
contactIdstringYesThe unique identifier of the customer contact to retrieve

Response Fields

Below are the fields you may see 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"
      },
      {
        "id": "ACC002",
        "name": "Acme Subsidiary"
      }
    ],
    "contactTypeId": "TYPE001",
    "contactType": "Decision Maker",
    "customFieldValues": [
      {
        "customFieldId": "CUSTOM001",
        "data": "Senior Manager",
        "metadata": {}
      },
      {
        "customFieldId": "CUSTOM002",
        "data": "Engineering",
        "metadata": {}
      }
    ],
    "metadata": {
      "department": "Engineering",
      "lastContactDate": "2025-07-24T10:00:00Z",
      "preferredContactMethod": "email",
      "timezone": "America/New_York"
    },
    "createdAt": "2025-07-24T07:19:10.258Z",
    "updatedAt": "2025-07-24T07:19:10.258Z"
  },
  "status": true,
  "message": "Customer contact retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}