How to Use the Freshmarketer MCP in Cursor

Q: How do I configure the Freshmarketer MCP Server in Cursor?

Create a .cursor/mcp.json file in your project root and add the Freshmarketer server configuration. Enable Agent mode in your chat sidebar, and the editor will immediately gain access to the marketing tools.

Q: Can Cursor trigger Freshmarketer custom events during debugging?

Yes. You can ask Cursor to run postcustomevent during a debugging session to trigger specific marketing workflows and verify that your backend events are firing correctly.

Q: How do I check which marketing journeys are currently active?

Ask the editor to run listjourneys. It will return a list of all active automation paths, helping you map your backend code events to the correct marketing triggers.

Build and test event-driven Freshmarketer campaigns directly inside Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshmarketer MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate code with live Freshmarketer MCP Server data

Stop coding with blind stubs or outdated mock payloads. This MCP Server lets your Cursor agent run `get_contact_details` to pull real user metadata directly into your active editor window, allowing you to write integrations against live schema. When building custom tracking setups, let Cursor execute `list_custom_events` to see exactly what event keys your marketing team has already configured. You write the tracking code once, knowing it matches your live production environment perfectly.

Debug transactional email triggers inline

Testing transactional email logic usually means running a script and checking your inbox. Instead, ask Cursor to invoke `send_transactional_email` right from the chat sidebar to trigger a test message using your current code context. You can instantly run `check_account_status` to verify that the API accepted the payload and that your account quotas aren't exhausted. It cuts down the feedback loop from minutes to seconds.

Manage subscriber segments from the editor

Keeping your local test databases in sync with your marketing lists is a pain. Use Cursor to execute `list_contacts` and compare your local database entries with your active Freshmarketer database. If you find discrepancies, Cursor can run `upsert_contact` to update the remote records or `create_mailing_list` to group your test accounts. You manage your marketing segments without leaving your coding environment.

Setup guide

Set up Freshmarketer 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 Freshmarketer 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 Freshmarketer transactions." If the MCP tools are loaded correctly, Cursor will call the Freshmarketer tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "freshmarketer-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 Freshmarketer. 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 Freshmarketer 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 Freshmarketer MCP in Cursor

Create a `.cursor/mcp.json` file in your project root and add the Freshmarketer server configuration. Enable Agent mode in your chat sidebar, and the editor will immediately gain access to the marketing tools.

Yes. You can ask Cursor to run `post_custom_event` during a debugging session to trigger specific marketing workflows and verify that your backend events are firing correctly.

Yes. You can pass a list of users to Cursor and ask it to run `upsert_contact` in a loop. The agent will execute the calls sequentially, ensuring your contact database stays updated.

Ask the editor to run `list_journeys`. It will return a list of all active automation paths, helping you map your backend code events to the correct marketing triggers.

All API calls carrying sensitive email bodies and recipient addresses run within an ephemeral V8 sandbox. Your customer communication data is processed in memory and never persisted on Vinkius infrastructure.

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