Capabilities and available tools

The Attentive MCP exposes a maximum of 74 tools. Thirty-four are available in read-only mode, while 40 require a write-enabled connection.

Of the 40 write-enabled tools, 39 can create, update, delete, schedule, or otherwise change Attentive data. list_segment_subscribers is the exception: it only retrieves data, but it requires a write-enabled connection because it returns subscriber contact information.

The exact tools visible in a session may be fewer than 74 because availability also depends on the selected company, user permissions, and enabled Attentive products.

Capability summary

CapabilityWhat it covers
Account and UserRetrieve user and company information; switch between companies.
Reporting and metricsPull campaign, journey, and segment performance data; retrieve account metrics for analysis alongside other data sources.
Campaigns and messagesRead, create, and edit campaign drafts, message groups, and messages across SMS, RCS, email, and push; schedule, pause, and resume sends.
JourneysRead journey structure and configuration; create journeys and edit nodes and branches.
SegmentsList, create, update, and delete segments; retrieve audience counts; and retrieve limited subscriber details through a write-enabled connection.
Templates and creativeRead and create email templates; read creatives, brand kit, and brand voice settings.

Account and user

ToolAccessDescription
get_userReadGet the Attentive user and company associated with the current session.
greetReadReturn a personalized greeting and confirm which Attentive account is authenticated.
list_user_companiesReadList the companies the current user can access, with optional search.
switch_companyReadSet the active company for the current session.

Reporting and metrics

ToolAccessDescription
list_metricsReadList the analytics metrics available for the company from the metrics catalog. Call before query_metrics.
query_metricsReadQuery analytics metrics over a date range. Returns aggregate totals and optional time or dimension breakdowns.

Campaign-level performance is also available through get_campaign_metrics (see Campaigns).

Campaigns

ToolAccessDescription
list_campaignsReadList campaigns with optional name filter, status filter, and pagination.
get_campaignReadGet detailed campaign info by ID, including message groups and messages.
get_campaign_metricsReadGet campaign performance metrics over a date range (defaults to last 30 days).
get_campaign_message_groupReadGet a message group by ID, including status, schedule, and A/B test variants.
create_campaignWriteCreate a campaign shell (SMS, email, or push). Optionally pre-populate an email campaign from a template.
update_campaignWriteUpdate a campaign's name or reorder its message groups.
delete_campaignWriteDelete a campaign by ID.
create_campaign_message_groupWriteAdd a new message group to an existing campaign.
create_campaign_messageWriteAdd an SMS, RCS, or push message to an existing message group. When a message group contains multiple messages, they act as A/B test variants.
delete_campaign_messageWriteRemove a message or A/B test variant from a campaign message group.
update_campaign_message_groupWriteUpdate a message group's name, scheduling, smart sending, audience segments, or experiment settings.
delete_campaign_message_groupWriteDelete a message group from a campaign.
schedule_campaign_sendWriteSchedule a fully configured campaign to send.
pause_campaign_sendWritePause a campaign send.
resume_campaign_sendWriteResume a paused campaign send.

Messages

Message-level tools work across both campaigns and journeys — the same tool reads or edits a message regardless of which one it belongs to.

ToolAccessDescription
get_messageReadGet a message by ID, including its content. Works for campaign and journey messages alike.
create_short_linkWriteCreate a short link to use in a message body.
update_sms_messageWriteUpdate an SMS/MMS message's name, body, media, and short links, including A/B test variants.
update_push_messageWriteUpdate a push message's name, title, description, and open action, including A/B test variants.
update_rcs_messageWriteUpdate an RCS message's name, content, suggestion chips, and SMS/MMS fallback, including A/B test variants.
update_email_messageWriteUpdate an email message's subject, preheader, sender info, and body content.

Journeys

ToolAccessDescription
list_journeysReadList journeys for the company (paginated, summarized).
get_journeyReadGet detailed information for a single journey, including trigger, tags, and schedules.
get_journey_branchReadRead a branching node's current dimension, conditions, labels, node IDs, child steps, and selection schemas. Call this before update_journey_branch to avoid dropping existing branches or steps.
get_journey_graphReadGet a readable view of a journey's graph structure, including steps and message content.
get_journey_configurationReadRead which node types can be added, copied, or moved within a journey.
get_journey_messageReadGet the content of a journey message by ID.
get_revision_settingsReadRead a journey revision's settings, including entry frequency.
list_journey_templatesReadList journey templates available when creating a new journey.
list_journey_triggersReadList available journey triggers for creating a new journey.
list_user_attributesReadList the company's custom user attributes and allowed values (used to configure nodes and branches).
list_product_attribute_valuesReadList the available values for a product attribute, such as names, categories, tags, colors, brands, sizes, collections, options, and sales channels. Use this before configuring product-based journey branches.
create_journeyWriteCreate a new journey from a template, a trigger, or another source.
create_journey_draftWriteCreate a new draft revision for a published journey by cloning the current revision.
add_journey_nodeWriteAdd a node to the journey graph (delay, send message, send email, branch, experiment, and more).
update_journey_nodeWriteUpdate a node's parameters (delay durations, message content, branch conditions, experiment settings).
move_journey_nodeWriteMove a node to a new position in the journey graph.
delete_journey_nodeWriteRemove a node from the journey graph.
update_journey_branchWriteConfigure a branching node's conditions and branch expressions.
update_journey_messageWriteUpdate the content of a message on a journey.
update_journey_metadataWriteUpdate a journey's name, description, and category.
update_revision_settingsWriteConfigure a journey revision's entry frequency.
publish_journeyWritePublish a journey to make it live and start enrolling subscribers.
pause_journeyWritePause a live journey so it stops enrolling and sending.
resume_journeyWriteResume a previously paused journey.
archive_journeyWriteArchive an inactive (draft or paused) journey.
unarchive_journeyWriteRestore a previously archived journey.
delete_journeyWritePermanently delete an unpublished (draft) journey. This cannot be undone.

Segments

ToolAccessDescription
list_segmentsReadList segments with optional filtering, search, sorting, and cursor pagination. Returns both a GraphQL node ID and an internal segment ID.
get_segmentReadGet detailed segment information using the GraphQL node ID returned as id by list_segments.
get_segment_countsReadGet SMS and email subscriber counts for one segment using its GraphQL node ID. Results include active subscriber counts and counts excluding fatigued subscribers.
list_segment_subscribersWrite-enabled sensitive readReturn up to 20 subscribers from a segment. Use the internalId returned by list_segments. This tool requires ?readOnly=false and confirmation because it returns subscriber contact information, but it does not modify data.
create_segmentWriteCreate a dynamic segment from a required searchDefinition.
update_segmentWriteUpdate a dynamic segment using its GraphQL node ID. Name, description, metadata, and searchDefinition are optional. Omitting searchDefinition preserves the existing conditions.
delete_segmentWriteDelete a segment using its GraphQL node ID. A segment cannot be deleted while it is used by a campaign, journey, or integration.

Email templates

ToolAccessDescription
list_email_templatesReadList email templates for the current company, with filtering and pagination.
get_email_templateReadGet details of an email template, including name, subject, and content.
create_email_templateWriteCreate a new email template from raw HTML or editor JSON.
update_email_templateWriteUpdate an existing email template's name and/or content.

Creative

ToolAccessDescription
list_creativesReadList creatives with optional search, status, and type filters.
get_creativeReadGet detailed creative info by ID, including status, type, and display rules.

Brand kit

ToolAccessDescription
list_brand_assetsReadList brand assets (images, folders) for a company.
add_brand_assetReadReturn a link to the Attentive UI where you can upload and manage brand assets.
get_brand_voice_settingsReadGet the company's AI brand voice settings (tone, excluded words, emoji usage, and more).
get_email_branding_stylesReadGet the company's email brand kit styles (buttons, headings, paragraphs, and more).
list_email_brand_kit_compatible_fontsReadList the company's selected brand fonts for use in email brand styles.
update_email_branding_stylesWriteUpdate the company's email brand kit styles.

Copy assistant

ToolAccessDescription
generate_copyWriteGenerate AI-powered text suggestions for marketing messages from a prompt.

Did this page help you?