# Cordial MCP for AI Agents MCP

> Cordial MCP connects your AI client directly to a major cross-channel marketing platform. Your agent manages subscriber data, tracks campaign performance across email and SMS, and controls automated messaging workflows using natural language instructions.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cross-channel-marketing, subscriber-data, campaign-analytics, automated-messaging, personalization, audience-targeting

## Description

Managing customer communications used to mean jumping between separate CRMs, analytics dashboards, and mailing tools. Now you can keep everything in one place. This MCP lets your AI client interact with Cordial directly. You can ask it to find all subscribers in the 'High Value' segment who haven't opened an email in 60 days, or track how well a specific campaign performed last week—all without writing complex API calls. It handles everything from checking account settings to updating individual profile attributes. Because Vinkius hosts this MCP, you connect once using your preferred AI client and get access to these marketing operations right away.

## Tools

### upsert_subscriber
Creates or updates a subscriber's record with necessary identity information, preferences, and custom attributes.

### get_account_details
Retrieves core platform settings and system-level account identifiers for metadata review.

### get_subscriber_profile
Fetches detailed profile data, including custom attributes and device tokens, for a specific subscriber.

### list_automation_messages
Lists all active automated message workflows to check their status and definitions.

### list_marketing_campaigns
Provides a list of marketing campaigns, including their current performance indicators and scheduling data.

### list_contacts
Lists all subscribers in the system, showing key contact properties like emails and channel opt-ins.

### list_audience_segments
Retrieves names and counts for defined contact segments and audience groups.

### list_messages
Lists definitions for both batch and transactional messages, detailing templates and subject lines.

### list_supplementary_data
Retrieves metadata for external data collections used to personalize messaging content.

### search_campaigns_by_name
Searches the platform for marketing campaigns using a specific name or keyword criteria.

## Prompt Examples

**Prompt:** 
```
What were the open rates for 'Summer Sale 2024' versus 'Weekly Newsletter' last month?
```

**Response:** 
```
**Campaign Performance Report**

| Campaign Name | Open Rate | Click-Through Rate |
| :--- | :---: | :---: |
| Summer Sale 2024 | **24.1%** | 3.5% |
| Weekly Newsletter | **18.9%** | 2.1% |

The 'Summer Sale' campaign performed significantly better in both open and click rates this period.
```

**Prompt:** 
```
Pull the full profile details for my top customer, john@example.com.
```

**Response:** 
```
**John Doe Profile Summary**

*   **Subscribed Channels:** Email, SMS
*   **Key Attributes:** First Name: John; Tier: Gold;
*   **Last Updated:** 2024-06-10
*   **Segment Membership:** High Value Customers, Active Shoppers

Need me to update his tier or add a new attribute?
```

**Prompt:** 
```
List the names of all segment groups and how many contacts are in each.
```

**Response:** 
```
**Current Audience Segments**

The platform currently tracks these segments:

*   Active Customers: 45,600 contacts
*   Leads (New): 12,300 contacts
*   High Value Customers: 8,900 contacts
*   Churn Risks: 3,100 contacts
```

## Capabilities

### Update Subscriber Profiles
The agent can create or change a subscriber's information, including their preferences and custom attributes.

### Retrieve Full Profile Details
You can get granular data on any subscriber, pulling details like device tokens and list memberships.

### List Contact Segments
This capability retrieves names and counts for specific audience groups or contact segments within the system.

### Check Campaign Performance
The agent pulls performance data, including metrics for batch and transactional marketing campaigns.

### Manage Automation Workflows
You can list active automated message definitions to audit or monitor ongoing communication workflows.

## Use Cases

### Checking for Data Gaps Before a Launch
A marketing manager needs to ensure the 'VIP' segment is fully populated before a product launch. They ask their agent to list_audience_segments and then use get_subscriber_profile on a test user, confirming all necessary custom attributes are present across the board.

### Investigating Low Campaign Performance
An email marketer sees low open rates. They ask their agent to list_marketing_campaigns and then use search_campaigns_by_name to pull up older campaigns for comparison, helping them pinpoint the trend.

### Updating Segment Rules After a Merger
The CRM specialist needs to update thousands of records. They ask the agent to list_contacts and then use upsert_subscriber multiple times to correct attributes across various contact identities in bulk.

### Understanding Custom Data Sources
An operations analyst needs to know what external data is available for personalization. They prompt their agent using list_supplementary_data, getting a clear map of all usable metadata collections.

## Benefits

- Track real-time campaign results. Instead of manually checking analytics tabs, your agent lists marketing campaigns and their high-level performance indicators instantly.
- Maintain clean contact records. Use the upsert_subscriber tool to ensure all user profiles are up-to-date with current attributes and preferences.
- Audit messaging flows quickly. Monitor active message automation workflows using list_automation_messages, so you always know what's scheduled to send.
- Target specific groups easily. Retrieve contact segments and audience groups via list_audience_segments, making sure your campaigns hit the right people.
- Deep dive into profiles. The get_subscriber_profile tool lets you pull granular data—like device tokens or custom attributes—for detailed segmentation analysis.

## How It Works

The bottom line is your AI client talks directly to Cordial's data layers, so marketing operations happen through conversation, not clicks.

1. Connect the Cordial MCP via Vinkius to your AI client and authorize it using your API key.
2. Reference a specific marketing objective in natural language, like 'Find all subscribers in segment X who need an update'.
3. Your agent executes the necessary steps—querying profiles, checking segments, or listing campaigns—and gives you the actionable results immediately.

## Frequently Asked Questions

**How do I use the Cordial MCP to check if a contact is eligible for a new campaign?**
You can ask your agent to retrieve a subscriber's full profile and attributes. This checks their current segment membership, opt-in status, and any custom flags needed before sending them anything.

**Can the Cordial MCP help me track performance across different message types?**
Yes. It lists marketing campaigns and provides metrics for both batch and transactional messages (like email open rates vs. SMS delivery status), giving you a complete picture of channel effectiveness.

**What if I need to update multiple user records at once?**
You can use the agent to run bulk updates. After listing contacts or segments, you prompt it to upsert_subscriber for specific changes across a defined group of users.

**Does Cordial MCP help manage my automated messaging rules?**
Absolutely. You can list active automated message workflows and check their definitions, allowing you to monitor or audit the logic behind your triggered communications.

**Is this MCP good for finding out what external data I can use for personalization?**
Yes. It lists supplementary data collections, showing exactly which metadata sources are available. This lets you plan how to enrich customer profiles with external information.