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