Capabilities and available tools
The Attentive MCP’s standard tool catalog includes a maximum of 83 tools. Forty-three can be available in read-only mode, while 40 require a write-enabled connection.
The tables classify 42 tools as Read and 41 as Write. switch_company is the exception to the write-enabled requirement: it changes the company selected for the session and remains available in read-only mode. list_segment_subscribers is a Read tool and can return subscriber contact information.
The exact tools visible in a session may be fewer than 83 because availability also depends on the selected company, user permissions, enabled Attentive products, and connection configuration.
The descriptions below summarize each tool for readability. To retrieve the full tool descriptions available through your connection, ask your AI application:
Use the Attentive MCP to list all available tools and show their full descriptions.
Capability summary
| Capability | What it covers |
|---|---|
| Account and user | View the connected user and company; find and switch between accessible companies. |
| Reporting and metrics | Discover available metrics and query performance over a specified date range. |
| Campaigns and messages | Create and edit campaigns and messages across supported channels; configure audiences, schedules, Send Time AI, and A/B tests where available; schedule, pause, and resume sends. |
| Journeys | Inspect journeys; create and edit drafts, steps, messages, and branches; publish, pause, resume, and archive journeys. |
| Segments | Create and manage segments; retrieve audience counts and limited subscriber details. |
| Email templates | Read, create, and update email templates. |
| Creative | Inspect creatives and their configuration, status, and display rules. |
| Brand kit | Retrieve brand assets and settings, upload supported images, and update email branding styles. |
| Copy generation | Generate marketing copy from a prompt. |
| Data Flow | Inspect connected sources, data ingestion health, accepted and rejected record metrics, and record status details. Requires Data Flow access. |
Account and user
| Tool | Access | Description |
|---|---|---|
get_user | Read | Get the signed-in user and the company selected for the current session. |
list_user_companies | Read | List or search the companies your account can access. |
switch_company | Write | Change the selected company for subsequent tool calls. Available in read-only sessions. |
Reporting and metrics
| Tool | Access | Description |
|---|---|---|
list_metrics | Read | Discover available metrics, their definitions, and supported breakdowns. Use before query_metrics. |
query_metrics | Read | Query metrics over a date range, with aggregate totals and optional breakdowns by time or dimension. |
Campaigns
| Tool | Access | Description |
|---|---|---|
list_campaigns | Read | List campaigns with name, status, and recurring-campaign filters, plus pagination. |
get_campaign | Read | Get campaign details, including its message groups and messages. |
get_campaign_metrics | Read | Get SMS, email, or push performance over a date range, with campaign, message-group, or variant breakdowns. Defaults to the last 30 days. |
get_campaign_message_group | Read | Get a message group’s status, schedule, and A/B test variants. |
create_campaign | Write | Create an SMS, RCS, email, or push campaign shell. Optionally populate an email campaign from a template. |
update_campaign | Write | Rename a campaign or reorder its message groups. Recurring campaign groups cannot be reordered. |
delete_campaign | Write | Delete a campaign by ID. |
create_campaign_message_group | Write | Add a draft message group, including content or send-time A/B tests. Does not send messages. Unavailable for recurring campaigns. |
create_campaign_message | Write | Add an A/B test variant to a message group, including supported email subject-line, design, and Send Time AI variants. |
delete_campaign_message | Write | Remove a message or A/B test variant. Where supported, removing a variant can return a draft test to a one-time message group. |
update_campaign_message_group | Write | Update a group’s name, audience, smart sending, schedule, or test settings, including Send Time AI. Recurring groups allow only name and audience changes. |
delete_campaign_message_group | Write | Delete a message group from a campaign. Unavailable for recurring campaigns. |
schedule_campaign_send | Write | Schedule a fully configured campaign to send. Also resumes any paused message groups in the campaign. |
pause_campaign_send | Write | Pause campaign sending. Pausing a specific message group also pauses subsequent groups. |
resume_campaign_send | Write | Resume sending for a paused campaign. |
Messages
These tools work with campaign and journey messages. For journey edits, prefer update_journey_message to target the draft revision.
| Tool | Access | Description |
|---|---|---|
get_message | Read | Get a campaign or journey message and its content. |
create_short_link | Write | Create a tracked short link for a message. Existing short links cannot be edited; create a replacement instead. |
update_sms_message | Write | Update an SMS/MMS message’s name, body, media, and short links, including A/B test variants. |
update_push_message | Write | Update a push message’s name, title, description, and open action. |
update_rcs_message | Write | Update RCS text, cards, carousels, suggestion chips, and SMS/MMS fallback content. |
update_email_message | Write | Update an email’s subject, preheader, sender information, and body using a template, editor JSON, or HTML. |
Journeys
Journey content and structure edits use a draft revision. Publishing applies those changes to the live journey.
| Tool | Access | Description |
|---|---|---|
list_journeys | Read | List journey summaries with pagination and filters for status, trigger, and default journeys. |
get_journey | Read | Get a journey’s details, including its trigger, tags, schedules, and category. |
get_journey_branch | Read | Inspect a branch’s conditions and child steps. Use before editing to preserve existing branches and steps. |
get_journey_graph | Read | Get the journey’s steps and message content. Returns the draft revision by default. |
get_journey_configuration | Read | Discover the step types, branching dimensions, and configuration options allowed for a journey. |
get_journey_message | Read | Get journey message content by message ID, including SMS/RCS body text or email subject and preheader. |
get_revision_settings | Read | Read revision settings, including subscriber entry frequency. Defaults to the draft revision. |
list_journey_templates | Read | List available journey templates, with language and channel filters. |
list_journey_triggers | Read | List existing journey triggers and custom events that can be used to create a journey. |
list_user_attributes | Read | Find custom user attributes, their IDs, and allowed values for journey steps and conditions. |
list_product_attribute_values | Read | Find actual product attribute values, such as categories, tags, colors, and sizes, for product-based branches. |
create_journey | Write | Create a journey from a template, existing trigger, or custom event. |
create_journey_draft | Write | Create an editable draft revision of a published journey. Retrieve the new graph before editing because node and message IDs change. |
add_journey_node | Write | Add a draft step, such as a delay, message, branch, experiment, or attribute update. |
update_journey_node | Write | Edit a draft step’s settings, such as delay duration, message content, or experiment configuration. |
move_journey_node | Write | Move a step to a different position in the draft journey. |
delete_journey_node | Write | Remove a step from the draft journey. |
update_journey_branch | Write | Edit branch conditions. Rejects changes that would leave existing child steps disconnected. |
update_journey_message | Write | Edit message content in the journey’s draft revision. Published content remains unchanged until the draft is published. |
update_journey_metadata | Write | Update a journey’s name, description, or category without changing its graph. |
update_revision_settings | Write | Set how often a subscriber can enter the journey. Applies to the draft revision. |
publish_journey | Write | Apply the draft revision and make the journey live, starting subscriber enrollment and sending. |
pause_journey | Write | Pause a live journey. Subscribers already in progress can finish by default; optionally remove them immediately. |
resume_journey | Write | Reactivate a paused journey so enrollment and sending resume. |
archive_journey | Write | Archive a draft or paused journey while retaining its performance history. Live journeys must be paused first. |
unarchive_journey | Write | Restore an archived journey to its previous state. |
delete_journey | Write | Permanently delete a journey that has never been published. Published journeys must be archived instead. |
Segments
| Tool | Access | Description |
|---|---|---|
list_segments | Read | List or search segments, with filtering and pagination. |
get_segment | Read | Get detailed information about a segment. |
get_segment_counts | Read | Get subscriber counts by channel, including fatigue information. |
list_segment_subscribers | Read | Retrieve up to 20 subscribers from a segment, including contact information. |
create_segment | Write | Create a segment from a search definition. |
update_segment | Write | Update an existing segment. |
delete_segment | Write | Delete a segment. |
Email templates
| Tool | Access | Description |
|---|---|---|
list_email_templates | Read | List email templates with name and type filters, pagination, and preview links. |
get_email_template | Read | Get a template’s details and preview links, with optional full editor JSON for editing. |
create_email_template | Write | Create an email template from HTML or editor JSON, including content adapted from an existing template. |
update_email_template | Write | Update a template’s name or content using HTML or editor JSON. |
Creative
| Tool | Access | Description |
|---|---|---|
list_creatives | Read | List creatives with search, status, and type filters, plus pagination. |
get_creative | Read | Get a creative’s status, type, template configuration, display rules, and related resources. |
Brand kit
| Tool | Access | Description |
|---|---|---|
list_brand_assets | Read | List the company’s brand assets, including images and folders. |
add_brand_asset | Write | Upload a PNG, JPEG, or GIF of up to 5 MB from a supported public Shopify CDN or Google Drive link. Each call creates a new asset; check for an existing upload before retrying. |
get_brand_voice_settings | Read | Get brand voice preferences such as tone, excluded words, emoji use, capitalization, and target copy length. |
get_email_branding_styles | Read | Get email branding styles for text, buttons, images, layout elements, and template defaults. |
list_email_brand_kit_compatible_fonts | Read | Get the company’s configured brand fonts and font weights for email styling. |
update_email_branding_styles | Write | Replace the email branding styles. Read the current styles first and preserve any values you do not intend to change. |
Copy generation
| Tool | Access | Description |
|---|---|---|
generate_copy | Write | Generate marketing copy from a prompt, with options to adjust tone, length, urgency, and emoji use. |
Data Flow
These tools require Data Flow access.
| Tool | Access | Description |
|---|---|---|
get_data_flow_health_summary | Read | Get overall data ingestion health and identify connected sources that need attention. |
get_data_flow_metrics_summary | Read | Get totals for received, accepted, and rejected records, plus rejection rates, over a date range. |
get_data_flow_metrics_chart | Read | Get Data Flow metrics over time, with connected-source filtering options. |
list_data_flow_connected_sources | Read | List connected sources with their health, installation status, and ingestion metrics. |
get_data_flow_connected_source | Read | Get a connected source’s details, origins, installation status, and active scopes. |
get_data_flow_connected_source_metrics_summary | Read | Get received, accepted, and rejected record totals and rejection rates for one source. |
get_data_flow_connected_source_metrics_chart | Read | Get a source’s metrics over time, optionally filtered to one origin. |
list_data_flow_connected_source_origins | Read | List a source’s origins with their health and ingestion metrics. |
list_data_flow_connected_source_records | Read | List record metadata with filtering and pagination. Excludes contact information, raw payloads, headers, and response bodies. |
get_data_flow_record | Read | Inspect one record’s status and routing details. Excludes contact information, raw payloads, headers, and response bodies. |
Monthly release notes
Explore the latest improvements to Attentive MCP tools. Availability depends on your account access and enabled Attentive products.
October 2026
This month expanded campaign creation with RCS, added testing and send-time options, and made it easier to upload brand images and explore email performance.
- Create richer mobile campaigns with RCS. Build RCS campaigns and message variations directly from your AI application, bringing rich messaging into your campaign creation workflow.
- Expand campaign testing and send-time options. Configure additional A/B tests, review message-variant performance, and use Send Time AI for eligible campaigns.
- Bring your images into Attentive. Upload images from supported links to your Brand Asset Library for use in campaign content.
- Explore email campaign performance. Review email results alongside SMS reporting, with breakdowns by campaign, message group, or message variation.
September 2026
This month made it easier to review your audience through a read-only connection.
- Review segment members in read-only mode. Inspect segment membership without enabling write actions, subject to your account access.
August 2026
The Attentive MCP beta expanded access to tools for building campaigns, creating content, and understanding performance through your AI application.
- Build and refine journeys. Create journeys and edit their steps, messages, and branching. Explore available conditions and product attributes to tailor each customer’s path.
- Edit messages across channels. Update SMS, email, push, and RCS messages, including messages in journey drafts. RCS editing supports rich cards, carousels, buttons, suggested replies, and fallback content.
- Create reusable, on-brand content. Create and edit email templates, work with available email branding settings, and generate campaign copy.
- Explore performance more fully. Discover available metrics and query account performance. Retrieve additional pages of campaign results to analyze larger datasets.
Updated 5 days ago
Did this page help you?