Build / Windsurf + AgenticEmail
Give Windsurf its own inbox
Register AgenticEmail's MCP server in Windsurf and the Cascade agent can run full email threads on its own, from an address it controls.
Install
Connect the inbox
Windsurf's Cascade agent reads MCP servers from its config file. Add AgenticEmail and it can send and receive on its own.
{
"mcpServers": {
"agenticemail": {
"url": "https://api.agenticemail.dev/mcp",
"headers": {
"Authorization": "Bearer ${AGENTICEMAIL_API_KEY}"
}
}
}
}export AGENTICEMAIL_API_KEY="am_your_unscoped_key"The MCP server works with any MCP client and needs an unscoped API key. See the MCP docs for the exact config path for your setup.
Why email
Why Windsurf needs its own inbox
Acts without you in the loop
Your agent can start outreach, reply to incoming mail, and run threads to completion on its own. You review the result, not every keystroke.
A dedicated agent identity
The agent gets its own inbox and address. No shared credentials, no routing through your personal account, no scope creep into your real mail.
A full audit trail
Every message it sends or receives is stored with its thread. Scoped API keys mean you can revoke one agent without touching the others.
Code
Working code
Prefer to script it directly? The same inbox is one SDK or CLI call away.
from agenticemail import AgenticEmail
client = AgenticEmail(api_key="am_your_key")
inbox = client.inboxes.create(username="support-agent")
print(inbox["id"])
client.messages.send(
inbox["id"],
to=["customer@example.com"],
subject="Hello from your agent",
text="Sent by an AI agent via AgenticEmail.",
)
replies = client.messages.list(inbox["id"])
for msg in replies["data"]:
print(msg["from"], msg["subject"])Prompt it directly
- "Spin up an inbox for onboarding and email the new user their setup steps."
- "Triage the support inbox: label each thread and draft a first reply."
- "Chase the vendor thread if there has been no response since Monday."
FAQ
Common questions
- How does Windsurf connect to AgenticEmail?
- Through AgenticEmail's hosted MCP server at https://api.agenticemail.dev/mcp. You register it once with your API key, and Windsurf can call every inbox and message operation as native tools - no SMTP, no email provider, no glue code.
- Do I need to configure SMTP or an email provider?
- No. AgenticEmail is the provider. Inboxes are real addresses that send and receive; MCP exposes create_inbox, send_message, list_messages, reply_to_message and more directly to the agent.
- Can Windsurf receive email, not just send it?
- Yes. The agent can list threads and messages, read full history, and reply in the same thread. Inbound mail arrives parsed and is available through the same tools.
- Why does the MCP server need an unscoped key?
- The MCP server exposes inbox creation and cross-inbox operations, so it requires a key that is not locked to a single inbox. Create one at app.agenticemail.dev/keys.
- Is there a free tier?
- Yes. You can create inboxes and start sending on the free tier with no credit card. See the pricing page for limits.
