Contacts
The MCP server for Marketing Cloud Engagement includes several tools for managing Contact Builder. This table includes information about these tools.
Destructive tools can change or delete data. Before you use a destructive tool, ask the AI assistant to perform a dry run of the task or show you the code that it plans to execute.
| Tool Name | Description | Special Considerations | Required Scopes |
|---|---|---|---|
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 a specific 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. | Read-only, open-world | Contacts | List and Subscribers | Read |
sfmc_get_email_subscription_status | Retrieve the email subscription status of a subscriber. | Read-only, open-world | Contacts | List and Subscribers | Read |
sfmc_get_list_subscribers | Retrieve all members of a classic list. | 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. | Read-only, open-world | Contacts | List and Subscribers | Read |
sfmc_retrieve_contact_status | Retrieve the status of a contact. | Read-only, open-world | Contacts | List and Subscribers | Read |
sfmc_search_attributes | Search across all available attribute sets. | Read-only, open-world | Contacts | List and Subscribers | Read |
sfmc_update_contact_attributes | Update subscriber attributes in the contact profile or a Data Extension. | Destructive | Contacts | List and Subscribers | Write |