# Blueshift MCP for AI Agents MCP

> Blueshift MCP orchestrates complex omnichannel marketing campaigns and customer data workflows. Connect your existing customer engagement platform to any AI agent to manage segments, update user profiles, track purchases, and execute targeted campaigns using natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** customer-data-platform, omnichannel-marketing, personalization, campaign-management, customer-profiles, engagement-tracking

## Description

Connecting Blueshift lets you treat your entire marketing stack like a single chat session. Instead of jumping between dashboards to check campaign status or find a customer's history, your AI client does it all for you. You can ask your agent to pull up detailed reports on specific campaigns, get the full history of events tied to a user, or even update critical attributes on a customer record instantly. Need to target a niche group? Your MCP allows you to list data catalogs and segments so you know exactly who you're talking to. It also lets you initiate immediate, API-triggered campaigns for specific users right from your workspace. By connecting via Vinkius, you gain access to this powerful workflow management alongside thousands of other tools, making it the central hub for all your customer engagement needs.

## Tools

### list_segments
Retrieves a complete list of customer segments defined in Blueshift.

### create_update_customer
Allows the creation or modification of an existing customer profile record.

### list_campaigns
Lists all active and inactive marketing campaigns within your account.

### list_catalogs
Retrieves a full list of available data catalogs for reference.

### track_event
Records a specific, custom user interaction event against a customer's profile.

### get_campaign_detail
Fetches an in-depth performance report for one specific marketing campaign.

### get_campaign_performance
Generates a high-level summary of how all your current campaigns are performing overall.

### get_catalog_items
Retrieves specific items from any listed data catalog.

### get_customer
Pulls all available details for a single customer profile using identifiers or emails.

### get_event_history
Retrieves the chronological history of every event recorded for a user.

## Prompt Examples

**Prompt:** 
```
What were the top 3 actions taken by user customer_123 last week?
```

**Response:** 
```
**User Activity Report: customer_123**

*   🛒 **Purchase:** Item XYZ, $45.00 (Oct 15)
*   📄 **View:** Pricing Page (Oct 16)
*   📧 **Click:** 'Download Guide' link (Oct 17)

This history shows they are highly engaged with our pricing structure.
```

**Prompt:** 
```
List all segments that include 'High Value Customers' and check their current campaign status.
```

**Response:** 
```
**Segment Analysis**

*   ✅ **Segments Found:** High Value, Platinum Tier, VIP Users.
*   📊 **Current Status:** All three segments are currently part of the 'Annual Review Campaign'. The last run was 2 days ago and achieved 98% open rate.

Need me to trigger a new campaign for them?
```

**Prompt:** 
```
Show me the full profile details for john@example.com, including their segment membership.
```

**Response:** 
```
Here is John Doe's current profile summary:

*   **Status:** Active Member (Joined: 2023)
*   **Total Spend:** $450
*   **Segments:** High Value Customers; North East Region;
*   **Last Event:** Viewed Product X on Oct 17th.
```

## Capabilities

### Review Campaign Performance
Fetch detailed reports or high-level summaries on any marketing campaign.

### Manage Customer Records
Create, retrieve, or modify entire customer profiles using custom attributes and identifiers.

### Track User Activity
Record specific user actions like purchases or views, and pull a complete timeline of events for any individual.

### Identify Target Groups
List available customer segments or browse all data catalogs to ensure accurate audience targeting.

### Run Targeted Campaigns
Send out campaigns that are triggered automatically for a select group of users.

## Use Cases

### Auditing Campaign Health
A manager needs to know if the 'Summer Re-engagement' campaign hit its goal and compare it against others. They ask their agent for high-level performance, which pulls data from get_campaign_performance, giving them a clear comparison table without opening any dashboards.

### Onboarding New Users
A specialist needs to ensure a new user's profile is complete before the welcome sequence runs. They ask their agent for the customer record (get_customer) and then update attributes using create_update_customer if anything is missing.

### Analyzing Drop-Off Points
A growth engineer notices a user seems inactive. They use get_event_history to see the last three actions, discover they never viewed the pricing page, and then ask their agent to track an event (track_event) simulating that view.

### Segment Validation
Before sending a major announcement, a marketer needs to verify which user groups are included. They use list_segments first, and then check the available data sources using list_catalogs to ensure proper targeting.

## Benefits

- Quickly check campaign statuses. Instead of logging into the dashboard, you simply ask your agent to list all campaigns or get a high-level performance summary for instant insight.
- Maintain clean, accurate records by using create_update_customer. You can modify customer profiles and ensure every attribute is up to date without manual database access.
- Analyze user behavior deeply. Get the full event history of any single person; this goes far beyond simple last-logged-in dates.
- Targeting becomes precise. List all data catalogs and segments before running a campaign, guaranteeing you only target validated groups.
- Speed up execution with API-triggered campaigns. Initiate specific marketing sequences for users instantly from your chat interface.

## How It Works

The bottom line is you manage all of your complex marketing data and campaigns through simple conversation with your AI client.

1. Subscribe to this MCP and input your Blueshift User API Key and Site ID.
2. Connect the credentials to any AI-compatible client, giving your agent access to all marketing functions.
3. Ask your agent a natural language question; it executes the necessary calls to pull customer data or run a campaign.

## Frequently Asked Questions

**Can I check the latest events tracked for a specific customer?**
Yes! Use the `get_event_history` tool with the customer's email or ID. Your agent will fetch the timeline of their interactions, such as purchases or email opens.

**How do I see the performance summary of my current campaigns?**
Simply ask the agent to `get_campaign_performance`. It will retrieve a high-level overview of metrics across all active and past campaigns in your account.

**Does the integration allow updating customer attributes?**
Yes. Use the `create_update_customer` tool to modify profile data such as first name, last name, or custom properties directly from the agent.