​
MCP Tool: get_all_customer_contacts

Retrieves a paginated list of all customer contacts in the organization. This tool supports filtering by account ID and contact type, along with pagination for efficient data retrieval.

​
Example Prompt

Get all customer contacts for account ACC001 with contact type "Decision Maker"

​
Input Parameters

NameTypeRequiredDescription
accountIdstringNoThe identifier of the account to find contacts for
contactTypestringNoContact type of the customer contact to find
pagenumberNoPage number for pagination (default: 1)
limitnumberNoNumber of contacts per page (default: 10)

​
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"
    },
    {
      "id": "CONTACT002",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane.doe@acme.com",
      "phoneNumber": "+1-555-0456",
      "avatarUrl": "https://example.com/jane-avatar.jpg",
      "accounts": [
        {
          "id": "ACC001",
          "name": "Acme Corporation"
        }
      ],
      "contactTypeId": "TYPE002",
      "contactType": "Technical Contact",
      "customFieldValues": [],
      "metadata": {
        "department": "IT",
        "lastContactDate": "2025-07-23T14:30:00Z"
      },
      "createdAt": "2025-07-24T08:19:10.258Z",
      "updatedAt": "2025-07-24T08:19:10.258Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  },
  "status": true,
  "message": "Customer contacts retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}