Cordial MCP. Manage every contact, campaign, and segment in one chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Cordial MCP Server manages your entire marketing workflow. Use it to list, search, and update subscriber profiles, monitor campaign performance (email/SMS), and audit automated messaging streams.
It connects your AI agent directly to the Cordial marketing platform, letting you manage audience segments and campaign metrics through natural conversation.
What your AI agents can do
Get account details
Retrieves metadata about your Cordial account, including plan configuration and core settings.
Get subscriber profile
Gets the full profile and custom attributes for a specific subscriber, including device tokens and list memberships.
List audience segments
Lists contact segments and audience groups, providing their IDs, names, and current subscriber counts.
Get full profile data, including custom attributes and list memberships, or update a subscriber's record using get_subscriber_profile and upsert_subscriber.
Check which segments exist and count contacts in specific groups using list_audience_segments and list_contacts.
Retrieve status and high-level performance indicators for past and current email or SMS campaigns using list_marketing_campaigns.
List and check the status of active automated message workflows and templates using list_automation_messages and list_messages.
Get core account settings, plan details, and external data collection metadata using get_account_details and list_supplementary_data.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Cordial MCP Server: 10 Tools for Marketing Operations
These tools let your agent interact with Cordial to read, write, and audit data across all your marketing channels, from user profiles to full campaign metrics.
019d757cget account details
Retrieves metadata about your Cordial account, including plan configuration and core settings.
019d757cget subscriber profile
Gets the full profile and custom attributes for a specific subscriber, including device tokens and list memberships.
019d757clist audience segments
Lists contact segments and audience groups, providing their IDs, names, and current subscriber counts.
019d757clist automation messages
Lists active automated message workflows, showing their definitions and current operational status.
019d757clist contacts
Lists all subscribers in Cordial, returning essential details like email addresses and channel opt-ins.
019d757clist marketing campaigns
Lists marketing campaigns, providing status, scheduling data, and high-level performance metrics.
019d757clist messages
Lists definitions for batch and transactional messages, including templates and subject lines.
019d757clist supplementary data
Lists external data collections, which are metadata sources for message personalization.
019d757csearch campaigns by name
Searches the platform for marketing campaigns using a specific name or keyword.
019d757cupsert subscriber
Creates a new subscriber profile or updates an existing one with new attributes and channel preferences.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Cordial, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This server lets your AI agent handle everything on the Cordial marketing platform. It lets you manage subscriber data, track campaign performance, and audit automated messaging streams using plain conversation. You don't have to jump between dashboards or write API calls; your agent just does the work.
Manage Subscriber Profiles
You can check a specific subscriber's full profile, including custom attributes and what lists they belong to, with get_subscriber_profile. You can also create a new subscriber or update an existing one's record and channel preferences using upsert_subscriber. You'll also get a list of all subscribers in Cordial, returning essential details like email addresses and channel opt-ins, using list_contacts.
To see what audience groups you've built, check which segments exist and count contacts in specific groups with list_audience_segments. To find out about external data sources that help with personalization, run list_supplementary_data. To get core account settings and plan details, use get_account_details.
Monitor Campaigns and Workflows
Your agent can list all active marketing campaigns, giving you the status, scheduling info, and high-level performance metrics for past and current email or SMS campaigns using list_marketing_campaigns. If you know a campaign name, you can search the platform for it with search_campaigns_by_name. You can list definitions for both batch and transactional messages, including templates and subject lines, using list_messages.
To check what automated message workflows are running, and what their definitions are, run list_automation_messages.
List Core Content
To see all available message definitions, use list_messages. To check which automated workflows are active, use list_automation_messages. To get a list of all subscribers, you can use list_contacts. To check your account's general settings, use get_account_details. To find out about external data sources, use list_supplementary_data.
How Cordial MCP Works
- 1 First, connect your AI client and authorize the Cordial server using your API Key.
- 2 Next, prompt your agent with a marketing objective—for example, 'What's the open rate for the last quarter's campaigns?'
- 3 The agent executes the required tools (e.g.,
list_marketing_campaigns) and returns a synthesized answer with the performance data.
The bottom line is, you manage complex marketing operations by simply talking to your agent.
Who Is Cordial MCP For?
The marketing operations manager who's tired of clicking through five different dashboards to get a single performance metric. The email marketer who needs to quickly validate if a segment is ready for a send. Or the CRM analyst who needs to pull granular profile details for a specific list audit. This is for people who run campaigns, not just people who report on them.
Uses the server to audit automation workflows (list_automation_messages) and verify data integrity by checking segment sizes (list_audience_segments).
Runs checks on campaign status (list_marketing_campaigns) to see real-time open rates and click data before hitting 'send'.
Checks individual subscriber data (get_subscriber_profile) and bulk updates records using upsert_subscriber to ensure clean data for targeting.
What Changes When You Connect
- See segment size and contact lists instantly. Instead of running a report in the UI, prompt your agent to
list_audience_segmentsand immediately know the count of your 'High-Value' group. - Track campaign performance without leaving your chat. Use
list_marketing_campaignsto get open and click rates for recent sends, then decide what to adjust next. - Update user data in bulk. Use
upsert_subscriberto apply a new attribute (like 'Tier: Gold') across thousands of records, bypassing manual UI entry. - Audit automated messaging flows. Check if your welcome series is running correctly by calling
list_automation_messages. You don't have to manually navigate the workflow builder. - Deep dive into contact records. Need to know a user's exact channel opt-ins or custom attributes?
get_subscriber_profilegives you that granular data immediately. - Cross-reference data sources. Use
list_supplementary_datato pull in external context (like 'Industry: Finance') and apply it when running a targeted campaign vialist_contacts.
Real-World Use Cases
Campaign A needs a quick performance check.
The marketing manager needs to know if the 'Q3 Product Launch' campaign hit its open rate target. They ask their agent to run list_marketing_campaigns. The agent retrieves the status and reports the open rate and click rates, allowing the manager to quickly decide if a follow-up message is needed.
Updating a user's status after a purchase.
A customer just upgraded their account, so their segment needs updating. Instead of finding the user in the UI, the agent runs upsert_subscriber, applying the new 'Tier: Platinum' attribute and ensuring the user is moved to the correct high-value segment.
Auditing a broken automated workflow.
The ops team notices a welcome email sequence isn't sending. They ask the agent to list_automation_messages. The server returns a list of active workflows and their status, immediately pointing the team to the message that failed.
Targeting a niche group based on external data.
A campaign needs to target users who are both in the 'Beta Testers' segment AND live in 'Texas'. The agent uses list_supplementary_data to pull the 'State' attribute, then runs list_contacts to get the filtered list, ensuring hyper-accurate targeting.
The Tradeoffs
Treating the server like a search bar
Asking the agent, 'How do I improve my campaign?' and expecting a strategic answer. This tool is for data actions, not consulting.
→
Instead, ask for measurable data. Use list_marketing_campaigns to retrieve the actual open rates. Then, use get_subscriber_profile to find attributes that might help improve the next campaign.
Ignoring data freshness
Assuming that running list_contacts means the data is up-to-the-second truth, especially right after a massive data import.
→
Always check the data source metadata first. Use get_account_details to understand the data refresh cycle, and then use list_supplementary_data to confirm the latest available external records.
Mixing up list and search tools
Trying to find a specific campaign that ran last month by just asking for 'campaigns'. The server needs more detail.
→
Use search_campaigns_by_name if you know part of the title. If you need a full list, use list_marketing_campaigns to see all available campaigns and their dates.
When It Fits, When It Doesn't
Use this server if your job requires managing the full lifecycle of communication: from segment definition to profile update to performance measurement. You need to execute actions—like updating a user's tier or checking a workflow status—and then immediately read the results. Don't use this if your goal is simply to write copy or brainstorm campaign ideas; your agent can't do that. If you only need to read a static list of segments, you could use a simpler API connection. But if you need to read and write (e.g., read segment size, then run upsert_subscriber), this is the right tool.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cordial. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking campaign performance is a nightmare.
Right now, checking a campaign's performance means logging into the Cordial dashboard. You click the campaign, then click the metrics tab, then you have to filter by date range. If you want to know about three campaigns, you're repeating that entire process three times, copying numbers into a spreadsheet to compare.
With the Cordial MCP Server, you just ask your agent, 'What were the open rates for the three campaigns from last month?' It runs `list_marketing_campaigns` and hands you a clean, summarized table right in the chat. You get the answer without the clicks.
Use Cordial MCP Server: Manage contacts, segments & campaigns
You no longer have to manually update records. If a user changes their name or moves to a new tier, you tell the agent, 'Update John Doe's profile and change his Tier to Gold.' The agent runs `upsert_subscriber`, and the record changes instantly. No manual UI form filling required.
This means you control the data flow directly from your agent. Your entire marketing operation runs through a single conversation, making auditing and execution fast and reliable.
Common Questions About Cordial MCP
How do I check segment sizes using the Cordial MCP Server? +
Use the list_audience_segments tool. It provides the segment ID, name, and the current number of subscribers in that group, letting you know the size instantly.
Can I update a user's profile using the Cordial MCP Server? +
Yes, use the upsert_subscriber tool. You provide the user's identifier and the new attributes (like email, first name, or custom data) to create or update their record.
What is the difference between `list_contacts` and `list_audience_segments`? +
list_contacts gives you a list of individual subscribers with their contact details. list_audience_segments gives you the definition and size of a predefined group or segment.
How do I find historical campaign performance data with the Cordial MCP Server? +
Run list_marketing_campaigns. This tool reports on campaign status, scheduling data, and high-level performance indicators like open rates.
How do I use `list_supplementary_data` to see external data tables? +
The list_supplementary_data tool shows the metadata for custom data collections. This lets you see external tables used for personalizing messages without accessing the raw data itself.
Can `get_subscriber_profile` access device tokens and custom attributes? +
Yes, get_subscriber_profile retrieves granular data like custom attributes, device tokens, and list memberships. This gives you a full view of what the subscriber profile holds.
What is the purpose of `get_account_details` in the Cordial MCP Server? +
get_account_details resolves system-level information. You use it to check your Cordial account identifiers, plan configuration, and core platform settings.
How do I manage active workflows using `list_automation_messages`? +
The list_automation_messages tool lists active automated message workflows. You use this to monitor and manage triggered communications and automation definitions.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
GoTo Connect
Manage your cloud phone system — view call records, send SMS, and manage voicemails via AI.
Postmark Extended
Send transactional emails, manage templates, and track delivery status directly through Postmark's high-deliverability infrastructure.
Ably
Manage real-time messaging, presence, and push notifications via Ably — publish messages, track users, and monitor channels from your AI agent.
You might also like
Giphy
Search, browse, and integrate the world largest library of animated GIFs and stickers into your apps and conversations.
FreeAgent
Manage accounting, track invoices, and oversee bank transactions via AI agents with FreeAgent.
ReciPal
Manage food recipes — audit ingredients and nutrition via AI.