generated: '2026-08-12'
method: searched
status: published
source: https://help.blueshift.com/hc/en-us/articles/49714422787347-Blueshift-MCP-Server-tools-Beta
description: 'Blueshift operates an official hosted remote MCP server, in public beta, at https://app.getblueshift.com/mcp
  (US and rest of world) and https://app.eu.getblueshift.com/mcp (EU). Transport is streamable HTTP
  (the setup docs explicitly say HTTP, not SSE) and authorization is OAuth 2.0: an anonymous POST
  of tools/list returns 401 with an RFC 9728 WWW-Authenticate challenge pointing at the host''s own
  protected-resource metadata, so the live tool schemas require an authenticated introspection we
  do not perform. The tool list below is therefore captured from Blueshift''s own published tool catalogue
  — names, descriptions, categories and read/write class — and carries no inputSchema. The same 401-with-resource_metadata
  behaviour is served by api.getblueshift.com/mcp and api.eu.getblueshift.com/mcp.'
server:
  name: blueshift
  transport: http
  url: https://app.getblueshift.com/mcp
  auth: oauth2
  lifecycle: beta
  listed: false
  protected_resource: well-known/blueshift-app-oauth-protected-resource.json
  authorization_server: well-known/blueshift-app-oauth-authorization-server.json
  docs: https://help.blueshift.com/hc/en-us/articles/49713147943187-The-Blueshift-MCP-Server-Beta
regions:
- region: US and rest of world
  url: https://app.getblueshift.com/mcp
  probe_status: 401
  challenge: Bearer resource_metadata="https://app.getblueshift.com/.well-known/oauth-protected-resource"
- region: EU
  url: https://app.eu.getblueshift.com/mcp
  probe_status: 401
  challenge: Bearer resource_metadata="https://app.eu.getblueshift.com/.well-known/oauth-protected-resource"
- region: US and rest of world (API host mirror)
  url: https://api.getblueshift.com/mcp
  probe_status: 401
  challenge: Bearer resource_metadata="https://api.getblueshift.com/.well-known/oauth-protected-resource"
- region: EU (API host mirror)
  url: https://api.eu.getblueshift.com/mcp
  probe_status: 401
  challenge: Bearer resource_metadata="https://api.eu.getblueshift.com/.well-known/oauth-protected-resource"
clients:
- Claude (desktop and web, custom connector)
- Claude Code
- Codex CLI
- Codex app
x-evidence:
  fetched: '2026-08-12'
  tools_list_probe: POST https://app.getblueshift.com/mcp {"jsonrpc":"2.0","id":1,"method":"tools/list"}
  tools_list_status: 401
  tools_list_body: '{"error":"invalid_request","error_description":"Missing credentials"}'
  tool_catalogue_source: https://docs.google.com/spreadsheets/d/1i-W5-oY1fAggkhBilMIGDzeUVw5fgGBF5dN5276u1Hk
    (the sheet Blueshift publishes into its own help-centre MCP Tools Explorer, tab "MCP Tools")
  tool_catalogue_file: mcp/blueshift-mcp-tools.csv
coverage:
  tools_catalogued: 131
  published: 41
  unpublished: 90
  read: 97
  write: 34
  categories: 23
  input_schemas: 0
  note: Blueshift’s own catalogue marks 90 of the 131 tools as not yet published, so the live server
    exposes a subset. The published/unpublished flag is Blueshift’s, carried through verbatim. inputSchema
    is 0 because the live tools/list is OAuth-gated.
categories:
  Account & configuration: 2
  Attributes & usage analytics: 3
  Audit & change tracking: 2
  Campaign optimizer (AI): 11
  Campaigns: 6
  Content & document generation: 4
  Customer profiles & data: 6
  Documentation & help: 3
  Events & transactions: 2
  Image management: 5
  Live content & onsite slots: 4
  Marketing insights & ideation: 8
  Pages & scripts: 11
  Product catalog: 5
  Promotions: 1
  Recommendations: 10
  Reports & dashboards: 10
  Schema & data discovery: 8
  Segments: 7
  Shared assets: 3
  Tags & organization: 3
  Templates: 8
  Utilities & system: 9
tools:
- name: list_campaigns_v2
  description: 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.
  category: Campaigns
  access: read
  published: true
- name: get_campaign_full
  description: Retrieve the complete, unfiltered configuration of a campaign including all fields
    preserved — triggers, conditions, experiment groups, scheduling, and settings.
  category: Campaigns
  access: read
  published: false
- name: get_campaign_lite
  description: Retrieve campaign information with smart AI filtering — returns only the fields matching
    your intent for a lightweight, token-efficient response.
  category: Campaigns
  access: read
  published: true
- name: get_campaign_statistics
  description: 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.
  category: Campaigns
  access: read
  published: true
- name: create_campaign
  description: Create a new campaign shell (one-time, recurring, segment triggered, or event triggered).
    Use update_campaign after creation to add triggers, segments, and templates.
  category: Campaigns
  access: write
  published: false
- name: update_campaign
  description: Add triggers, segments, templates, conditions, A/B tests, scheduling, and all configuration
    details to an existing campaign. Supports the full journey builder workflow.
  category: Campaigns
  access: write
  published: false
- name: list_segments_v1
  description: List all customer segments with their names, types, and metadata.
  category: Segments
  access: read
  published: true
- name: get_segment_details
  description: Retrieve detailed configuration and filter criteria for a specific segment, including
    all V2 conditions and components.
  category: Segments
  access: read
  published: true
- name: create_segment_v2
  description: Create a new Advanced (V2) segment with a root condition node. Add conditions afterward
    with update_segment_v2.
  category: Segments
  access: write
  published: false
- name: update_segment_v2
  description: Update an existing V2 segment — add, modify, or delete conditions and components including
    user attributes, events, transactions, and segment references. Supports resource draft pointers
    for iterative editing.
  category: Segments
  access: write
  published: false
- name: search_users
  description: Search and filter users by attributes, segments, or dynamic inline queries. Supports
    count only mode for funnel analysis, cohort sizing, and retention measurement.
  category: Segments
  access: read
  published: true
- name: matching_users_at_path_synchronous
  description: Get user count at a specific V2 segment condition node — useful for debugging and verifying
    segment logic.
  category: Segments
  access: read
  published: true
- name: show_query
  description: View the underlying query generated from segment conditions for debugging and optimization.
  category: Segments
  access: read
  published: false
- name: list_email_templates
  description: List email templates with optional filtering by name, tags, editor type, status, and
    author.
  category: Templates
  access: read
  published: true
- name: get_email_template
  description: Retrieve detailed information about an email template including HTML content, settings,
    Liquid variables, and associated campaigns. Supports expanding shared assets inline.
  category: Templates
  access: read
  published: true
- name: create_email_template
  description: Create a new email template with name, subject line, preheader, and HTML content.
  category: Templates
  access: write
  published: false
- name: update_email_template
  description: Update an existing email template's subject, preheader, content, or recommendation
    settings.
  category: Templates
  access: write
  published: false
- name: render_email
  description: Render a Liquid email template with personalizations and optionally generate a screenshot
    with AI-powered visual analysis. Supports rendering by user identifier, manual personalizations,
    or optimizer experiment context.
  category: Templates
  access: read
  published: false
- name: get_personalizations
  description: Fetch personalization context for a user and template, including product recommendations
    — used for Liquid template preview.
  category: Templates
  access: read
  published: false
- name: list_push_templates
  description: List push notification templates with filtering by name, tags, and author.
  category: Templates
  access: read
  published: true
- name: list_sms_templates
  description: List SMS/MMS templates with filtering by name, tags, message type, and author.
  category: Templates
  access: read
  published: true
- name: list_shared_assets
  description: List reusable content blocks (HTML, rich text, subject lines, visual editor blocks)
    with filtering by type, name, tags, and usage counts.
  category: Shared assets
  access: read
  published: true
- name: get_shared_asset
  description: Retrieve detailed information about a specific shared asset including content, dependencies,
    and usage.
  category: Shared assets
  access: read
  published: true
- name: get_shared_asset_templates
  description: Get all email templates that reference a specific shared asset.
  category: Shared assets
  access: read
  published: true
- name: search_customer
  description: Search for customers by common identifiers — email, customer ID, phone, UUID, device
    ID, or cookie.
  category: Customer profiles & data
  access: read
  published: false
- name: condensed_profile
  description: Retrieve an AI-optimized user profile with behavioral analytics, engagement patterns,
    and summary insights.
  category: Customer profiles & data
  access: read
  published: true
- name: get_user_events
  description: List all events and interactions for a specific customer with pagination support.
  category: Customer profiles & data
  access: read
  published: false
- name: get_user_transactions
  description: List all purchase transactions for a specific customer.
  category: Customer profiles & data
  access: read
  published: false
- name: get_campaign_activity
  description: List all campaign interactions and messaging activity for a specific customer.
  category: Customer profiles & data
  access: read
  published: false
- name: get_user_campaign_activity
  description: Retrieve comprehensive campaign activity history for a user within a date range.
  category: Customer profiles & data
  access: read
  published: false
- name: get_schema
  description: Return the full segmentation schema including events, user attributes, transactions,
    operators, and timeline helpers. Supports output masking for large payloads (50K+ tokens).
  category: Schema & data discovery
  access: read
  published: true
- name: get_customer_attribute_schema_v2
  description: Retrieve user attribute schema for building valid group by choices in audience insights
    and segmentation. Includes AI-powered smart filtering.
  category: Schema & data discovery
  access: read
  published: true
- name: get_data_studio_schema
  description: Get the data structure and available attributes/fields for customer records.
  category: Schema & data discovery
  access: read
  published: true
- name: get_events_schema
  description: Get detailed schema for specific event types including available properties and data
    types.
  category: Schema & data discovery
  access: read
  published: true
- name: get_products_schema
  description: Get the data structure and available fields for product catalog records.
  category: Schema & data discovery
  access: read
  published: true
- name: get_user_schema
  description: Get the data structure and available fields for customer profiles.
  category: Schema & data discovery
  access: read
  published: true
- name: get_studio_schema
  description: Get a UI friendly schema with filter operators, event categories, and simplified score
    lists for recommendation authoring.
  category: Schema & data discovery
  access: read
  published: false
- name: get_recommendation_authoring_schema
  description: Retrieve the recommendation authoring schema with available filters, events, and data
    stores for building catalog item blocks.
  category: Schema & data discovery
  access: read
  published: false
- name: attribute_usage_statistics
  description: Get usage statistics for all attributes across users, events, products, or user base
    — including campaign, segment, and template usage counts.
  category: Attributes & usage analytics
  access: read
  published: true
- name: attribute_usages
  description: Check specific attributes (up to 40) for usage across campaigns, segments, templates,
    or count of users where the attribute is set.
  category: Attributes & usage analytics
  access: read
  published: true
- name: get_user_insight_attributes
  description: Return active predictive scores, predictive affinities, computed attributes, and RFM
    definitions available for the account.
  category: Attributes & usage analytics
  access: read
  published: true
- name: list_catalogs
  description: List all product catalogs with metadata to identify which catalog to search.
  category: Product catalog
  access: read
  published: true
- name: search_products
  description: Search and filter catalog products by attributes like SKU, title, brand, category,
    price, and availability. Supports AND/OR/NOT conditions and pagination.
  category: Product catalog
  access: read
  published: true
- name: get_product_by_sku
  description: Get product details by SKU or product ID.
  category: Product catalog
  access: read
  published: true
- name: get_product_by_uuid
  description: Get product details by internal UUID.
  category: Product catalog
  access: read
  published: true
- name: get_product_attribute_stats
  description: Get distribution statistics for product attribute values (e.g., category breakdown
    for purchase events).
  category: Product catalog
  access: read
  published: false
- name: list_recommendation_schemes_v1
  description: List all recommendation schemes with names and configurations.
  category: Recommendations
  access: read
  published: false
- name: list_enriched_recommendation_schemes
  description: List recommendation schemes with enriched AI-generated descriptions and metadata.
  category: Recommendations
  access: read
  published: true
- name: get_recommendation_scheme
  description: Retrieve detailed configuration for a specific recommendation scheme including blocks
    and settings.
  category: Recommendations
  access: read
  published: false
- name: list_recommendation_block_themes
  description: List recommendation block themes (recipes) with configurations and use cases. Supports
    smart filtering.
  category: Recommendations
  access: read
  published: false
- name: get_recommendation_block_theme
  description: Get detailed configuration of a specific recommendation block theme.
  category: Recommendations
  access: read
  published: false
- name: get_recommendations
  description: Test and validate recommendation algorithms with real user data.
  category: Recommendations
  access: read
  published: false
- name: get_recommended_products
  description: Retrieve personalized product recommendations for a specific customer.
  category: Recommendations
  access: read
  published: false
- name: create_account_algorithm
  description: Create a new recommendation algorithm using draft resource pointers or inline code.
  category: Recommendations
  access: write
  published: false
- name: update_account_algorithm
  description: Update an existing recommendation algorithm.
  category: Recommendations
  access: write
  published: false
- name: compile_plasma_code
  description: Compile Plasma code to validate syntax and generate personalization steps.
  category: Recommendations
  access: read
  published: false
- name: list_opportunities
  description: List optimizer opportunities and approval pending items — the main queue for optimization
    work. Filter by type (opportunity vs. approval pending).
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_opportunity
  description: Get full opportunity details including AI analysis, generated content, and scoring
    for a specific experiment group.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_opportunity_discovery_status
  description: Check current status of the opportunity discovery pipeline for the account.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: list_optimizer_runs
  description: List optimization runs across the account with filtering by campaign type, status,
    significance, and pagination.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_optimizer_run
  description: Get detailed information about a single optimization run including metrics, allocations,
    and results.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_optimizer_state
  description: Get current optimizer state, configuration, active runs, and test allocations for an
    experiment group.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_optimizer_landscape
  description: Retrieve the cached account level optimizer landscape summary.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_optimizer_content_variants
  description: List ranked content variants with ELO tournament scores and user feedback for an experiment
    group.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: get_optimizer_sample
  description: Render a single sample context for current, optimized, or custom content for an experiment.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: render_optimizer_samples
  description: Batch render candidate subject lines and preheaders against a selected sample context.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: list_optimizer_analyses
  description: List stored AI analyses for an experiment group — the reasoning behind opportunity
    identification.
  category: Campaign optimizer (AI)
  access: read
  published: false
- name: list_reports
  description: List saved standard reports filtered by name, insight type, author, or tags.
  category: Reports & dashboards
  access: read
  published: false
- name: get_report
  description: Fetch a single saved report with tags and metric details.
  category: Reports & dashboards
  access: read
  published: false
- name: create_report
  description: Create a reusable campaign performance report (chart or table) that can be added to
    dashboards. Supports multiple chart types, groupings, and time comparisons.
  category: Reports & dashboards
  access: write
  published: false
- name: update_report
  description: Update a saved report — rename, swap metrics, change filters, chart type, or visibility.
  category: Reports & dashboards
  access: write
  published: false
- name: list_dashboards
  description: List dashboard shells filtered by name or author email.
  category: Reports & dashboards
  access: read
  published: false
- name: get_dashboard
  description: Fetch a full dashboard including global filters, widgets, and notes.
  category: Reports & dashboards
  access: read
  published: false
- name: create_dashboard
  description: Create a new dashboard shell. Add widgets and filters afterward with update_dashboard.
  category: Reports & dashboards
  access: write
  published: false
- name: update_dashboard
  description: Update an existing dashboard — rename, adjust global filters, add/reorder/delete widgets,
    and edit notes.
  category: Reports & dashboards
  access: write
  published: false
- name: list_metrics
  description: List available performance metrics (sends, clicks, conversion rates, etc.) for campaign
    performance, user insights, recommendations, or segment trends.
  category: Reports & dashboards
  access: read
  published: true
- name: get_user_insights_statistics
  description: Query customer analytics for audience composition by attributes, predictive scores,
    RFM tiers, and more.
  category: Reports & dashboards
  access: read
  published: true
- name: event_summary
  description: Get event activity summary, counts, trends, and metadata for a specified time period.
  category: Events & transactions
  access: read
  published: true
- name: get_transaction_config
  description: Get transaction configuration including available events for a transaction type.
  category: Events & transactions
  access: read
  published: true
- name: get_onsite_slots
  description: List and search onsite slots for live content campaigns with filtering by name, format,
    and active status.
  category: Live content & onsite slots
  access: read
  published: false
- name: get_onsite_slot_details
  description: Get detailed information about a specific onsite slot.
  category: Live content & onsite slots
  access: read
  published: false
- name: create_onsite_slot
  description: Create a new onsite slot for live content campaigns (HTML, JSON, or Landing Page format).
  category: Live content & onsite slots
  access: write
  published: false
- name: get_live_content
  description: Retrieve personalized live content for a specific slot and user — useful for testing
    personalization.
  category: Live content & onsite slots
  access: read
  published: false
- name: list_promotions_v1
  description: List all promotions with status, values, expiration dates, and use type (single use
    or multi use).
  category: Promotions
  access: read
  published: true
- name: list_tag_folders
  description: List tag folders used for organizing campaigns, templates, segments, and other resources.
  category: Tags & organization
  access: read
  published: true
- name: get_tag_folder
  description: Get detailed information about a specific tag folder including tagged resources.
  category: Tags & organization
  access: read
  published: true
- name: get_tag_usage_counts
  description: Get usage counts for tags within a folder, optionally filtered by resource type.
  category: Tags & organization
  access: read
  published: true
- name: list_audit_trails
  description: List audit trail records for understanding user behavior, investigating changes, and
    debugging. Filter by author, resource type, action, date range, and resource name.
  category: Audit & change tracking
  access: read
  published: false
- name: get_audit_detail
  description: Retrieve complete details of a specific change for deep investigation and understanding
    exact modifications.
  category: Audit & change tracking
  access: read
  published: false
- name: get_account_info
  description: Get account settings, feature flags, and configuration details.
  category: Account & configuration
  access: read
  published: false
- name: get_account_notes
  description: Retrieve foundational account context notes — business description, email program analysis,
    campaign landscape, and brand voice analysis.
  category: Account & configuration
  access: read
  published: false
- name: list_marketing_insights
  description: List all marketing insights for the account with filtering by status, insight type,
    and severity.
  category: Marketing insights & ideation
  access: read
  published: false
- name: get_marketing_insight
  description: Get detailed information about a specific marketing insight including metrics, analysis,
    findings, and related resources.
  category: Marketing insights & ideation
  access: read
  published: false
- name: create_marketing_insight
  description: Save a structured marketing insight with trend analysis, metrics, key findings, and
    by entity breakdowns.
  category: Marketing insights & ideation
  access: write
  published: false
- name: update_marketing_insight
  description: Update an existing marketing insight.
  category: Marketing insights & ideation
  access: write
  published: false
- name: list_ideation_proposals
  description: List ideation proposals with optional filtering by name, status, and more.
  category: Marketing insights & ideation
  access: read
  published: false
- name: get_ideation_proposal
  description: Get detailed information about a specific ideation proposal.
  category: Marketing insights & ideation
  access: read
  published: false
- name: create_ideation_proposal
  description: Save a structured, data-backed ideation proposal with audience sizing, RICE scoring,
    execution plans, and resource mapping.
  category: Marketing insights & ideation
  access: write
  published: false
- name: update_ideation_proposal
  description: Update an existing proposal or record execution progress with step-by-step tracking
    and asset linking.
  category: Marketing insights & ideation
  access: write
  published: false
- name: generate_chart
  description: Generate chart images (line, bar, area, scatter, pie, histogram) from data you pass
    in.
  category: Content & document generation
  access: write
  published: false
- name: generate_pdf
  description: Generate PDF reports from data with configurable layout, sections, charts, and styling.
  category: Content & document generation
  access: write
  published: false
- name: generate_powerpoint
  description: Generate PowerPoint presentations from a predefined list of slides.
  category: Content & document generation
  access: write
  published: false
- name: generate_spreadsheet
  description: Generate Excel spreadsheets from data with configurable sheets, formatting, and totals.
  category: Content & document generation
  access: write
  published: false
- name: list_images
  description: List and search images in the account's image library.
  category: Image management
  access: read
  published: true
- name: create_image
  description: Save an image from a URL to the account's image library.
  category: Image management
  access: write
  published: false
- name: update_image
  description: Update image metadata including type and tags.
  category: Image management
  access: write
  published: false
- name: analyze_image
  description: Analyze an image from a URL to extract information, describe content, or answer questions
    about visual elements.
  category: Image management
  access: read
  published: false
- name: generate_image
  description: Generate new images or edit existing ones.
  category: Image management
  access: write
  published: false
- name: search_articles
  description: Search Blueshift's Zendesk Help Center for documentation and guides.
  category: Documentation & help
  access: read
  published: true
- name: get_article
  description: Get full article content by ID with complete documentation.
  category: Documentation & help
  access: read
  published: true
- name: load_domain_reference
  description: Load domain reference documentation on demand for specialized knowledge — campaign
    analysis workflows, segment creation patterns, email template authoring, and more.
  category: Documentation & help
  access: read
  published: true
- name: generate_link
  description: Generate a Blueshift dashboard link for any resource (segment, campaign, template,
    algorithm, report, dashboard, customer, etc.).
  category: Utilities & system
  access: read
  published: false
- name: generate_uuid
  description: Generate random UUIDs for use in resource creation.
  category: Utilities & system
  access: read
  published: false
- name: resource
  description: Create, fetch, or edit reusable server-managed drafts (segments, templates, algorithms)
    for iterative workflows.
  category: Utilities & system
  access: write
  published: false
- name: request_permission
  description: Request temporary write permission in chat-based agent environments that support approval
    elicitations.
  category: Utilities & system
  access: write
  published: false
- name: tool_search
  description: Search for and discover available tools by keyword or intent. Returns ranked matches
    with invocation hints.
  category: Utilities & system
  access: read
  published: false
- name: phase_handoff
  description: Compress context and switch tool packs for long-running, multi-phase agent workflows.
    Preserves working memory across context boundaries.
  category: Utilities & system
  access: read
  published: false
- name: update_agents_md
  description: Create or update the AGENTS.MD awareness document that is automatically injected into
    future sessions.
  category: Utilities & system
  access: write
  published: false
- name: web_research
  description: Research current information using Google Search for market intelligence and competitive
    context.
  category: Utilities & system
  access: read
  published: false
- name: github_issues
  description: Create, list, fetch, comment on, and close GitHub issues in the Blueshift MCP tools
    repository. Blueshift internal use only.
  category: Utilities & system
  access: read
  published: false
- name: list_pages
  description: Browse pages (InternalPages, PublicPages, ToolScripts).
  category: Pages & scripts
  access: read
  published: false
- name: get_page
  description: Get details of a specific page.
  category: Pages & scripts
  access: read
  published: false
- name: create_internal_page
  description: Create an internal page.
  category: Pages & scripts
  access: write
  published: false
- name: create_external_page
  description: Create an external page.
  category: Pages & scripts
  access: write
  published: false
- name: update_internal_page
  description: Update an internal page.
  category: Pages & scripts
  access: write
  published: false
- name: update_external_page
  description: Update an external page.
  category: Pages & scripts
  access: write
  published: false
- name: run_page
  description: Execute a page headlessly.
  category: Pages & scripts
  access: write
  published: false
- name: run_tool_script
  description: Execute a tool script headlessly.
  category: Pages & scripts
  access: write
  published: false
- name: present_page
  description: Present a page to the user.
  category: Pages & scripts
  access: read
  published: false
- name: archive_page
  description: Soft-delete a page.
  category: Pages & scripts
  access: write
  published: false
- name: get_personalized_url
  description: Get a personalized URL for a resource.
  category: Pages & scripts
  access: read
  published: false