What is Model Context Protocol (MCP)?
Model Context Protocol (MCP) is the open standard created by Anthropic that allows AI models like Claude to interact with external tools and data sources securely. Instead of writing custom JSON schemas and REST handlers for every model, an MCP client connects directly to an MCP server that exposes verified tools.
Traditional email integrations require either brittle REST API wrappers in client code or exposing raw SMTP credentials directly to an LLM. In contrast, SadaSend operates an official, production-grade MCP server that exposes strongly typed email capabilities with server-enforced safety guardrails.
Architecture: local stdio servers vs a hosted HTTP endpoint
SadaSend supports two primary Model Context Protocol transport models to fit local and distributed agent workflows:
| Transport Model | Execution Target | Configuration Mechanism | Best Use Case |
|---|---|---|---|
| Hosted (streamable HTTP) | Hosted endpoint — nothing to install | https://api.sadasend.com/mcp with a Bearer key | Claude Desktop, Cursor, Windsurf, agent servers and serverless workers |
Connecting Claude Desktop to SadaSend in 60 seconds
Open your Claude Desktop configuration file (claude_desktop_config.json):
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the SadaSend MCP server block with your scoped agent key:
{
"mcpServers": {
"sadasend": {
"url": "https://api.sadasend.com/mcp",
"headers": {
"Authorization": "Bearer sada_agent_sk_your_key_here"
}
}
}
}Integrating with Cursor IDE and Windsurf
For AI-powered code editors like Cursor and Windsurf, configure the MCP connection within your project settings or global MCP configuration file (see our full AI agent rules guide):
{
"mcp": {
"servers": {
"sadasend": {
"type": "http",
"url": "https://api.sadasend.com/mcp",
"headers": {
"Authorization": "Bearer ${env:SADASEND_AGENT_KEY}"
}
}
}
}
}Directory of available email tools and schemas
Once connected, the MCP client automatically queries the server tools/list manifest. Claude discovers verified tools with zero manual schema definition:
- send_email: Dispatches an email with subject, markdown or HTML body, and recipient validation against allowlists.
- preview_email: Validates the domain, renders the body and checks recipients without queuing anything. With an approval-mode key, send_email holds the message for a human instead.
- get_email_status: Returns the delivery state and event timeline of a message by ID.
- check_domain_setup: Runs live SPF, DKIM and DMARC lookups for a sending domain, with remediation notes.
- get_stats: Returns sending volume, bounce rate and complaint rate over a time window.
Prompting Claude with email capabilities
Restart Claude Desktop. You can now prompt Claude naturally with operational requests:
*"Check our domain health for mycompany.com, verify SPF and DKIM alignment, and send a summary report to dev@mycompany.com."*
Claude will inspect the domain records with check_domain_setup, format an executive summary, and call send_email through SadaSend with cryptographic signing and allowlist verification.
Built-in safety guardrails: Scoped keys and approval mode
To ensure autonomous agents cannot be steered into unauthorized email distribution via prompt injection, SadaSend enforces two critical safety layers:
1. Recipient Allowlists: Bind the agent key strictly to designated internal domains (e.g. @company.com) so outgoing messages cannot reach external third parties.
2. Human-in-the-Loop Approval: For high-risk operations, configure the key in Approval Mode. When the agent issues a send_email tool call, SadaSend reserves the dispatch and provides an interactive operator review link.
Get started with 6,000 free monthly emails on our developer pricing or review the API documentation.
Frequently Asked Questions
Building AI agents that send email?
Scoped API keys, per-key recipient allowlists, approval mode and a hosted MCP server with twelve tools — 6,000 free sends monthly, without a credit card.
Building SadaSend — transactional email with an MCP server that has a ceiling. Writes about deliverability, email infrastructure, and what happens when you hand an autonomous agent a sending credential.