---
schema_version: "1"
id: 814df90f3d6e12cf0e758657be2a2c4fb021fb38f882638e0d6b69c07db9701f
title: Contacts
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/mce-mcp/reference/mce-mcp-tools-contacts.md
canonical_url: https://developer.salesforce.com/docs/marketing/mce-mcp/references/mce-mcp-tools/mce-mcp-tools-contacts.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 36b66208c745114d03b128c75586b3580586095f69c35d745aff02659e58d2d2
products:
  - MCP Server for Marketing Cloud Engagement
  - Marketing Cloud
---
# Contacts

The MCP server for Marketing Cloud Engagement includes several tools for managing Contact Builder. This table includes information about MCP tools that you can use to manage contacts.

**important:** Destructive tools can change or delete data. Before you use a destructive tool, ask the AI assistant to perform a trial run of the task or show you the code that it plans to execute.

| Tool Name                                       | Description                                                                                                                | Required Scopes                           |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| `sfmc_delete_contacts`                          | Delete one or more contacts and their attributes.<br><br><b>Special considerations</b>: Destructive                        | Contacts \| List and Subscribers \| Write |
| `sfmc_get_attribute_set_by_name`                | Retrieve data from an attribute set by name.                                                                               | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_attribute_set_definition`             | Retrieve an attribute set definition.                                                                                      | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_attribute_set_definitions`            | List attribute set definitions from the contact model.                                                                     | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_contact_key_by_email_address`         | Retrieve contact keys by email address.<br><br><b>Special considerations</b>: Read-only, open-world                        | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_email_subscription_status`            | Retrieve the email subscription status of a subscriber.<br><br><b>Special considerations</b>: Read-only, open-world        | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_list_subscribers`                     | Retrieve all members of a classic list.<br><br><b>Special considerations</b>: Read-only, open-world                        | Contacts \| List and Subscribers \| Read  |
| `sfmc_get_push_opt_in_status_by_subscriber_key` | Retrieve the push subscription status of a subscriber.<br><br><b>Special considerations</b>: Read-only, open-world         | Contacts \| List and Subscribers \| Read  |
| `sfmc_retrieve_contact_status`                  | Retrieve the status of a contact.<br><br><b>Special considerations</b>: Read-only, open-world                              | Contacts \| List and Subscribers \| Read  |
| `sfmc_search_attributes`                        | Search across all available attribute sets.<br><br><b>Special considerations</b>: Read-only, open-world                    | Contacts \| List and Subscribers \| Read  |
| `sfmc_update_contact_attributes`                | Update subscriber attributes in the contact profile or a Data Extension.<br><br><b>Special considerations</b>: Destructive | Contacts \| List and Subscribers \| Write |