Email tools for Cascade
Give Windsurf's Cascade agent 26 email tools. Send verification emails in Write mode. Debug deliverability in Chat mode. Run entire email flows in Turbo mode.
Quick install
Email integration interrupts autonomous coding
Cascade handles multi-file edits and shell commands autonomously. Then email integration requires manual API setup, breaking the self-driving experience you chose Windsurf for.
- ×Cascade loses context when you switch to email documentation
- ×Email APIs require manual configuration Cascade can't automate
- ×No native email MCP means no Turbo mode for email features
- ×Email becomes the one task you still do manually
Two MCP servers for Cascade
Ark gives Cascade two MCP servers. The Docs MCP searches documentation in real-time (free, no API key). The Email MCP sends emails and manages infrastructure. Both work in Write, Chat, and Turbo modes.
Add to ~/.codeium/windsurf/mcp_config.json
Enable MCP in Settings → Advanced → Cascade, then add both Ark servers.
Enable MCP in Windsurf
Cmd/Ctrl + Shift + P → Settings → Advanced → Cascade → Enable MCP.
# MCP config location: ~/.codeium/windsurf/mcp_config.jsonAdd Docs MCP (free, no API key)
Cascade can now search Ark documentation in real-time for accurate code generation.
{
"mcpServers": {
"ark-docs": {
"url": "https://arkhq.io/docs/mcp"
}
}
}Add Email MCP (requires API key)
Get your API key from arkhq.io ($5 credit included), then add the email server.
{
"mcpServers": {
"ark-docs": {
"url": "https://arkhq.io/docs/mcp"
},
"ark-email": {
"command": "npx",
"args": ["-y", "ark-email-mcp"],
"env": {
"ARK_API_KEY": "ark_live_xxxxxx"
}
}
}
}Code examples
Copy and paste to get started quickly.
import { Ark } from "ark-email";
const ark = new Ark({ apiKey: process.env.ARK_API_KEY });
// Cascade generates clean code because Ark responses are predictable
await ark.emails.send({
from: "[email protected]",
to: "[email protected]",
subject: "Confirm your account",
html: `
<h1>Welcome!</h1>
<p>Click to confirm: <a href="https://app.com/confirm?t=abc">Confirm</a></p>
`,
});from ark import Ark
import os
ark = Ark(api_key=os.environ["ARK_API_KEY"])
# Predictable API that Cascade generates correctly
ark.emails.send(
from_="[email protected]",
to="[email protected]",
subject="Your order shipped",
html="<p>Track your order: <a href='https://track.example.com'>Click here</a></p>",
)What you can build
"Build email verification" (Write mode)
Cascade implements the full flow: generates token, sends email via MCP, creates verification endpoint. Multi-file edit with real email integration.
"Why aren't emails delivering?" (Chat mode)
Cascade uses MCP tools to check delivery status, review bounce reasons, and inspect your domain configuration without modifying code.
"Implement all auth emails" (Turbo mode)
Cascade autonomously builds signup confirmation, password reset, and email change flows. Executes on disk, visible in dev server before you approve.
"Set up my sending domain" (Write mode)
Cascade checks current DNS, tells you what records to add, then verifies the domain is configured correctly.
Why developers choose Ark
Docs MCP: Real-time documentation
Cascade searches Ark's docs instantly. No outdated training data, no hallucinated APIs. Free, no API key required.
Email MCP: 26 operations
Send, batch, retry, check delivery, manage domains. Cascade operates your email infrastructure in any mode.
Works with Turbo mode
Run fully autonomous email tasks. Cascade builds, tests, and iterates on email features without asking permission at each step.
Enterprise MCP controls
Whitelist Ark in your team config. SOC 2 Type II compliant for regulated environments.
What you get with Ark
Frequently asked questions
What's the difference between Docs MCP and Email MCP?
Docs MCP searches Ark's documentation in real-time—it's free and helps Cascade generate correct email code. Email MCP actually sends emails and manages infrastructure—it requires an API key. Use both together: Docs for learning, Email for doing.
How does this work with Cascade's different modes?
Both MCPs work in all modes. Docs MCP helps Cascade understand the API in Chat mode. Email MCP sends emails in Write mode. In Turbo mode, Cascade uses both to autonomously research, implement, and test email features.
Does Ark work with Windsurf's auto-context?
Yes. Cascade indexes your Ark configuration and email code automatically. It finds relevant context without you needing to manually tag files with @.
Can I use this with my enterprise Windsurf plan?
Yes. Add Ark to your team's MCP whitelist. Once whitelisted, all team members can use Ark's email tools. Works with Windsurf's SOC 2, zero-day retention, and on-prem deployments.
What does this cost?
Docs MCP is completely free. Email MCP costs $0.50 per 1,000 emails—no monthly fees. You get $2.50 credit (5,000 emails) when you sign up. This is separate from your Windsurf subscription.
Add email to Cascade
2-minute setup. Works with Write, Chat, and Turbo modes. $2.50 welcome credit.