This page lists the tools available through the Blueshift MCP Server, along with what each tool does and whether it supports read or write actions.
Looking for setup instructions, permissions, supported tasks, or example prompts? See The Blueshift MCP Server.
Campaigns
Tool name | Description |
get_campaign_lite | Retrieve campaign information with smart AI filtering — returns only the fields matching your intent for a lightweight, token-efficient response. |
get_campaign_statistics | Primary tool for campaign performance metrics including sends, opens, clicks, conversions, revenue, and rates. Supports filtering by channel, campaign, trigger, template, and time range. Also used for segment trends and recommended items reporting. |
list_campaigns_v2 | Search and list campaigns with filtering by name, status, type (one-time, recurring, segment triggered, event triggered, live content), author, tags, and more. Supports pagination and sorting. |
Segments
Tool name | Description |
get_segment_details | Retrieve detailed configuration and filter criteria for a specific segment, including all V2 conditions and components. |
list_segments_v1 | List all customer segments with their names, types, and metadata. |
matching_users_at_path_synchronous | Get user count at a specific V2 segment condition node — useful for debugging and verifying segment logic. |
search_users | Search and filter users by attributes, segments, or dynamic inline queries. Supports count only mode for funnel analysis, cohort sizing, and retention measurement. |
Templates
Tool name | Description |
get_email_template | Retrieve detailed information about an email template including HTML content, settings, Liquid variables, and associated campaigns. Supports expanding shared assets inline. |
list_email_templates | List email templates with optional filtering by name, tags, editor type, status, and author. |
list_push_templates | List push notification templates with filtering by name, tags, and author. |
list_sms_templates | List SMS/MMS templates with filtering by name, tags, message type, and author. |
Shared assets
Tool name | Description |
get_shared_asset | Retrieve detailed information about a specific shared asset including content, dependencies, and usage. |
get_shared_asset_templates | Get all email templates that reference a specific shared asset. |
list_shared_assets | List reusable content blocks (HTML, rich text, subject lines, visual editor blocks) with filtering by type, name, tags, and usage counts. |
Customer profiles & data
Tool name | Description |
condensed_profile | Retrieve an AI-optimized user profile with behavioral analytics, engagement patterns, and summary insights. |
Schema & data discovery
Tool name | Description |
get_customer_attribute_schema_v2 | Retrieve user attribute schema for building valid group by choices in audience insights and segmentation. Includes AI-powered smart filtering. |
get_data_studio_schema | Get the data structure and available attributes/fields for customer records. |
get_events_schema | Get detailed schema for specific event types including available properties and data types. |
get_products_schema | Get the data structure and available fields for product catalog records. |
get_schema | Return the full segmentation schema including events, user attributes, transactions, operators, and timeline helpers. Supports output masking for large payloads (50K+ tokens). |
get_user_schema | Get the data structure and available fields for customer profiles. |
Attributes & usage analytics
Tool name | Description |
attribute_usage_statistics | Get usage statistics for all attributes across users, events, products, or user base — including campaign, segment, and template usage counts. |
attribute_usages | Check specific attributes (up to 40) for usage across campaigns, segments, templates, or count of users where the attribute is set. |
get_user_insight_attributes | Return active predictive scores, predictive affinities, computed attributes, and RFM definitions available for the account. |
Product catalog
Tool name | Description |
get_product_by_sku | Get product details by SKU or product ID. |
get_product_by_uuid | Get product details by internal UUID. |
list_catalogs | List all product catalogs with metadata to identify which catalog to search. |
search_products | Search and filter catalog products by attributes like SKU, title, brand, category, price, and availability. Supports AND/OR/NOT conditions and pagination. |
Recommendations
Tool name | Description |
list_enriched_recommendation_schemes | List recommendation schemes with enriched AI-generated descriptions and metadata. |
Reports & dashboards
Tool name | Description |
get_user_insights_statistics | Query customer analytics for audience composition by attributes, predictive scores, RFM tiers, and more. |
list_metrics | List available performance metrics (sends, clicks, conversion rates, etc.) for campaign performance, user insights, recommendations, or segment trends. |
Events & transactions
Tool name | Description |
event_summary | Get event activity summary, counts, trends, and metadata for a specified time period. |
get_transaction_config | Get transaction configuration including available events for a transaction type. |
Promotions
Tool name | Description |
list_promotions_v1 | List all promotions with status, values, expiration dates, and use type (single use or multi use). |
Tags & organization
Tool name | Description |
get_tag_folder | Get detailed information about a specific tag folder including tagged resources. |
get_tag_usage_counts | Get usage counts for tags within a folder, optionally filtered by resource type. |
list_tag_folders | List tag folders used for organizing campaigns, templates, segments, and other resources. |
Image management
Tool name | Description |
list_images | List and search images in the account's image library. |
Documentation & help
Tool name | Description |
get_article | Get full article content by ID with complete documentation. |
load_domain_reference | Load domain reference documentation on demand for specialized knowledge — campaign analysis workflows, segment creation patterns, email template authoring, and more. |
search_articles | Search Blueshift's Zendesk Help Center for documentation and guides. |
