How to Use the Minutemailer MCP in Windsurf

Q: How do I connect the Minutemailer MCP Server to Windsurf?

Add the server configuration to your mcpconfig.json file under the mcpServers key. Once you hit refresh in the Cascade panel, the agent immediately discovers all eight tools and can start querying your lists.

Q: Can I view my Minutemailer templates inside the Windsurf interface?

You can. Cascade runs listtemplates to fetch your active layouts, allowing you to review your email designs directly within your active workspace context.

Let Windsurf's Cascade autonomously sync your marketing lists and clean contacts in Minutemailer without manual copying.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Minutemailer MCP to Windsurf

Create your Vinkius account to connect Minutemailer to Windsurf 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 Minutemailer with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously group your Minutemailer lists

The `list_contact_lists` tool pulls your active subscription directories directly into your IDE workspace using this MCP Server integration. Cascade reads this structure, maps it to your local database, and figures out which segments need updates. You don't have to prompt the agent for every single list. It queries `list_smart_lists` on its own, matches the criteria against your local leads, and updates your marketing groups in one clean run.

Clean subscriber files directly from Windsurf

The `create_contact` tool registers new subscribers directly into your campaigns when Cascade detects fresh sign-ups in your local files. If a user unsubscribes or bounces, the agent runs `delete_contact` to keep your lists clean. Cascade tracks this entire loop without waiting for your permission at every step. It checks the existing database using `list_contacts`, spots the discrepancies, and executes the necessary additions or removals instantly.

Run Windsurf commands to audit email campaigns

The `list_events` tool lets your agent pull real-time activity logs from your marketing campaigns straight into your editor. You can cross-reference email opens or click events against your active code branches to see what drives conversions. Cascade links these events with your templates by calling `list_templates` to see which layouts perform best. This MCP connection gives you a clear picture of your campaign health without leaving your editing environment or opening a browser.

Setup guide

Set up Minutemailer MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Minutemailer MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Minutemailer payment history." If connected, Cascade will call the Minutemailer tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "minutemailer-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 Minutemailer. 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 Minutemailer 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 Minutemailer MCP in Windsurf

Add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Once you hit refresh in the Cascade panel, the agent immediately discovers all eight tools and can start querying your lists.

Yes, if you use Cascade in autonomous mode. It will check your local data, query `list_contacts`, and use `create_contact` to sync new subscribers without requiring step-by-step confirmation.

You can. Cascade runs `list_templates` to fetch your active layouts, allowing you to review your email designs directly within your active workspace context.

Cascade reads the error response from the API immediately. It will log the failure, check your account status using `get_account_info`, and retry or alert you if you hit rate limits.

Your contact records and template designs never touch external storage. The MCP environment processes all operations in an ephemeral, zero-trust environment, passing your API token securely to complete the requests.

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