Cursor

Cursor is an AI-first code editor. With MailCraft connected, its agent can wire up transactional email in your app and test it against your real account — without leaving the editor.

Prerequisites

Cursor installed
A MailCraft API key with the scopes you want the agent to have — create one under Settings → API keys.

Setup

1
Open the MCP configuration file
Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json in a project root for just that project.
~/.cursor/mcp.json
```
{
  "mcpServers": {
    "mailcraft": {
      "url": "https://mcp.mailcraft.host",
      "headers": {
        "Authorization": "Bearer sk_live_your_api_key"
      }
    }
  }
}
```
Replace sk_live_your_api_key with your key. The agent only gets the tools that key's scopes allow. This file holds your key — keep it out of version control, or use the environment-variable option.
2
Enable the server
Open Cursor Settings → MCP (Tools & Integrations). MailCraft should appear with a green dot; toggle it on if it isn’t.
3
Verify the connection
Open the agent chat and ask:
cursor
```
List all my MailCraft domains
```

Prefer signing in? Leave out "headers" — Cursor will prompt you to log in to MailCraft and choose a workspace.

Example prompts

Once connected, try asking Cursor:

Add a password-reset email to this app using the MailCraft API, then send me a test
Create a template called "Receipt" from the HTML in emails/receipt.html
Register a webhook for email.bounced pointing at our /webhooks/mailcraft route

See every tool the agent can use in the MCP server reference.

Cursor

Prerequisites

Setup

Open the MCP configuration file

Enable the server

Verify the connection

Example prompts