> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get customer contact

> MCP tool to retrieve a specific customer contact by ID from the Thena platform.

import Admonition from '@theme/Admonition';

### 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.

<Admonition type="note">
  You must provide the contact ID to retrieve the specific customer contact details.
</Admonition>

### Example prompt

```prompt theme={null}
Get customer contact with ID CONTACT001
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_customer\_contact</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name      | Type   | Required | Description                                               |
| --------- | ------ | -------- | --------------------------------------------------------- |
| contactId | string | Yes      | The unique identifier of the customer contact to retrieve |

### Response fields

Below are the fields you may see in the response:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>id</td><td>string</td><td>Unique identifier of the customer contact</td></tr>
    <tr><td>firstName</td><td>string</td><td>First name of the customer contact</td></tr>
    <tr><td>lastName</td><td>string</td><td>Last name of the customer contact</td></tr>
    <tr><td>email</td><td>string</td><td>Email address of the customer contact</td></tr>
    <tr><td>phoneNumber</td><td>string</td><td>Phone number of the customer contact</td></tr>
    <tr><td>avatarUrl</td><td>string</td><td>Avatar URL of the customer contact</td></tr>
    <tr><td>accounts</td><td>array</td><td>Array of associated accounts with id and name</td></tr>
    <tr><td>contactTypeId</td><td>string</td><td>ID of the contact type</td></tr>
    <tr><td>contactType</td><td>string</td><td>Name of the contact type (e.g., "Decision Maker")</td></tr>
    <tr><td>customFieldValues</td><td>array</td><td>Custom field values for the contact</td></tr>
    <tr><td>metadata</td><td>object</td><td>Additional metadata for the contact</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>Creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>Last update timestamp</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "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"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***