# Cordial MCP for AI Agents AI Agent Connect > Cordial lets you manage your marketing audience and campaigns directly from your AI client. You can update subscriber profiles, monitor real-time email and SMS performance, and audit automated workflows without leaving your chat window. It bridges the gap between your marketing data and your daily tasks. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_C5BMomeZExletUBhCDWVjDRb4SfO54otDcK3WJ7o/ai-agent-connect - **Tags:** cross-channel-marketing, subscriber-data, campaign-analytics, automated-messaging, personalization, audience-targeting ## Description Imagine you're halfway through a campaign launch and need to check why a specific segment isn't hitting its targets. Instead of switching tabs, logging into a dashboard, and digging through nested menus, you just ask your agent. This Connector connects your AI client to the Cordial marketing platform, letting you pull real-time stats or update hundreds of subscriber attributes in seconds. You can see how your batch emails are performing, check the status of your automated message workflows, or find specific customers based on custom data points. It's about moving from looking for data to making decisions. Because Vinkius hosts this Connector, it's easy to plug into your existing workflow and let your agent handle the heavy lifting of marketing ops. You get a direct line to your audience data without the friction of manual entry or constant tab switching. By integrating this directly into your workflow, you can handle audience segmentation, campaign tracking, and subscriber updates with a few prompts. It turns your AI into a marketing operations specialist that knows your data as well as you do. You can audit your automation rules, pull supplementary data tables for better personalization, and keep your subscriber lists clean without ever having to copy and paste between different browser windows. ## Tools ### get_account_details Get your core platform settings and plan configuration. This helps your agent understand your account's specific setup. ### list_contacts List all subscribers within your Cordial system. This is the quickest way to see your total reach. ### list_marketing_campaigns View your marketing campaigns along with their high-level performance metrics. You can quickly check how your recent blasts performed. ### list_audience_segments See your various contact segments and audience group sizes. Use this to verify your target audience before a launch. ### list_messages View definitions for batch and transactional messages, including subject lines. This is great for reviewing your content strategy. ### list_supplementary_data Access your custom data collections used for personalization. This lets your agent pull in extra data points for better targeting. ### search_campaigns_by_name Find specific marketing campaigns using a name search. This saves time when you have a large volume of past campaigns. ### upsert_subscriber Create or update a subscriber profile with custom attributes and channel preferences. This is useful for keeping your audience data current without manual entry. ### get_subscriber_profile Pull full profile data, including device tokens and list memberships. Use this to see the complete history and status of a single subscriber. ### list_automation_messages See all active automated message definitions and their current workflow status. This helps you audit your triggered communications. ## Prompt Examples **Prompt:** ``` What's the status of our current email campaigns? ``` **Response:** ``` I've pulled the latest data for your active campaigns. Here's a summary: | Campaign Name | Open Rate | Status | | --- | --- | --- | | Summer Sale 2024 | 24% | Active | | Weekly Newsletter | 18% | Completed | Would you like to see the click-through rates for these? ``` **Prompt:** ``` Find the profile for user@example.com. ``` **Response:** ``` I found the profile for user@example.com. Here are the details: * **Subscribed to:** Email, SMS * **Attributes:** First Name: John, Tier: Gold Would you like me to update any of these details? ``` **Prompt:** ``` How many people are in our 'Active Customers' list? ``` **Response:** ``` The 'Active Customers' segment currently contains 45,600 contacts. It grew by 150 contacts in the last 24 hours. Would you like a breakdown by geographic region? ``` ## Capabilities ### Update subscriber profiles Update identity properties, channel preferences, and custom attributes for your audience. ### Monitor campaign performance Get real-time open rates and click data for your active email and SMS campaigns. ### Audit automation workflows View the status and definitions of your triggered message automations. ### Search audience segments Find specific contact groups and see subscriber counts instantly. ### Access supplementary data Pull custom data collections to help with deeper message personalization. ## Use Cases ### Updating subscriber preferences A subscriber wants to opt out of SMS but keep email. Ask the agent to use `get_subscriber_profile` to check their status and then `upsert_subscriber` to update their preferences. ### Analyzing campaign performance Need to know why a campaign is underperforming. Use `list_marketing_campaigns` to compare open rates across different dates and see if the segment size is correct. ### Auditing automation triggers Checking if an automation is actually running. Use `list_automation_messages` to verify the workflow status and ensure the trigger is active. ### Verifying audience size Need to see how many people are in a specific group. Use `list_audience_segments` to get the exact subscriber count for the 'Active Customers' group instantly. ### Retrieving historical campaign data Need to find a specific campaign from last year. Use `search_campaigns_by_name` to pull up the exact historical data you need without scrolling through dozens of entries. ## Benefits - Stop manual data entry by using `upsert_subscriber` to update profiles automatically across your entire audience. - Get instant campaign stats using `list_marketing_campaigns` to see real-time performance for every active blast. - Audit your entire messaging strategy with `list_automation_messages` to find and fix broken triggered workflows. - Quickly find specific customer groups using `list_audience_segments` and `search_campaigns_by_name` to verify your targets. - Personalize your outreach more accurately by pulling extra data tables with `list_supplementary_data` for better messaging. ## How It Works The bottom line is you can manage your entire marketing stack through a simple conversation. 1. Connect the Cordial MCP to your AI client and provide your API Key. 2. Ask your agent to perform a specific marketing task, like listing active campaigns. 3. Receive real-time data or confirmation of changes across your marketing platform. ## Frequently Asked Questions **Can I use Cordial MCP to update my subscribers?** Yes, you can use it to update profile attributes and channel preferences for your subscribers directly through your AI client. **Does Cordial MCP show me campaign performance?** It allows your agent to pull high-level performance indicators like open rates and status for your marketing campaigns. **Can I check my automated workflows with Cordial?** Yes, you can use the Connector to list active automated message definitions and check their current workflow status. **How do I get extra data for personalization?** You can use the Connector to access supplementary data collections that you use for personalizing your messages. **Can I find specific campaigns by name?** Yes, your agent can search for specific marketing campaigns using name criteria to help you find what you need faster. **Does Cordial MCP work with my existing marketing data?** It connects to your existing Cordial account to pull subscriber data, segments, and campaign info. **How do I get a Cordial API Key?** Log in to your Cordial account, go to **Settings > API Keys**, and create a new key. Ensure you have the necessary permissions to manage contacts and messages. **Can the agent trigger batch campaigns?** This integration currently focuses on listing and monitoring campaigns. To trigger sends, you should use the Cordial dashboard or specific automation workflows. **What profile attributes can the agent update?** The agent can update any custom attributes defined in your Cordial schema, as well as channel subscription preferences, as long as the API Key has write access.