Skip to main content

Blueshift MCP Server Tools (Beta)

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

De­scrip­tion

get_​campaign_​lite
🔍 Read

Retrieve campaign in­for­ma­tion with smart AI filtering — returns only the fields matching your intent for a lightweight, token-efficient response.

get_​campaign_​statistics
🔍 Read

Primary tool for campaign per­for­mance metrics including sends, opens, clicks, con­ver­sions, revenue, and rates. Supports filtering by channel, campaign, trigger, template, and time range. Also used for segment trends and rec­om­mend­ed items reporting.

list_​campaigns_​v2
🔍 Read

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

De­scrip­tion

get_​segment_​details
🔍 Read

Retrieve detailed con­fig­u­ra­tion and filter criteria for a specific segment, including all V2 conditions and components.

list_​segments_​v1
🔍 Read

List all customer segments with their names, types, and metadata.

matching_​users_​at_​path_​synchronous
🔍 Read

Get user count at a specific V2 segment condition node — useful for debugging and verifying segment logic.

search_users
🔍 Read

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

De­scrip­tion

get_​email_​template
🔍 Read

Retrieve detailed in­for­ma­tion about an email template including HTML content, settings, Liquid variables, and associated campaigns. Supports expanding shared assets inline.

list_​email_​templates
🔍 Read

List email templates with optional filtering by name, tags, editor type, status, and author.

list_​push_​templates
🔍 Read

List push no­ti­fi­ca­tion templates with filtering by name, tags, and author.

list_​sms_​templates
🔍 Read

List SMS/MMS templates with filtering by name, tags, message type, and author.

Shared assets

Tool name

De­scrip­tion

get_​shared_​asset
🔍 Read

Retrieve detailed in­for­ma­tion about a specific shared asset including content, dependencies, and usage.

get_​shared_​asset_​templates
🔍 Read

Get all email templates that reference a specific shared asset.

list_​shared_​assets
🔍 Read

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

De­scrip­tion

condensed_​profile
🔍 Read

Retrieve an AI-optimized user profile with behavioral analytics, engagement patterns, and summary insights.

Schema & data discovery

Tool name

De­scrip­tion

get_​customer_​attribute_​schema_​v2
🔍 Read

Retrieve user attribute schema for building valid group by choices in audience insights and segmentation. Includes AI-powered smart filtering.

get_​data_​studio_​schema
🔍 Read

Get the data structure and available attributes/​fields for customer records.

get_​events_​schema
🔍 Read

Get detailed schema for specific event types including available properties and data types.

get_​products_​schema
🔍 Read

Get the data structure and available fields for product catalog records.

get_schema
🔍 Read

Return the full seg­men­ta­tion schema including events, user attributes, trans­ac­tions, operators, and timeline helpers. Supports output masking for large payloads (50K+ tokens).

get_user_schema
🔍 Read

Get the data structure and available fields for customer profiles.

Attributes & usage analytics

Tool name

De­scrip­tion

attribute_​usage_​statistics
🔍 Read

Get usage statistics for all attributes across users, events, products, or user base — including campaign, segment, and template usage counts.

attribute_​usages
🔍 Read

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
🔍 Read

Return active predictive scores, predictive affinities, computed attributes, and RFM definitions available for the account.

Product catalog

Tool name

De­scrip­tion

get_​product_​by_​sku
🔍 Read

Get product details by SKU or product ID.

get_​product_​by_​uuid
🔍 Read

Get product details by internal UUID.

list_catalogs
🔍 Read

List all product catalogs with metadata to identify which catalog to search.

search_products
🔍 Read

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

De­scrip­tion

list_​enriched_​recommendation_​schemes
🔍 Read

List rec­om­men­da­tion schemes with enriched AI-generated de­scrip­tions and metadata.

Reports & dashboards

Tool name

De­scrip­tion

get_​user_​insights_​statistics
🔍 Read

Query customer analytics for audience composition by attributes, predictive scores, RFM tiers, and more.

list_metrics
🔍 Read

List available per­for­mance metrics (sends, clicks, conversion rates, etc.) for campaign per­for­mance, user insights, rec­om­men­da­tions, or segment trends.

Events & transactions

Tool name

De­scrip­tion

event_summary
🔍 Read

Get event activity summary, counts, trends, and metadata for a specified time period.

get_​transaction_​config
🔍 Read

Get trans­ac­tion con­fig­u­ra­tion including available events for a trans­ac­tion type.

Promotions

Tool name

De­scrip­tion

list_​promotions_​v1
🔍 Read

List all promotions with status, values, expiration dates, and use type (single use or multi use).

Tags & organization

Tool name

De­scrip­tion

get_tag_folder
🔍 Read

Get detailed in­for­ma­tion about a specific tag folder including tagged resources.

get_​tag_​usage_​counts
🔍 Read

Get usage counts for tags within a folder, optionally filtered by resource type.

list_​tag_​folders
🔍 Read

List tag folders used for organizing campaigns, templates, segments, and other resources.

Image management

Tool name

De­scrip­tion

list_images
🔍 Read

List and search images in the account's image library.

Documentation & help

Tool name

De­scrip­tion

get_article
🔍 Read

Get full article content by ID with complete documentation.

load_​domain_​reference
🔍 Read

Load domain reference documentation on demand for spe­cial­ized knowledge — campaign analysis workflows, segment creation patterns, email template authoring, and more.

search_articles
🔍 Read

Search Blueshift's Zendesk Help Center for documentation and guides.

Did this answer your question?