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.

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.

Important

Tool Name	Description	Required Scopes
sfmc_delete_contacts	Delete one or more contacts and their attributes. Special considerations: 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. Special considerations: Read-only, open-world	Contacts | List and Subscribers | Read
sfmc_get_email_subscription_status	Retrieve the email subscription status of a subscriber. Special considerations: Read-only, open-world	Contacts | List and Subscribers | Read
sfmc_get_list_subscribers	Retrieve all members of a classic list. Special considerations: 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. Special considerations: Read-only, open-world	Contacts | List and Subscribers | Read
sfmc_retrieve_contact_status	Retrieve the status of a contact. Special considerations: Read-only, open-world	Contacts | List and Subscribers | Read
sfmc_search_attributes	Search across all available attribute sets. Special considerations: Read-only, open-world	Contacts | List and Subscribers | Read
sfmc_update_contact_attributes	Update subscriber attributes in the contact profile or a Data Extension. Special considerations: Destructive	Contacts | List and Subscribers | Write