Overview

The MCP (Model Context Protocol) Interface allows you to integrate Cordial’s marketing automation capabilities directly into your favorite AI-powered tools and workflows. By supporting the open standard developed by Anthropic, the MCP Interface makes it possible for AI assistants (like Claude Desktop) to securely interact with your Cordial data and provide real-time insights. 

Use Cases

Imagine asking your AI assistant: "How many customers in our loyalty program haven't made a purchase in the last 30 days?" With Cordial's MCP Interface, your AI can instantly query the audience count and provide actionable insights.

Building a new email template? Your AI assistant can now access sample customer data with real attributes, ensuring your dynamic content renders correctly across different customer segments. No more guessing about data structures or switching between documentation and code.

Read Access to Critical Marketing Data

Our initial MCP release focuses on providing read access to essential marketing data and operations, giving you instant context when working with AI assistants:

Customer Intelligence

• Sample Customer Data: Quickly pull real customer profiles to build and test email creative with authentic data
• Customer Information Retrieval: Access detailed customer attributes and behavioral data by email address
• Account Overview: Get comprehensive account information including customer attributes, product catalogs, and supplemental data

Email Campaign Insights

• Batch Email Analytics: Retrieve templates, subject lines, and performance metrics for emails within specific date ranges
• Campaign Performance Data: Access detailed metrics for both sent campaigns and those in development
• Template Management: Pull existing email templates for analysis and optimization

Audience Management

• Audience Counting: Get real-time counts of customers matching specific criteria
• Audience Creation: Build new audiences programmatically based on custom criteria
• Segmentation Analysis: Understand audience composition and size before campaign deployment

Getting Started is Simple

Unlike traditional integrations, Cordial's MCP Interface is deployed as a remote server—there's nothing to install or configure on your end. Simply connect your MCP-compatible client (like Claude Desktop or any tool supporting the MCP standard) to our server, and you're ready to go.

Quick Start Guide:

1. Log in to your Cordial account and navigate to the API Keys page under the Settings menu.
2. On the API Keys page, click New and create a new API key and name. Make sure to permission/select all GET method API endpoints.
3. Download and install a MCP-compatible client application, like Claude Desktop.
4. Add Cordial's MCP server to your client configuration by navigating to Developer/Model Context Protocol (MCP) settings.

5. To connect your MCP client, you’ll need to provide the following configuration details (these may vary depending on your environment)

   {
     "mcpServers": {
       "mcpservername": {
         "command": "npx",
         "args": ["cordialmcp"],
         "env": {
           "API_URL": "https://api.cordial.io",
           "API_KEY": "API_KEY_GOES_HERE"
         }
       }
     }
   }

   • "mcpservername" should be short, recommend "cordialmcp"
   • If your solution is hosted on USW2 or USE1, then the API_URL would be "https://api.usw2.cordial.io" or "https://api.use1.cordial.io". Otherwise, if your solution is hosted on USW1 you can keep the default "https://api.cordial.io". 
   • Make sure to replace API_KEY_GOES_HERE with the API key you created in the Cordial account settings.
6. Once Developer Mode is enabled, you can securely  access options like filesystem MCP to allow the application to interact with certain folders on your system.

Security and Compliance

The Cordial MCP Interface follows the same enterprise-grade standards as Cordial’s platform: encrypted end-to-end connections, authentication required for all operations, user roles and permissions respecting existing Cordial settings and full audit trails for every action.