How to Use the Mailtrap MCP in Windsurf

Q: Can Windsurf read the actual HTML of my Mailtrap test emails?

Yes. Cascade uses the getmessagehtml tool to pull the raw markup of any captured message. This lets the agent analyze rendering issues or broken CSS without you opening a browser.

Build and debug email workflows autonomously with Mailtrap and Windsurf. Cascade chains API calls to test rendering directly in the IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailtrap MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Sandbox Testing with Windsurf Cascade

You need to know if that new transactional template actually renders correctly. Instead of writing boilerplate to check the inbox, you tell Windsurf's Cascade agent to verify the flow. It uses `list_sandboxes` to find your virtual inbox and triggers a test run. Cascade doesn't stop there. Once the test fires, it pulls the result using `list_sandbox_messages` and inspects the markup with `get_message_html`. If the CSS is broken, the agent spots the failure and can instantly suggest fixes to your local files.

Manage Mailtrap Projects and Domains

Switching tabs to check domain verification status kills momentum. Your agent handles that directly from the editor via this MCP Server. It runs `list_mailtrap_projects` to map out your workspaces and grabs your active environments. When you set up a new sender, you just ask Windsurf to confirm the DNS records. It fires `list_verified_domains` and `get_domain_status` to pull the exact configuration state. You get immediate feedback right next to your code.

Safely Bridge Test and Production Mail

Testing email delivery shouldn't risk spamming real users. This MCP Server gives your IDE strict boundaries between staging and live environments. You build the logic using `send_test_email` to trap every outgoing message safely in the sandbox. Once the QA checks pass, you switch contexts. The agent can validate the final production payload and execute a real send using `send_production_email`. If you need to wipe the slate clean for the next test suite, `clear_sandbox_inbox` resets everything instantly.

Setup guide

Set up Mailtrap 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 Mailtrap 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 Mailtrap payment history." If connected, Cascade will call the Mailtrap tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Open your IDE settings and navigate to the Cascade MCP Servers UI. You can also edit `~/.codeium/windsurf/mcp_config.json` directly. Add the server under the `mcpServers` object and hit refresh.

Yes. Cascade uses the `get_message_html` tool to pull the raw markup of any captured message. This lets the agent analyze rendering issues or broken CSS without you opening a browser.

The agent maps your account structure automatically. It calls `list_accessible_accounts` followed by `list_sandboxes` to find the correct inbox ID for your current project.

You can wipe individual messages or the entire inbox. The agent uses `delete_sandbox_message` for specific cleanups or `clear_sandbox_inbox` to reset the environment before a new test run.

Your agent only accesses the specific message bodies, metadata, and domain statuses exposed by the API. The client processes this data locally in memory to analyze HTML rendering or verify delivery, and the server retains no persistent logs of your test payloads.

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