How to Use the Cordial MCP in Claude

Q: How do I connect the Cordial MCP Server to Claude Desktop?

Open your claudedesktopconfig.json file and add the Cordial server configuration block under the mcpServers key. Once you save and restart Claude Desktop, you will see a hammer icon indicating the messaging tools are ready. This links the MCP server to your local client.

Q: Can Claude Desktop run Cordial campaign searches?

Yes, Claude Desktop uses the searchcampaignsbyname tool to find matches instantly. Just ask the desktop client to find a specific campaign and it handles the API request.

Q: How does Claude Desktop handle Cordial segment counts?

It queries the listaudiencesegments tool to fetch current subscriber counts and segment names. Claude Desktop then displays these audience sizes directly in your chat window.

Q: Can I view transactional message templates here?

Yes, you can view them. The listmessages tool pulls back definitions for both batch and transactional templates so you can check subject lines in chat.

Get Cordial marketing data and subscriber profiles directly inside Claude Desktop to run campaigns without leaving your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cordial MCP to Claude Desktop

Create your Vinkius account to connect Cordial to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cordial with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inspect Cordial subscriber profiles from Claude Desktop

The `get_subscriber_profile` tool lets Claude Desktop pull full contact files, list memberships, and device tokens right into your chat window. You do not have to open the Cordial browser tab to find out why a specific customer did not get your last push notification. Ask Claude Desktop to inspect a user's channel preferences or custom attributes, and it will run `list_contacts` behind the scenes to verify their status. It makes debugging delivery issues incredibly fast because the raw JSON data feeds straight into your active Claude Desktop conversation.

Manage automated workflows using this MCP Server

The `list_automation_messages` tool exposes your active triggered message definitions directly to your Claude Desktop workspace. You can quickly audit which transactional emails are live in Cordial and verify their configuration without clicking through menus. When you need to check if a specific campaign is active, Claude Desktop runs `list_marketing_campaigns` to grab performance metrics on the fly. This turns your desktop chat client into a command center for your entire Cordial setup.

Update contact lists and custom tables on the fly

The `upsert_subscriber` tool lets Claude Desktop modify contact records and channel choices directly from your text prompts. If you need to opt a user out or update a custom attribute, just tell Claude Desktop to do it. Claude Desktop uses `list_supplementary_data` to read external data tables used for your message personalization. This MCP tool gives your desktop client direct access to the relational tables that power your dynamic email layouts.

Setup guide

Set up Cordial MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Cordial MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Cordial MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under cordial-mcp.

json

{
  "mcpServers": {
    "cordial-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Cordial now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Cordial MCP in Claude Desktop

Open your claude_desktop_config.json file and add the Cordial server configuration block under the mcpServers key. Once you save and restart Claude Desktop, you will see a hammer icon indicating the messaging tools are ready. This links the MCP server to your local client.

Yes, Claude Desktop uses the `search_campaigns_by_name` tool to find matches instantly. Just ask the desktop client to find a specific campaign and it handles the API request.

It queries the `list_audience_segments` tool to fetch current subscriber counts and segment names. Claude Desktop then displays these audience sizes directly in your chat window.

Yes, you can view them. The `list_messages` tool pulls back definitions for both batch and transactional templates so you can check subject lines in chat.

Your contact emails and custom attributes are protected because Vinkius runs this server in an isolated, zero-trust sandbox. No subscriber data is ever stored on Vinkius servers or used to train public models.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript