# Bloomreach MCP for AI Agents MCP

> Bloomreach connects your marketing automation data directly to any AI client. It lets you manage catalogs, monitor campaigns, and analyze customer segments without leaving your chat window. You can retrieve everything from product metadata to webhook status using natural language.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** customer-experience, personalization, campaign-management, data-catalogs, customer-segments, marketing-analytics

## Description

Stop jumping between Bloomreach dashboards just to answer a quick question about campaign performance or catalog accuracy. This MCP connects your entire marketing automation account directly to your AI agent, letting you manage complex data workflows through conversation. Instead of exporting CSVs and running reports manually, you simply ask the agent what you need—like listing all active campaigns or pulling customer segment details for a specific user. The platform makes sure this connection is stable, hosting it on Vinkius, which gives your AI client access to thousands of tools across different industries. You can now audit product attributes and properties, check data collection by listing all tracked event types, and even monitor webhooks in real time. It’s about having one source of truth for your marketing ecosystem.

## Tools

### get_catalog_items
Pulls a list of individual products from a specified Bloomreach data catalog.

### get_customer_properties
Exports specific attributes and properties for any registered customer account.

### list_segmentations
Shows a list of all created customer segment groupings within Bloomreach.

### list_attributes
Provides a comprehensive list of every customizable attribute used for customers.

### list_campaigns
Retrieves details and status information for all active marketing campaigns.

### list_catalogs
Displays an overview of every data catalog available in your Bloomreach account.

### list_event_types
Lists all types of user interactions and events currently being tracked by the system.

### list_properties
Retrieves definitions for various catalog properties used across your products.

### list_segments
Provides a list of all predefined customer segments, like 'VIP' or 'New Buyer'.

### list_webhooks
Shows details on every configured webhook to confirm real-time data connections.

## Prompt Examples

**Prompt:** 
```
Show me all the active campaigns and which customer segments they are currently targeting.
```

**Response:** 
```
**Campaign Summary**
* **Summer Clearance:** Targets 'Recent Visitors' (Segment ID: 12). Active since June 1st.
* **Loyalty Tier Upgrade:** Targets 'High Spenders' (Segment ID: 99). Runs monthly. 
* **Q3 Product Launch:** Targets all customers with the attribute `interests: electronics`. Currently paused.
```

**Prompt:** 
```
What are our most common catalog properties, and what items belong to the 'Outdoor Gear' catalog?
```

**Response:** 
```
**Catalog Properties Found:**
* Size (Type: String)
* Weight (Type: Decimal)
* Material (Type: Enum)
**Items in 'Outdoor Gear':**
1. Backpack Alpha (ID: OG-001): Properties match.
2. Hiking Boots Beta (ID: HG-045): Properties match.
```

**Prompt:** 
```
I need to know if any webhooks are failing or misconfigured right now.
```

**Response:** 
```
Here is a quick status check of your configured webhooks:

| Webhook Name | Status | Last Run Time | Notes |
| :--- | :--- | :--- | :--- |
| CRM Sync | Operational | 2 minutes ago | Sending successfully.
| Inventory Alert | Failed | 3 hours ago | API key expired. Needs updating. |
| Newsletter Trigger | Operational | Now | No failures recorded.
```

## Capabilities

### Manage Product Catalogs
List available catalogs to understand the structure of your product data.

### Inspect Catalog Items
Retrieve specific product items from any defined data catalog for review.

### Analyze Customer Attributes
List all available customer attributes and export properties for a registered user.

### Review Customer Segments
List all predefined customer segments or explore specific segmentations to narrow your target audience.

### Monitor Campaign Status
Query and list details for existing marketing campaigns to track outreach performance.

### Audit Data Infrastructure
List all tracked event types or configured webhooks to verify your data collection footprint.

## Use Cases

### I need to check if the 'Summer Sale' campaign is active and who it targets.
Instead of logging into Bloomreach, navigating to campaigns, and then checking segment definitions, just ask your agent. It uses `list_campaigns` and `list_segments` to give you a single answer: yes, the campaign is running for 'High Spenders' in Segment ID 45.

### We launched a new product line, but I need to know if our catalog structure supports it.
You use your agent to call `list_properties` and then `list_attributes`. The agent compiles the results, showing you exactly which data points (like 'Material Type' or 'Weight') are available for new products.

### A client says their account isn't syncing user activity.
The AI agent runs `list_webhooks` and reports back the status of all configured webhooks. You immediately see if a webhook is listed as 'inactive' or if it has failed recent calls.

### I need to verify what data points we can collect from user interactions.
Simply ask about event tracking. The agent uses `list_event_types` and gives you a full list of every possible tracked interaction, ensuring no valuable user behavior is missed.

## Benefits

- Instantly check catalog data and campaign statuses using the `list_campaigns` tool, eliminating the need for manual exports.
- Analyze customer groups by listing segments or running a query to understand specific segmentations via `list_segmentations`.
- Audit product details immediately. You can use `get_catalog_items` to inspect any item in your data catalogs without navigating multiple screens.
- Improve personalization depth by using `get_customer_properties` to export attributes for individual customers, letting you see exactly what data exists.
- Keep track of system health. Listing configured webhooks with `list_webhooks` confirms real-time data pipelines are running correctly.
- Understand your data footprint fully. The `list_event_types` tool lets you know every piece of user activity currently being tracked.

## How It Works

The bottom line is: it lets your AI client handle all the routine data requests and reports that usually require multiple manual logins and exports.

1. First, you subscribe to this MCP on Vinkius and provide the necessary Bloomreach credentials (Project Token, API ID, etc.).
2. Next, your AI agent uses these connections. You simply ask it a question—for example, 'What are my top-performing campaigns?'—and the agent handles the data retrieval.
3. Finally, you get an immediate, structured answer in your chat client, whether that's a list of segments or a summary of product properties.

## Frequently Asked Questions

**Can the Bloomreach MCP help me check my product catalog data quickly?**
Yes, it lets you list all available catalogs and retrieve individual items using natural language. This means no more manual dashboard checks; your agent pulls the item details directly for you.

**How do I use Bloomreach MCP to understand my customer groups?**
You can ask the MCP to list all existing segments and segmentations. This gives you a full overview of who belongs where, letting you target marketing efforts with precision.

**Does the Bloomreach MCP help me monitor real-time data connections?**
Absolutely. You can ask to list all configured webhooks and check their status. This is crucial for knowing if your data syncing between systems is actually working.

**Is the Bloomreach MCP only for checking campaigns, or can it do more?**
It does much more than just campaigns. You can use it to audit product attributes, list all tracked event types, and check customer properties to gather a complete picture of your marketing data.

**What if I need to verify what kind of user behavior is being collected?**
You can ask the MCP to list all tracked event types. This gives you a comprehensive inventory of every single piece of interaction data Bloomreach records, so you never miss an opportunity.