How to Use the Emma MCP in Cursor

Q: Can I use Emma tools to test API integrations in Cursor?

Yes, you can. Cursor uses tools like listmembers and listautomations to fetch live data, letting you test your application's logic against your actual marketing setup.

Q: Can I see which automated workflows are active from the editor?

Yes, you can ask the agent to list them. It will run listautomations to output all your active nurture flows right into the chat sidebar.

Build email-driven code and manage Emma campaigns directly inside Cursor's Agent mode.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Emma MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate code using live Emma mailing stats in Cursor

Stop writing code against mock marketing data. When you pair Cursor with this MCP Server, the editor's Agent mode can query your live account to write functional code. It uses `get_mailing_stats` and `list_mailings` to retrieve actual campaign performance figures and inject them directly into your active files. If you are building a custom dashboard, Cursor can write the frontend components using real JSON payloads from your Emma campaigns. You don't have to guess the API response structure because the editor pulls it live.

Automate subscriber group management in Cursor

Managing contact segments during development is usually a chore. With this setup, Cursor can use `list_groups` to inspect your current list structure and run `create_group` to spin up test segments. If your code needs to clean up old test segments, the agent can invoke `delete_group` to keep your mailing database tidy. This lets you test list-management logic without switching to a browser.

Verify member fields and webhooks while writing code

Integrating webhooks requires knowing exactly what data fields are available. Cursor can call `list_fields` to check your custom database schema and `list_webhooks` to verify where your event data is going. It can also run `get_member` to look up specific test accounts, ensuring your code handles subscriber statuses correctly. This turns your editor into a live testing ground for your email workflows.

Setup guide

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

.cursor/mcp.json

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

Add the server configuration to your global or project-specific `mcp.json` file in Cursor. Once added, enable Agent mode in the chat panel to let the editor invoke the tools.

Yes, you can. Cursor uses tools like `list_members` and `list_automations` to fetch live data, letting you test your application's logic against your actual marketing setup.

Yes, because the editor needs to make live API calls to retrieve your mailing data and group structures. Cursor routes these requests through the secure Vinkius MCP gateway.

Yes, you can ask the agent to list them. It will run `list_automations` to output all your active nurture flows right into the chat sidebar.

Yes, your API keys and subscriber emails are protected. Cursor communicates with the Vinkius sandbox using strict local environment variables, ensuring member fields and contact details are never cached or leaked during code generation.

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