How to Use the Cordial MCP in Cursor

Q: Can Cursor modify Cordial contact records?

Yes, Cursor uses the upsertsubscriber tool to create or update contact attributes. You can ask the editor to execute these updates during your coding sessions.

Q: How does Cursor read Cordial relational tables?

It calls the listsupplementarydata tool to fetch metadata for your custom collections. This lets Cursor understand your relational database schema inside the editor.

Q: Can I check my account limits in the editor?

Yes, the getaccountdetails tool retrieves your current system-level settings and plan configuration. You can query this anytime to check your account parameters.

Write marketing code and update Cordial subscriber records directly inside Cursor using real-time API tools.

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 Cursor

Create your Vinkius account to connect Cordial to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build subscriber sync scripts in Cursor

The `upsert_subscriber` tool lets Cursor modify subscriber profiles and channel preferences while you write your integration code. You can test your profile-update logic using real API payloads directly in the editor chat. By calling `get_subscriber_profile` within Cursor, you can instantly see the exact JSON structure of a contact's custom attributes. This saves you from having to guess the schema when writing data-mapping scripts.

Query Cordial campaign data with this MCP Server

The `list_marketing_campaigns` tool lets Cursor pull real campaign performance metrics and schedules into your coding workspace. You can use this live data to write and test custom reporting scripts without hardcoding dummy values. If you need to find a specific ID, Cursor runs `search_campaigns_by_name` to locate the target campaign. This keeps your development flow fast because you never have to leave the editor to search the marketing platform.

Inspect audience segments during local development

The `list_audience_segments` tool gives Cursor direct access to your contact lists and subscriber counts. You can write audience-targeting code while viewing the exact segment names that exist in your production account. Cursor uses `list_contacts` to retrieve raw contact metadata and opt-in histories. This MCP capability keeps your development flow fast by bringing live compliance data directly into your coding environment.

Setup guide

Set up Cordial MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Cordial MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Cordial transactions." If the MCP tools are loaded correctly, Cursor will call the Cordial tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/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 Cursor

Add the server entry to your global or project-specific mcp.json file. Once added, Cursor can call the MCP tools whenever you use Agent mode.

Yes, Cursor uses the `upsert_subscriber` tool to create or update contact attributes. You can ask the editor to execute these updates during your coding sessions.

It calls the `list_supplementary_data` tool to fetch metadata for your custom collections. This lets Cursor understand your relational database schema inside the editor.

Yes, the `get_account_details` tool retrieves your current system-level settings and plan configuration. You can query this anytime to check your account parameters.

All API requests flow through an ephemeral, single-token Vinkius sandbox that never logs your audience lists or campaign metrics. Your marketing data remains strictly inside your local editor session.

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